Skip to content
Matcha! Mods

Introduction to Wonder

Introduction to Wonder

Section titled “Introduction to Wonder”

Wonder is a queued WonderTrade mod for Cobblemon Fabric servers. Players send one Pokemon into a channel, wait for the system to find a match, then reveal and claim the result later.

Why Wonder?

Section titled “Why Wonder?”

Normal direct trading needs both players at the same time. Wonder turns that into an asynchronous loop:

  • queue a Pokemon from your party or PC
  • let Wonder match it against another queued player or a configured trade pool
  • reveal the result when it is ready
  • keep an auditable history of what came in and out

That makes it useful for public servers, seasonal events, and passive economy loops where you want trading activity without requiring live coordination.

Core Systems at a Glance

Section titled “Core Systems at a Glance”

Queued WonderTrade : Players queue one Pokemon into a channel and wait for Wonder to find a partner.

Channels : Separate Wonder lanes with their own command alias, cooldown, queue capacity, eligibility rules, and optional dedicated trade pool.

Trade Pools : Server-seeded Pokemon pools that can satisfy a Wonder match when no second player is available.

Results : Wonder keeps one active ready result per player, hidden until the reveal flow opens it.

History : Every ready result is also written into the player’s Wonder history, including whether it has been claimed yet.

Announcements : Queue, rare-result, and periodic stats announcements can broadcast to players through MiniMessage templates, with presentation rules used to classify Pokemon for prefixes, suffixes, and dynamic counts.

Discord Webhooks : Wonder can post queue submissions, ready results, and claims to Discord with routed embed rules.

Cross-Server Sync : Wonder supports LOCAL, ORCHESTRATOR, and WORKER roles with Redis-backed event storage when you want the queue shared across servers.

Extracted Layout

Section titled “Extracted Layout”

On first boot Wonder extracts its runtime configs under config/wonder/:

Terminal window
config/wonder/
├── config.conf              # Core runtime config
├── channels.conf            # Wonder channel definitions
├── trade-pools.conf         # Seeded fallback pools
├── messages.conf            # Player-facing strings
├── announcements.conf       # Presentation rules and broadcast templates
├── discord-webhooks.conf    # Discord endpoint/rule config
├── sounds.conf              # Configured sound sequences
├── guis/                    # Wonder GUI definitions
├── tooltips/                # Tooltip fragments and templates
├── docs/
│   └── config/             # Bundled reference mirror for shipped configs
└── .config-schema-versions.json

What You’ll Need

Section titled “What You’ll Need”

Required:

  • Minecraft 1.21.1 on Fabric
  • Fabric Loader and Fabric API
  • Cobblemon
  • Ceremony

Optional:

  • LuckPerms for cooldown overrides through meta
  • Redis when you want shared Wonder queues across multiple servers
  • Discord webhooks for external Wonder event posting

Next Steps

Section titled “Next Steps”
  1. Installation
  2. Quick Start
  3. Queue and Matching
  4. Configuration Overview
  5. Wonder Config Builder