FAQ

General

Do players need to install anything?

No. Reverie is entirely server-side. Players don’t need a client mod or resource pack. All GUIs are server-managed and items appear as vanilla Minecraft items.

What Minecraft version does Reverie support?

Minecraft 1.21.1 on Fabric with Cobblemon 1.7.0+.

Does Reverie work with Forge/NeoForge?

No. Reverie is a Fabric-only mod.

Setup

How do I create my first contest?

Install the mod and start the server
Build a stage/arena in your world
Run /hallbuilder create my_arena and follow the wizard
Run /contest create cool my_arena to start a Cool contest
Players join with /contest join 1
Start with /contest start

See Your First Contest for a detailed walkthrough.

Where do config files go?

All config files are in config/reverie/ inside your server directory. They’re auto-generated on first launch.

How do I reload configs without restarting?

/reverie reload        # Reload all configs
/hallbuilder reload    # Reload hall configs
/contesttype reload    # Reload contest types

Contests

How many contests can run at once?

Configurable via maxActiveContests in contest.conf. Default: 5.

What happens if there aren’t enough players?

If autofill-with-bots = true in the hall config (default), empty slots are filled with AI contestants. The minimum to start is 2, and bots count toward that number.

Can I customize what moves are allowed?

Yes. Each contest type and hall can define banned-moves, allow-move-repeats, species-clause, banned-species, and level ranges. See Contest Types.

How do contest stats get initialized?

When a Pokemon is caught, gained, or hatched, Reverie automatically initializes its contest stats based on its nature. Stats can then be boosted with poffins.

What determines which move is “good” in a contest?

Move appeal depends on: move power, how well the move type matches the contest category, the Pokemon’s relevant contest stat, combo potential, and move variety. See Scoring & Formulas.

Items

How do I give players seal items?

Configure seals as contest rewards or give them via commands. The admin debug command /reverie debug applyseal <id> applies a seal directly to your Pokemon.

How does the seal placement grid work?

Each Pokemon can have multiple seals. Seals placed at different positions create particle effects at different locations relative to the Pokemon when it’s sent out. Manage placements through the Seal Case GUI.

Tournaments & Seasons

How are tournament brackets generated?

Brackets are auto-generated based on the tournament format (single/double elimination, round robin, swiss). Seeding can be random or score-based.

Can seasons run without tournaments?

Yes. Seasons track individual contest results. Tournaments are an optional competitive format that runs independently.

What happens when a season ends while the server is offline?

Reverie checks for expired seasons on startup. If a season ended while offline, it’s finalized and a new one begins (if auto-roll is enabled).

Performance

How many audience NPCs is too many?

This depends on your server hardware. The default of 20 NPCs is safe for most servers. Going above 50 may cause lag on lower-end hardware. Use /reverie debug perf to monitor.

How can I reduce lag during contests?

Lower npc-audience.max-count
Reduce effects.particles.intensity
Disable effects.lighting.dynamic-lighting
Lower camera transition frequency
Use /reverie debug loadtest to find your server’s limits

Permissions

What if I don’t have a permission mod?

Reverie falls back to Minecraft’s operator levels. Most admin commands require OP level 2. Player commands work for everyone.

Can I restrict contest spectating?

Yes. Set spectator-audience.requirePermission = true and players will need the reverie.contest.spectate permission.

Can I make VIP-only contests?

Yes. Set entry.permission = "your.vip.node" in a contest type config. Only players with that permission can enter.

Troubleshooting

Contest won’t start

Check minimum contestant count (min-contestants, default 2)
Verify the hall exists and is loaded (/hallbuilder info <id>)
Check for error messages in server logs
Enable debug mode: set debug = true in config.conf and run /reverie reload

Camera isn’t working

Verify cameras are enabled in the hall config
Check that camera positions have been set (/hallbuilder camera <id> list)
Force exit stuck camera: /reverie debug exitcamera

Poffins not boosting stats

Check if the Pokemon has reached the 510 total stat cap
Check if Sheen is at 255 (no more poffins can be fed)
Verify the poffin quality is above 0

Items not working

Ensure the player has the required permission (e.g., reverie.sealcase.use for seal cases)
Try giving a fresh item via admin commands