Your First Contest

Work in Progress

Reverie is currently in a WIP beta state. Features may be incomplete, change significantly, or contain bugs. Documentation may not reflect the latest state of the mod.

Your First Contest

This guide walks you through setting up your first contest from scratch.

Step 1: Build a Contest Hall

You need a physical location in your world to host contests. Build an arena or stage area, then use the Hall Builder to register it.

Using the Hall Builder Wizard

/hallbuilder create my_arena

This starts an interactive wizard that walks you through:

1. Setting the origin — Stand at the center of your hall and confirm
2. Defining bounds — Set the 3D bounding box (minimum 5x3x5 blocks)
3. Placing the stage center — The focal point where action happens
4. Setting contestant positions — Where players stand during each phase
5. Configuring audience seating — Where NPCs will sit
6. Setting camera positions — Where cameras will be placed for cinematic shots

Use /hallbuilder done to advance through steps, /hallbuilder skip for optional steps, and /hallbuilder cancel to abort.

Verifying Your Hall

/hallbuilder info my_arena

This displays all configured positions and validates the hall is ready for contests.

Step 2: Create a Contest Type (Optional)

Reverie ships with default contest types for each category (Cool, Beauty, Cute, Clever, Tough). To create a custom type:

/contesttype create

This opens a GUI where you can define scoring rules, phase durations, contestant limits, and more. See Contest Types for details.

Step 3: Run Your First Contest

As an Admin

/contest create cool my_arena

Replace cool with any contest type and my_arena with your hall ID.

Joining as a Player

Players join with:

/contest join 1

The number (1-6) is the party slot of the Pokemon they want to enter.

Starting the Contest

Once enough players have joined (minimum 2 by default):

/contest start

The contest flows automatically through all phases: Introduction, Presentation, Performance, Judging, and Results.

Not Enough Players?

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

Step 4: Give Players Items

Players benefit from having seals, poffins, and contest passes. You can distribute these with commands:

/poffin give @p basic 75
/berry give @p cheri 5

Or let players earn them as contest rewards by configuring rewards in your hall config.

Step 5: Set Up Rewards

Edit your hall’s HOCON config at config/reverie/halls/my_arena/hall.conf to define what winners receive. Reverie supports three reward types:

• Ribbon rewards — Automatically awarded based on placement tier
• Command rewards — Execute any server command (e.g., giving items)
• Currency rewards — Impactor Economy payouts (if installed)

rewards {
  first = [
    { type = "ribbon", tier = "master" },
    { type = "command", command = "give {player} minecraft:netherite_ingot 2" },
    { type = "currency", amount = 1000 }
  ]
}

What’s Next?

1. Contests — Learn the full contest system in depth
2. Hall Configuration — Fine-tune your venue setup
3. Tournaments — Set up multi-round competitive events
4. Seasons — Enable seasonal leaderboards for ongoing competition
5. Discord Integration — Connect webhooks for announcements