Installation

Installation

Wonder is a Fabric server mod with a small runtime surface: core config files, GUI definitions, tooltip fragments, and optional Redis or Discord integrations.

Requirements

Requirement	Details
Minecraft	1.21.1
Fabric Loader	0.17+
Fabric API	Matching 1.21.1 build
Cobblemon	Required
Ceremony	Required

Optional:

• LuckPerms for cooldown meta overrides
• Redis for ORCHESTRATOR / WORKER topologies

Install Steps

1. Drop the Wonder jar into mods/.
2. Make sure Cobblemon and Ceremony are already present.
3. Start the server once so Wonder can extract its config set.
4. Stop the server and review config/wonder/.
5. Adjust channels.conf, trade-pools.conf, and config.conf before going live.

Extracted Files

Wonder creates:

config/wonder/
├── config.conf
├── channels.conf
├── trade-pools.conf
├── messages.conf
├── announcements.conf
├── discord-webhooks.conf
├── sounds.conf
├── guis/
├── tooltips/
├── docs/config/
└── .config-schema-versions.json

Notes:

• docs/config/ is a reference mirror of the bundled config templates.
• .config-schema-versions.json tracks Wonder’s config schema versions.
• When Wonder replaces an outdated config during migration, it keeps a .bak copy beside the live file.
• announcements.conf now contains both presentations = [...] rules and announcements = [...] templates.

Updating

Wonder uses schema-version tracking instead of blindly overwriting extracted configs:

• missing or outdated configs are replaced from bundled defaults
• the previous live file is backed up as *.bak
• the current schema version is recorded in .config-schema-versions.json

GUI and tooltip defaults are copied only when missing.

Verification

After the first boot, check that:

• config/wonder/ exists
• config/wonder/channels.conf has a main channel
• config/wonder/trade-pools.conf has at least one pool if you want seeded fallback matching
• /wonder opens the main GUI in game

Troubleshooting

/wonder is missing Wonder or one of its dependencies failed to load. Check the startup log for Fabric/Cobblemon/Ceremony errors.

The GUI opens but queueing fails Your channel rules, cooldown, or pool config may be rejecting the Pokemon. Review Channels and Pools.

Configs changed after update Wonder replaced an outdated schema version. Check the adjacent .bak file and merge any live values you still need.