Channels

Channels

Wonder channels are separate WonderTrade lanes. Each one can have its own:

• open command
• permission
• queue capacity
• cooldown policy
• rarity/eligibility rules
• fallback trade pool

They are defined in config/wonder/channels.conf.

Example

channels = [
  {
    id = "main"
    name = "Wonder Trade"
    icon = "minecraft:ender_chest"
    command = "wonder"
    permission = "wonder.use"
    enabled = true
    queue-capacity = 500
    cooldown-seconds = 60
    cooldown-meta-global-key = "wonder.cooldown"
    cooldown-meta-channel-key-format = "wonder.cooldown.{channel}"
    allow-legendaries = true
    allow-mythicals = true
    allow-shinies = true
    banding = "none"
    pool-id = "main_pool"
    min-level = 1
    max-level = 100
    blocked-species = []
    required-aspects = []
    blocked-aspects = []
  }
]

Key Fields

Field	Purpose
id	Stable internal channel id.
name	Display label used in Wonder surfaces.
icon	Item id used by the channel selector GUI.
command	Optional alias that opens Wonder directly into this channel.
permission	Permission required to use or see the channel.
enabled	Toggle the channel without deleting it.
queue-capacity	Max queued entries Wonder will hold in that channel.
cooldown-seconds	Default queue cooldown for that channel.
cooldown-meta-global-key	Global LuckPerms meta key fallback for cooldown overrides.
cooldown-meta-channel-key-format	Channel-specific LuckPerms meta key template.
allow-legendaries / allow-mythicals / allow-shinies	High-level rarity filters.
banding	none or rarity.
pool-id	Optional fallback trade pool for this channel.
min-level / max-level	Level range filter.
blocked-species	Lowercase species ids blocked from queueing.
required-aspects	Aspect tokens the Pokemon must have.
blocked-aspects	Aspect tokens that disqualify the Pokemon.

Command Aliases

Wonder registers /wonder, /wondertrade, and /wt as the main roots. Additional channel commands from channels.conf are open-only aliases:

• they open Wonder already scoped to that channel
• they do not create a second full command tree for queue/history/admin

Cooldown Meta

If LuckPerms is installed, Wonder checks cooldown meta keys in this order:

1. cooldown-meta-channel-key-format
2. cooldown-meta-global-key
3. cooldown-seconds

With the bundled defaults:

wonder.cooldown.main
wonder.cooldown

Rarity Banding

With banding = "rarity", Wonder only pairs entries inside the same band:

• mythical
• legendary
• shiny
• standard

That lets you keep rare submissions from getting paired against normal filler trades.