Cobblemon Eclipse 回放

Cobblemon Eclipse 回放

一个用于cobblemon的宝可梦粘贴导入器和战斗回放模组

管理

Eclipse Playback

一个面向 Cobblemon 的服务端 Fabric 模组,提供 PokePaste 队伍导入、自动对战回放录制,以及为 fakemon 提供自定义精灵图上传功能。

功能

PokePaste 队伍导入

直接从 PokePaste URL 将对战队伍导入到你的 Cobblemon 队伍中。

  • 解析完整的 Showdown 格式队伍(物种、招式、EV、IV、性格、特性、携带道具)
  • 支持自定义/ Eclipse 宝可梦物种映射
  • 为自己或其他玩家导入队伍

Genesis Forms 集成: 开箱即支持 Genesis Forms 物品:

  • Mega 石(Charizardite X/Y、Mewtwonite X/Y 等)
  • Z 纯晶(Pikashunium-Z 等)
  • 原始宝珠(Red Orb、Blue Orb)
  • Ogerpon 面具(Cornerstone、Hearthflame、Wellspring、Teal)
  • 传说物品(Rusted Sword/Shield、Adamant Crystal、Lustrous Globe、Griseous Core)
  • Genesect 卡带(Shock、Burn、Chill、Douse)
  • 记忆道具和属性石板

自定义物品映射: 在 config/eclipse_playback/item_mappings.json 中配置额外的物品映射,以支持其他模组或自定义物品。

对战回放录制

自动捕获 PvP 对战并上传到 Cobblemon Eclipse 回放查看器。

  • 以 Showdown 协议格式记录完整对战日志
  • 将回放上传到 https://cobblemoneclipse.com/replays/ 供公开查看
  • 捕获玩家队伍、胜者、回合数和持续时间
  • 可配置回放上传时的广播消息
  • 支持聊天公告的 MiniMessage 格式化
  • 每个服务器分配唯一 UUID 用于追踪和审核

自定义 Fakemon 精灵图

运行 fakemon 或自定义宝可梦的服务器可以上传正面/背面精灵图,使其在回放查看器中正确显示,而不是显示替身占位图。

  • 将 PNG 精灵图放入 config/eclipse_playback/sprites/ 文件夹
  • 文件必须命名为 {pokemonname}-front.png 或 {pokemonname}-back.png
  • 最大尺寸:128x128 像素
  • 最大文件大小:每张精灵图 50KB
  • 精灵图会在服务器启动时自动上传
  • 已上传的精灵图会在本地追踪,不会重复上传

示例:

config/eclipse_playback/sprites/
├── exogon-front.png
├── exogon-back.png
├── fakemon-front.png
└── fakemon-back.png

服务器身份

每个服务器在首次启动时会自动分配唯一 UUID。该 UUID 会随所有回放和精灵图上传一并发送,使 Eclipse 网站能够追踪是哪个服务器提交了什么数据。如果服务器上传了不当内容,管理员可以封禁该服务器的 UUID 并清除其所有数据。

  • UUID 在首次运行时自动生成并保存到 config/eclipse_playback/replays.json
  • 如果服务器名称仍为默认的 "My Server",OP 玩家(等级 2+)会收到设置服务器名称的提醒
  • 无需注册或手动设置 - 安装即可使用

命令

命令 权限 描述
/giveteam <url> pokepaste.giveteam 将 PokePaste 队伍导入到你的队伍
/pokepaste <url> pokepaste.giveteam 与 /giveteam 相同
/giveteamother <player> <url> pokepaste.giveteamother 将队伍导入到另一名玩家的队伍
/pokepaste reload pokepaste.admin 重新加载配置文件
/pokepaste eclipse list pokepaste.admin 列出所有自定义宝可梦映射

权限

如果未安装权限管理器,所有权限默认均为 OP 等级 2。

权限 描述
pokepaste.giveteam 使用 /giveteam 和 /pokepaste 导入队伍
pokepaste.giveteamother 向其他玩家导入队伍
pokepaste.admin 重新加载配置并查看 eclipse 映射

配置

回放配置

