Arena Setup Guide

Setting up an arena in Santa Says is done through an intuitive in-game GUI. This guide will walk you through the process from the initial command to the final registration.

Step 1: Create the Arena

📸 Watch: How to create an arena

To begin, you need to initialize a new arena instance. Each arena must have a unique ID.

/santasays create <arena_id>

📸 Watch: Opening the setup menu

Once the arena is created, enter the Edit Mode to access the configuration GUI.

/santasays edit <arena_id>

This command opens the main setup menu where all configurations are handled.

Step 3: Configure Game Locations

📸 Watch: Setting teleport locations

Click on the Arena Locations (FILLED_MAP) item in the main menu to set the teleportation points.

Lobby (COMPASS): The location where players are teleported when they join the arena and wait for the game to start.
Start Location (BEACON): The specific point where players are teleported the moment the game loop begins.
End Location (END_PORTAL_FRAME): The location where players are sent after the game ends or if they leave.

Step 4: Set Player Amounts Optional

📸 Watch: Adjusting player limits

From the main menu, click on Player Amounts (GLOWSTONE_DUST) to define the arena’s capacity.

Minimum Players: How many players are needed to start the lobby countdown.
LEFT CLICK to increase | RIGHT CLICK to decrease.
Maximum Players: The total capacity of the arena.
LEFT CLICK to increase | RIGHT CLICK to decrease.

Step 5: Select the Game Platform

📸 Watch: Using the selection wand

The Platform Selector (BLAZE_ROD) is used to define the playable area where tasks will take place.

The platform is strictly 2D (flat). Use the wand to add or remove blocks from your game arena.

Wand Controls

Action	Control	Description
Add Area	`Left Click`	Selects the corners to ADD a rectangular region to the platform.
Remove Area	`Right Click`	Selects the corners to REMOVE a rectangular region from the platform.
Add Single	`Shift` + `Left Click`	ADDS the single block you are looking at to the platform.
Remove Single	`Shift` + `Right Click`	REMOVES the single block you are looking at from the platform.
Visualizer	`Middle Click`	Toggles the Particle Visualizer. This highlights all currently selected platform blocks with particles so you can see the boundaries.
Clear All	`Drop (Q)`	Resets the entire platform. Removes all selected blocks from the configuration.

Visualizer Mode

Building a perfect platform can be tricky. The Visualizer Mode helps you see exactly which blocks are currently part of your arena.

How to Toggle: Open the arena setup menu, hover over the Selection Wand item, and press Middle Click.

This highlights the boundaries of your platform, making it easy to spot missing blocks or accidental selections without having to guess.

Step 6: Create an Arena Sign Optional

📸 Watch: Linking a sign

Look directly at a sign and click the Create Arena Sign (OAK_SIGN) item. This will link the sign to your arena.

The sign will automatically update its status (Waiting, Starting, In-Game, Ending) and display the current player count.

Step 7: Register the Arena

📸 Watch: Finalizing the arena

Once you have configured all locations, player amounts, and the platform, it’s time to finalize.

Click the Register the Arena (FIREWORK) item. The plugin will validate your settings and, if everything is correct, the arena will be activated and ready for players!

Joining the Game

After successfully registering your arena, players can join the action in two ways:

By Command: Use /santasays join <arena_id> to enter the lobby.
By Sign: If you created an Arena Sign in Step 6, simply Right-Click the sign to join.

Summary Table

Item	Name	Function
`FILLED_MAP`	Arena Locations	Set Lobby, Start, and End points.
`GLOWSTONE_DUST`	Player Amounts	Set Min and Max player limits.
`BLAZE_ROD`	Platform Selector	Define the game area with a Wand.
`OAK_SIGN`	Create Sign	Link a physical sign to the arena status.
`FIREWORK`	Register	Save and activate the arena.