Eclipse Playback

A server-side Fabric mod for Cobblemon that provides PokePaste team importing and automatic battle replay recording.

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

Commands

Permissions

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

Configuration

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

Replay Config

Location: config/eclipse_playback/replays.json

{
  "enabled": true,
  "serverName": "My Server",
  "serverIp": "play.myserver.com",
  "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>"
}

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
• MiniMessage formatting requires MiniPlaceholders or a compatible library (falls back to plain text if unavailable)