位置: config/eclipse_playback/replays.json

{
  "enabled": true,
  "serverName": "My Server",
  "serverIp": "play.myserver.com",
  "serverUuid": "",
  "broadcastToServer": true,
  "broadcastFormat": "<gradient:#0fd9ff:#9145ff><bold>[Eclipse Replay]</bold></gradient> <white>{player1}</white> <gray>vs</gray> <white>{player2}</white> <gray>-</gray> <aqua><click:open_url:'{url}'><underlined>Watch Replay</underlined></click></aqua>"
}
选项 描述 默认值
enabled 启用/禁用回放录制和精灵图上传 true
serverName 你的服务器在回放中的显示名称 "My Server"
serverIp 向查看者显示的服务器 IP(可选) ""
serverUuid 唯一服务器标识符(自动生成,请勿更改) ""(自动填充)
broadcastToServer true = 向所有玩家公告,false = 仅对战参与者 true
broadcastFormat 聊天公告的 MiniMessage 格式。占位符:{player1}、{player2}、{winner}、{url} Eclipse 渐变样式

PokePaste 配置

位置: config/pokepaste/eclipse_pokemon.json

为拥有自定义宝可梦的服务器定义自定义宝可梦物种映射:

{
  "eclipseMappings": {
    "flygon": {
      "eclipseSpecies": "exogon",
      "displayName": "Exogon",
      "description": "Eclipse variant of Flygon. Use: (eclipse) Flygon"
    }
  },
  "customSpecies": {
    "surusypia": {
      "cobblemonSpecies": "surusypia",
      "displayName": "Surusypia",
      "description": "Custom Pokemon. Use directly: Surusypia"
    }
  }
}

在 PokePaste 中的用法:

  • 写 (eclipse) Flygon 以获取映射的 Eclipse 物种
  • 直接写 Surusypia 以使用自定义物种

物品映射配置

位置: config/eclipse_playback/item_mappings.json

将 Showdown 物品名称映射到实际模组物品。默认包含 Genesis Forms 物品。

{
  "formItemNamespace": "genesisforms",
  "customMappings": {
    "cornerstonemask": { "namespace": "genesisforms", "itemId": "cornerstone_mask" },
    "charizarditex": { "namespace": "genesisforms", "itemId": "charizardite-x" }
  },
  "suffixPatterns": {
    "ite": { "keepAsIs": true },
    "iumz": { "dropLast": 1, "appendSuffix": "-z" }
  }
}
选项 描述
formItemNamespace 形态变化物品的默认命名空间
customMappings 显式物品名称到模组物品的映射
suffixPatterns 按后缀自动转换物品名称的规则

自定义精灵图

位置: config/eclipse_playback/sprites/

将 PNG 精灵图放入此文件夹以将其上传到 Eclipse 回放查看器。该文件夹会在首次启动时自动创建。

要求 值
文件格式 仅 PNG
命名 {name}-front.png 或 {name}-back.png
最大尺寸 128x128 像素
最大文件大小 每个文件 50KB

精灵图仅上传一次,并记录在 config/eclipse_playback/sprites-uploaded.json 中。如果你更新了精灵图文件,新版本会在下次服务器重启时自动重新上传。


需求

  • Minecraft 1.21.1
  • Fabric Loader 0.16.5+
  • Fabric API
  • Cobblemon 1.7.0+

说明

  • 仅服务端 - 玩家无需安装此模组
  • 对战回放会上传到公开的 Eclipse 回放查看器
  • 对于没有官方精灵图的宝可梦,自定义精灵图会显示在回放查看器中
  • MiniMessage 格式化需要 MiniPlaceholders 或兼容库(不可用时回退为纯文本)
  • 服务器 UUID 只生成一次并在重启后保留 - 请勿编辑或分享

Cobblemon Eclipse 由我们的团队设计、指导、平衡和运营。每个功能及其行为均由我们编写和决定,并在该指导下借助 AI 辅助构建,发布前在我们的实际网络上进行测试。根据 Modrinth 的 AI 政策,本项目已启用"包含 AI 生成内容"披露(代码)。