Eclipse Playback
一款用于 Cobblemon 的服务端 Fabric 模组,提供 PokePaste 队伍导入、自动战斗回放录制以及针对虚构宝可梦(fakemon)的自定义精灵上传功能。
功能特性
PokePaste 队伍导入
直接从 PokePaste URL 将竞技队伍导入到你的 Cobblemon 队伍中。
- 解析完整的 Showdown 格式队伍(包含物种、招式、个体值/努力值分配、性格、特性、携带道具)
- 支持自定义/Eclipse 宝可梦物种映射
- 可为你自己或其他玩家导入队伍
Genesis Forms 集成:
开箱即用内置对 Genesis Forms 物品的支持:
- 超级石(Charizardite X/Y, Mewtwonite X/Y 等)
- Z 纯晶(Pikashunium-Z 等)
- 原始宝珠(红宝珠、蓝宝珠)
- 奥德贡面具(Cornerstone, Hearthflame, Wellspring, Teal)
- 传说物品(生锈的剑/盾, 坚固水晶, 光辉球体, 灰色核心)
- Genesect 驱动芯片(Shock, Burn, Chill, Douse)
- 记忆体和属性板
自定义物品映射:
可在 config/eclipse_playback/item_mappings.json 中配置额外的物品映射,以支持其他模组或自定义物品。
战斗回放录制
自动捕获 PvP 战斗并将回放上传至 Cobblemon Eclipse Replay Viewer。
- 以 Showdown 协议格式记录完整的战斗日志
- 将回放上传至 供公众观看
- 记录玩家队伍、胜者、回合数和持续时间
- 可配置回放上传时的广播消息
- 支持使用 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 中
- OP 玩家(等级 2+)会被提醒设置服务器名称(如果仍为默认的 "My Server")
- 无需注册或手动设置——安装即可使用
命令
| 命令 |
权限 |
描述 |
/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 Replay Viewer
- 对于没有官方精灵图的宝可梦,自定义精灵图会在回放查看器中显示
- MiniMessage 格式化需要 MiniPlaceholders 或兼容库(如果不可用则回退为纯文本)
- 服务器 UUID 在首次生成后保持不变,跨重启持久化存储 —— 请勿编辑或分享它
Cobblemon Eclipse 由我们的团队设计、指导、平衡和运营。每项功能及其行为均由我们编写并决定,随后在该指导下借助 AI 辅助构建,并在发布前于我们的实时网络中进行测试。根据 Modrinth 的 AI 政策,本项目已启用“包含 AI 生成内容”披露(代码)。
Eclipse Playback
A server-side Fabric mod for Cobblemon that provides PokePaste team importing, automatic battle replay recording, and custom sprite uploads for fakemon.
Features
PokePaste Team Import
Import competitive teams directly from PokePaste URLs into your Cobblemon party.
- Parses full Showdown format teams (species, moves, EVs, IVs, nature, ability, held item)
- Supports custom/Eclipse Pokemon species mappings
- Import teams for yourself or other players
Genesis Forms Integration:
Built-in support for Genesis Forms items out of the box:
- Mega Stones (Charizardite X/Y, Mewtwonite X/Y, etc.)
- Z-Crystals (Pikashunium-Z, etc.)
- Primal Orbs (Red Orb, Blue Orb)
- Ogerpon Masks (Cornerstone, Hearthflame, Wellspring, Teal)
- Legendary Items (Rusted Sword/Shield, Adamant Crystal, Lustrous Globe, Griseous Core)
- Genesect Drives (Shock, Burn, Chill, Douse)
- Memory items and Type Plates
Custom Item Mappings:
Configure additional item mappings in config/eclipse_playback/item_mappings.json to support other mods or custom items.
Battle Replay Recording
Automatically captures PvP battles and uploads them to the Cobblemon Eclipse Replay Viewer.
- Records complete battle logs in Showdown protocol format
- Uploads replays to for public viewing
- Captures player teams, winner, turn count, and duration
- Configurable broadcast messages when replays are uploaded
- Supports MiniMessage formatting for chat announcements
- Each server is assigned a unique UUID for tracking and moderation
Custom Fakemon Sprites
Servers running fakemon or custom Pokemon can upload front/back sprites so they display correctly in the replay viewer instead of showing a substitute placeholder.
- Place PNG sprites in the
config/eclipse_playback/sprites/ folder
- Files must be named
{pokemonname}-front.png or {pokemonname}-back.png
- Maximum dimensions: 128x128 pixels
- Maximum file size: 50KB per sprite
- Sprites are uploaded automatically on server startup
- Already-uploaded sprites are tracked locally and won't re-upload
Example:
config/eclipse_playback/sprites/
├── exogon-front.png
├── exogon-back.png
├── fakemon-front.png
└── fakemon-back.png
Server Identity
Each server is automatically assigned a unique UUID on first startup. This UUID is sent with all replay and sprite uploads, allowing the Eclipse website to track which server submitted what data. If a server uploads inappropriate content, an admin can ban that server's UUID and scrub all of its data.
- UUID is auto-generated on first run and saved to
config/eclipse_playback/replays.json
- OP players (level 2+) are reminded to set their server name if it's still the default "My Server"
- No registration or manual setup required - just install and go
Commands
| Command |
Permission |
Description |
/giveteam <url> |
pokepaste.giveteam |
Import a PokePaste team to your party |
/pokepaste <url> |
pokepaste.giveteam |
Same as /giveteam |
/giveteamother <player> <url> |
pokepaste.giveteamother |
Import a team to another player's party |
/pokepaste reload |
pokepaste.admin |
Reload configuration files |
/pokepaste eclipse list |
pokepaste.admin |
List all custom Pokemon mappings |
Permissions
All permissions default to OP level 2 if no permission manager is installed.
| Permission |
Description |
pokepaste.giveteam |
Use /giveteam and /pokepaste to import teams |
pokepaste.giveteamother |
Import teams to other players |
pokepaste.admin |
Reload config and view eclipse mappings |
Configuration
Replay Config
Location: 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>"
}
| Option |
Description |
Default |
enabled |
Enable/disable replay recording and sprite uploads |
true |
serverName |
Your server's display name in replays |
"My Server" |
serverIp |
Server IP shown to viewers (optional) |
"" |
serverUuid |
Unique server identifier (auto-generated, do not change) |
"" (auto-fills) |
broadcastToServer |
true = announce to all players, false = only battle participants |
true |
broadcastFormat |
MiniMessage format for chat announcements. Placeholders: {player1}, {player2}, {winner}, {url} |
Eclipse gradient style |
PokePaste Config
Location: config/pokepaste/eclipse_pokemon.json
Defines custom Pokemon species mappings for servers with custom Pokemon:
{
"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"
}
}
}
Usage in PokePaste:
- Write
(eclipse) Flygon to get the mapped Eclipse species
- Write
Surusypia directly for custom species
Item Mappings Config
Location: config/eclipse_playback/item_mappings.json
Maps Showdown item names to actual mod items. Genesis Forms items are included by default.
{
"formItemNamespace": "genesisforms",
"customMappings": {
"cornerstonemask": { "namespace": "genesisforms", "itemId": "cornerstone_mask" },
"charizarditex": { "namespace": "genesisforms", "itemId": "charizardite-x" }
},
"suffixPatterns": {
"ite": { "keepAsIs": true },
"iumz": { "dropLast": 1, "appendSuffix": "-z" }
}
}
| Option |
Description |
formItemNamespace |
Default namespace for form-changing items |
customMappings |
Explicit item name to mod item mappings |
suffixPatterns |
Rules for automatically transforming item names by suffix |
Custom Sprites
Location: config/eclipse_playback/sprites/
Place PNG sprites in this folder to upload them to the Eclipse replay viewer. The folder is created automatically on first startup.
| Requirement |
Value |
| File format |
PNG only |
| Naming |
{name}-front.png or {name}-back.png |
| Max dimensions |
128x128 pixels |
| Max file size |
50KB per file |
Sprites are uploaded once and tracked in config/eclipse_playback/sprites-uploaded.json. If you update a sprite file, the new version will be re-uploaded automatically on the next server restart.
Requirements
- Minecraft 1.21.1
- Fabric Loader 0.16.5+
- Fabric API
- Cobblemon 1.7.0+
Notes
- Server-side only - Players do not need to install this mod
- Battle replays are uploaded to the public Eclipse Replay Viewer
- Custom sprites appear in the replay viewer for any Pokemon that doesn't have an official sprite
- MiniMessage formatting requires MiniPlaceholders or a compatible library (falls back to plain text if unavailable)
- The server UUID is generated once and persists across restarts - do not edit or share it
Cobblemon Eclipse is designed, directed, balanced, and operated by our team. Every feature and its behavior is authored and decided by us, then built with AI assistance under that direction and tested on our live network before release. Per Modrinth's AI policy, this project has the "Contains AI-generated content" disclosure enabled (code).
评论 0
登录后参与评分
还没有评论,来抢沙发吧