PokeVault

PokeVault

Never lose a Pokémon to a bug, a rollback, or a bad update again.

PokeVault periodically backs up every player’s Cobblemon team and PC boxes, and gives admins a web dashboard to browse those backups, see exactly what changed between rounds, and restore anything that goes missing — without ever touching a player’s live data unless you tell it to.

Features

• Automatic periodic backups — captures every known player’s team + full PC on a configurable interval (default: every 60 minutes), validated before being kept.
• Web dashboard (/pokevault web) — browse rounds → players → team/PC, all from your browser.
• Server-wide total at a glance — see how many Pokémon exist across the whole server for any round, and per player.
• Diff between rounds — instantly see which Pokémon appeared or disappeared since the previous backup, broken down by team and by individual PC box.
• One-click restore — restore a single Pokémon, an entire box, an entire team, or everything at once. Restored Pokémon always land in the player’s first free slot — never overwrites anything.
• Pokepaste export — export any Pokémon from any backup as Showdown-format text, ready to paste or share.
• Big-loss alerts — a persistent warning (stays until dismissed) when a player loses too many Pokémon between two rounds, with a per-box breakdown of which box lost data and which are still intact. Choose a fixed count or a percentage of what the player had.
• Automatic cleanup — a round identical to the previous one (no changes at all) is discarded automatically, so storage doesn’t fill up during quiet periods. Old rounds also rotate out past your retention limit, and any round can be deleted manually.
• Local-only web server — the dashboard listens only on 127.0.0.1; it’s never exposed to your network.

Requirements

• Fabric Loader
• Fabric API
• Fabric Language Kotlin
• Cobblemon 1.7.1+

Commands

• /pokevault web — get a clickable link to open the dashboard
• /pokevault now — force an immediate backup round
• /pokevault status — quick status summary in chat
• /pokevault alerts / /pokevault alerts clear <id> — list/dismiss active loss alerts

Configuration

Lives in config/pokevault/backup.properties, and most of it can also be changed live from the dashboard (no restart needed, except for the port):

• intervalMinutes — how often to capture a round (default 60)
• maxRounds — how many rounds to keep (default 336 = 14 days)
• lossThresholdMode — count or percent
• bigLossThreshold / bigLossPercent — the alert trigger value
• port — local dashboard port (default 8644)

Permissions

The /pokevault command and the dashboard’s restore actions mutate live player data — both are admin-only (command requires permission level 3 by default).