宝可梦竞技场

Cobblemon竞技场PvP 为你的Cobblemon服务器添加结构化的竞技PvP功能,包括排位匹配、锦标赛以及完整的Discord 集成。

冒险

Cobblemon Arena PvP

面向 Cobblemon 服务器的竞技 PvP 系统。在竞技场中对战,体验排位匹配、攀登排行榜并参加自动化锦标赛——全部与 Discord 集成。


入门 — 免费许可证

本模组需要许可证密钥才能激活。许可证完全免费,可无限期使用——无需付费,永不过期。

我们使用许可证系统仅仅是为了在此测试阶段跟踪缺陷并监控模组在不同服务器上的运行表现。

如何获取许可证:

  1. 加入我们的 Discord 服务器
  2. 前往 #request-help-license 频道
  3. 申请你的免费许可证密钥
  4. 将密钥添加到配置文件的 license_key 项下

就这样——你已准备就绪!


工作原理

玩家可以互相发起挑战,或加入匹配队列。模组会将双方玩家传送到随机竞技场,开始一场 Cobblemon 对战并记录结果。对战结束后,玩家返回原位置,排名自动更新。


排位系统

  • 基于 ELO 的匹配,段位包括:青铜、白银、黄金、白金、钻石、大师
  • 首次定级前需进行定级赛
  • 段位间可晋升与降级
  • 普通队列与排位队列相互独立
  • 显示队列状态的 Boss 栏

锦标赛

  • 每周通过 Discord 进行锦标赛投票(日期、时间、禁用宝可梦)
  • 通过 Discord 按钮报名——无需在游戏内
  • 动态名额:初始 10 个,最多可扩展至 20 个
  • 自动生成单淘汰赛对阵表,按 ELO 种子排序
  • 1-5 场同时进行的对战,缺席自动判负(W.O.)
  • 每轮更新的 Discord 实时嵌入消息
  • 网站上自动发放奖品与冠军奖杯

Discord 集成

  • 内嵌 Discord 机器人——无需外部设置
  • 排行榜与玩家统计命令
  • 每场对战结果的丰富嵌入消息
  • 锦标赛报名、对阵表公布与实时更新
  • 账号绑定后自动分配身份组
  • 使用斜杠命令 /linkar 绑定 Minecraft 与 Discord 账号

Boss 突袭

  • 通过管理员命令手动发起 Boss 突袭,或按计时器自动生成
  • 可选的 RaidDens 模组集成(零强制依赖)
  • 基于伤害的经验奖励与排名
  • Discord 通知:生成、击败与过期

网站集成

  • 以 Pokemon Showdown 格式捕获对战回放
  • 通过 HTTP API 同步排行榜、对战历史与回放
  • 锦标赛结束后向网站发送冠军奖杯

玩家命令

命令 描述
/challenge <player> 向玩家发起决斗挑战
/challenge accept 接受待处理的挑战
/challenge decline 拒绝待处理的挑战
/normal 加入普通(休闲)队列
/ranked 加入排位队列(需要 10 只宝可梦)
/leave 离开任何队列
/matchaccept 接受排位对战
/matchdecline 拒绝排位对战
/arena spec [arena] 观战进行中的决斗
/bossraid join 加入进行中的 Boss 突袭
/carena banlist 查看锦标赛禁用宝可梦
/carena link 生成绑定 Discord 账号的代码
/carena link status 查看 Discord 绑定状态
/carena unlink 解除 Discord 账号绑定

管理员命令

所有管理员命令均需要 carena.admin 权限。

命令 描述
/carena admin arenaset <name> 在当前位置创建竞技场
/carena admin arenasetspec <arena> 设置竞技场的观战点
/carena admin arenalist 列出所有竞技场及其状态
/carena admin arenadelete <name> 删除竞技场
/carena admin bossraid start <pokemon> <level> 生成 Boss 突袭
/carena admin bossraid stop 停止进行中的 Boss 突袭
/carena admin bossraid status 显示 Boss 突袭详情
/carena admin sync 强制将排名数据同步到 Web API
/carena admin banlist add <pokemon> 将宝可梦加入锦标赛禁用列表
/carena admin banlist remove <pokemon> 将宝可梦从锦标赛禁用列表移除
/carena admin prize set 将管理员物品栏捕获为锦标赛奖品
/carena admin tournament status 显示锦标赛状态
/carena admin tournament cancel 取消进行中的锦标赛
/carena admin tournament force 强制发布投票(测试用)

