King of the Ladder | [1.21.11 - 26.3]

Step 1: Create the arena
Initialize a new arena with a unique ID.
/kotl create <arena_id>

Step 2: Open the setup menu
Open the visual editor for the arena.
/kotl edit <arena_id>

Step 3: Set the end location
Set the safe fallback location used when a player is removed from the arena, the server reloads, or an unexpected error occurs.

Step 4: Select the Game Area
Use the Game Area selector to mark the two opposite corners of the complete playable area.

• Left-click: Set the first corner.
• Right-click: Set and save the second corner.
• Outline preview: Toggle the particle visualizer to inspect the selected area.

Step 5: Set the king plate
Choose a pressure plate material, receive the setup tool, and place the plate inside the selected Game Area. This plate becomes the crown trigger.

Step 6: Configure player settings
Choose how players are prepared when they enter the arena.

• Join gamemode: Select Survival, Creative, Adventure, or keep the player's current mode.
• Inventory and effects: Toggle inventory clearing and potion effect removal.
• Game displays: Enable or disable the arena scoreboard and boss bar.
• Arena records: Review or reset the arena's king record when needed.

Step 7: Register and play
Click the Firework item to validate, save, register, and enable the arena.

• Enter: Walk into the enabled Game Area to join automatically.
• Leave: Walk outside the Game Area to leave, restore your saved inventory, and remove the arena displays.

No permissions are required for statistics. Help access is enabled for everyone by default.

• /kotl help: Display the available commands. kotl.command.help
• /kotl stats [player]: Open the in-game statistics menu for yourself or a cached online or offline player.

Requires kotl.arena.* for full access.

• /kotl create <arena_id>: Create a new arena with the specified unique ID. kotl.arena.create
• /kotl delete <arena_id> [--confirm] [--cancel]: Delete an arena after confirming the action. kotl.arena.delete
• /kotl edit <arena_id>: Open the in-game GUI editor for arena setup and management. kotl.arena.edit
• /kotl list: Display all registered arenas together with their readiness and availability state. kotl.arena.list

Requires kotl.admin for full access.

• /kotl reload: Stop active games and reload messages, options, items, events, command settings, game displays, and arena outlines. kotl.admin.reload
• /kotl stop [arena]: Stop your current arena game or a specified active arena game. kotl.admin.stop
• /kotl kick <player>: Remove a player from an active arena and send them to its end location. kotl.admin.kick

Requires kotl.debug for full access and debug mode must be enabled. Debug commands are intended for testing and troubleshooting.

• /kotl debug component <message>: Parse and preview a MiniMessage component in-game. kotl.debug.component
• /kotl debug dump: Generate and send an event timing report for troubleshooting performance issues. kotl.debug.dump

These placeholders display statistics for the player viewing them.

%kotl_name%                           - Returns the player's name
%kotl_uuid%                           - Returns the player's unique ID
%kotl_games_played%                   - Total tours played
%kotl_score%                          - Total number of crown claims
%kotl_kills%                          - Total number of kills
%kotl_deaths%                         - Total number of deaths
%kotl_stat:arena_score:<arena_id>%    - Personal score in a specific arena

Display the player's current arena information or global activity across the server.

%kotl_is_playing%                    - Whether the player is inside an arena
%kotl_current_arena%                 - Current arena ID
%kotl_current_arena_players%         - Player count in the current arena
%kotl_current_arena_king%            - Current king of the player's arena
%kotl_current_arena_last_king%       - Last king of the player's arena
%kotl_current_arena_top_king%        - Record holder of the player's arena
%kotl_current_arena_top_king_score%  - Record score of the player's arena
%kotl_current_arena_score%           - Player's score in the current arena

%kotl_arenas_total%                  - Total registered arenas
%kotl_arenas_ready%                  - Total ready arenas
%kotl_active_games%                  - Games with active players
%kotl_active_players%                - Players across all active games

Fetch live data from specific arenas. Replace <id> with your arena identifier, for example arena1.

%kotl_arena:<id>:players%             - Current player count
%kotl_arena:<id>:king%                - Current king
%kotl_arena:<id>:last_king%           - Last player to claim the crown
%kotl_arena:<id>:top_king%            - Arena record holder
%kotl_arena:<id>:top_king_score%      - Arena record score

%kotl_arena:<id>:ready%               - Whether the arena setup is complete
%kotl_arena:<id>:enabled%             - Whether the arena is available
%kotl_arena:<id>:gamemode%            - Configured join game mode
%kotl_arena:<id>:scoreboard_enabled%  - Per-arena scoreboard setting
%kotl_arena:<id>:bossbar_enabled%     - Per-arena boss bar setting

Display your server's top-performing players on scoreboards or holograms.

%kotl_leaderboard:<statistic>:<position>:<type>%

• <statistic>: The statistic to rank: score (crown claims), kill, death, tours_played or arena_score_<arena_id>.
• <position>: The rank position, such as 1, 2, or 3.
• <type>: name for username, value for score, uuid, or formatted_value.

Examples:

# Name of the 1st place player by total crown claims
%kotl_leaderboard:score:1:name%

# Crown claim count of the 1st place player
%kotl_leaderboard:score:1:value%

# Name of the 3rd place player by total kills
%kotl_leaderboard:kill:3:name%

# Name of the top player in a specific arena
%kotl_leaderboard:arena_score_arena1:1:name%