CrossTheFloor - Minigame

CrossTheFloor
A fast-paced color floor minigame for Paper 1.21.4+

Race across a tiled path of colored blocks. Every few seconds a safe block is announced.
All other tiles disappear. Wrong block? You fall. First to the end wins!

Features

• Color Floor Minigame — Race across a 12-wide path made of 2x2 colored concrete tiles
• Three Difficulty Tiers — Easy (8 block types, 6s), Medium (10, 4s), Hard (14, 3s)
• Arena System — Create multiple arenas with a preview outline before building
• Auto-Generated Paths — Full arena structure generated automatically: platforms, walls, fall zone
• Randomized Every Round — New floor layout each round prevents memorization
• Ready Check System — Lobby with hotbar items, auto-kick for idle players
• Join via Signs or Commands — Place [CTF] signs or use /ctf join
• Configurable Rewards — Per-arena Vault money and command rewards
• Full Statistics — Games, wins, losses, falls, win rate, fastest win, streaks
• PlaceholderAPI Support — All stats as placeholders for scoreboards
• Inventory Protection — Full save/restore of inventory, armor, gamemode, health
• Hot-Reload — Reload config without restart

How It Works

1. Create an Arena
Stand at the desired location, face the path direction, and run:

/ctf create MyArena easy

A particle outline shows the arena bounds. Run /ctf confirm to build.

2. Join a Game
Place a sign with [CTF] on line 1 and the arena name on line 2, or use:

/ctf join MyArena

3. Ready Up
Click the green dye in your hotbar or use /ctf ready. Game starts when all players are ready (minimum 2).

4. Race!
A safe block type appears as a title. Find it and stand on it before the timer runs out. Wrong block = fall and respawn at start. Floor rebuilds with a new layout each round. First to the end wins!

Commands

/ctf join <arena>                 Join an arena
/ctf leave                        Leave current game
/ctf ready                        Ready up in lobby
/ctf create <name> <difficulty>   Create arena (easy/medium/hard)
/ctf confirm                      Confirm arena build
/ctf cancel                       Cancel arena creation
/ctf delete <name>                Delete arena
/ctf list                         List all arenas
/ctf reload                       Reload config
/ctf stats                        View your stats
/ctf stats <player>               View another player's stats
/ctf stats top [stat]             Leaderboard

Permissions

crossthefloor.play           Join games (default: everyone)
crossthefloor.admin          Create/delete arenas, reload (default: op)
crossthefloor.stats          View own stats (default: everyone)
crossthefloor.stats.others   View others' stats (default: op)

Difficulty Tiers

Placeholders

Requires PlaceholderAPI.

%crossthefloor_stat_games_played%      Player's total games
%crossthefloor_stat_games_won%         Player's wins
%crossthefloor_stat_win_rate%          Player's win percentage
%crossthefloor_stat_fastest_win%       Player's fastest win (seconds)
%crossthefloor_stat_best_streak%       Player's best win streak
%crossthefloor_global_total_games%     Server-wide total games
%crossthefloor_global_top_winner%      Most winning player
%crossthefloor_top_<stat>_<pos>%       Leaderboard entry

Dependencies

• Required: VersionAdapter
• Optional: Vault (for money rewards)
• Optional: PlaceholderAPI (for placeholders)

Installation

1. Place CrossTheFloor.v1-BL.jar in your server's plugins/ folder
2. Ensure VersionAdapter.jar is also in plugins/
3. Restart the server
4. Create arenas in-game with /ctf create
5. Customize settings in plugins/CrossTheFloor/config.yml

Part of the BekoLolek Plugin Ecosystem — Built by Lolek