Discord 机器人命令

命令 描述
/linkar <code> 使用 6 位代码绑定 Minecraft 账号
!rank 显示分页排行榜
!rank <player> 显示指定玩家的统计数据
!banlist 显示锦标赛禁用宝可梦
!torneio 显示下一场锦标赛信息
!tournament history 显示最近 10 场锦标赛

权限

管理员(默认:OP 等级 2):

权限 描述
carena.admin 访问所有管理员命令
carena.admin.arena 管理竞技场
carena.admin.bossraid 管理 Boss 突袭
carena.admin.sync 强制同步到 Web API
carena.bypass.boundary 绕过竞技场边界弹出

玩家(默认:所有人):

权限 描述
carena.play.normal 加入普通队列
carena.play.ranked 加入排位队列
carena.play.challenge 挑战其他玩家
carena.play.spectate 观战对战
carena.play.bossraid 加入 Boss 突袭

配置

配置文件位于服务器世界目录下的 carena/carena-server.toml。

通用

选项 默认值 描述
language pt_br 语言(pt_br 或 en_us)

对战

选项 默认值 描述
enable_battle_logging true 启用详细对战日志
battle_timeout 10 对战超时时间(分钟,1-60)
challenge_timeout 30 挑战接受超时时间(秒,10-120)

竞技场

选项 默认值 描述
default_radius 20 默认竞技场半径(格,5-100)

Boss 突袭

选项 默认值 描述
spawn_radius 500 距世界出生点的最大生成距离(50-5000)
auto_enabled false 启用自动 Boss 突袭生成
auto_interval_hours 4 自动生成的间隔小时数(1-24)
duration_minutes 120 Boss 消失前的分钟数(10-480)
boss_pool mewtwo:100,... 逗号分隔的宝可梦:等级列表
base_xp_reward 5000 每只宝可梦的基础经验,按伤害百分比缩放(100-100000)
raiddens_enabled false 启用 RaidDens 模组集成

Web API

选项 默认值 描述
web_enabled false 启用 Web API 同步
web_api_url "" Web API 基础 URL
web_api_key "" 用于身份验证的密钥 API 密钥

Discord

选项 默认值 描述
webhook_enabled false 启用 Discord Webhook
webhook_url "" 用于对战结果的 Discord Webhook URL
status_webhook_url "" 用于服务器状态消息的独立 Webhook
notify_duel_result true 发送决斗结果嵌入消息
notify_promotion true 发送段位晋升嵌入消息
notify_boss_spawn true 发送 Boss 生成通知
notify_boss_defeated true 发送 Boss 击败通知
notify_boss_expired true 发送 Boss 过期通知
notify_server_start true 发送服务器启动通知
notify_server_stop true 发送服务器关闭通知
notify_match_found false 发送匹配成功通知
notify_arena_change false 发送竞技场变更通知
notify_queue_activity false 发送队列活动通知
bot_enabled false 启用内嵌 Discord 机器人
bot_token "" Discord 机器人令牌
bot_channel_id "" 机器人响应的频道 ID
cargo_id_link "" 账号绑定时分配的身份组 ID

锦标赛

选项 默认值 描述
tournament_enabled false 启用每周锦标赛
poll_hour 10 周六投票的小时(0-23)
tournament_channel_ids [] 锦标赛公告的频道 ID
admin_channel_id "" 管理员锦标赛结果的频道
enrollment_initial_slots 10 初始玩家名额(4-20)
enrollment_max_slots 20 最大玩家名额(4-20)
enrollment_slot_increment 2 满员时增加的名额(2-4)
bracket_announce_hours 24 锦标赛前公布对阵表的小时数(1-72)
max_concurrent_battles 3 同时进行的锦标赛对战上限(1-5)

要求

  • Minecraft 1.21.1
  • NeoForge
  • Cobblemon 1.7.3+
  • Java 21
  • 仅服务端

可选集成

  • RaidDens — 启用 raiddens_enabled 以自动集成突袭
  • 网站 — 启用 web_enabled 并配置 API URL 以获取排行榜、回放与奖杯
  • Discord Webhook — 启用 webhook_enabled 以获取对战结果嵌入消息
  • Discord 机器人 — 启用 bot_enabled 以使用交互式排行榜与锦标赛系统

语言

  • 英语(en_us)
  • 巴西葡萄牙语(pt_br)