Cobblemon Eclipse Playback

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 https://cobblemoneclipse.com/replays/ 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: 128×128 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 | 128×128 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).}