
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 生成内容"披露(代码)。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。