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: 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

Permissions

All permissions default to OP level 2 if no permission manager is installed.

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>"
}

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" }
  }
}

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.

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