🏛️ PillarFight | The ultimate pillar survival minigame

PillarFight is an action-packed, fully configurable minigame for your Spigot/Paper server. The gameplay is simple yet absolutely addictive: each player starts on their own narrow pillar above the abyss. Every 5 seconds, everyone receives a random item or block. The last player left standing—having sent everyone else plunging into the depths—wins!

---

🎮 The game mechanics

1. The start: The players are teleported to their assigned pillars.
2. The chaos: Every 5 seconds, a random item (building blocks, TNT for blowing things up, snowballs for knockback) drops directly into the inventory.
3. The fight: Players are not allowed to mine the arena map—but any blocks they place themselves can be both placed and destroyed.
4. The goal: Knock your opponents off their pillars! Anyone who falls off dies and becomes a spectator. The last survivor claims victory.

---

✨ Features

• 🛠️ 100% Configurable: Every single message, menu label, countdown time, and reward can be customized in the config files.
• 📦 Automatic map reset: After every match, the arena is completely restored to its original state. No broken maps!
• 👥 Dynamic GUI system: An intelligent "Quick Join" button automatically places players into the fullest waiting lobby. A second GUI displays all arenas along with their live status (waiting, in-game, spectating).
• 📊 Integrated statistics: Continuously tracks games played, wins, kills, and losses for each player.
• 💬 Isolated Arena Chat & Tab List: Players (and spectators) in an arena share a dedicated chat and see only each other in the tab list. No spam for the rest of the server!
• 🧩 PlaceholderAPI Full support for player prefixes/suffixes from your rank system (LuckPerms, etc.) as well as custom placeholders for scoreboards.
• 💰 Console Rewards: Automatically execute console commands at the end of a game (e.g., to award coins/money to the winner and for each kill).
• 💎 VIP Features: Server VIPs have the option to force-start games and showcase their status in-game with cool particle effects.

---

⚙️ Commands & Permissions

All commands are intuitively structured as sub-commands:

Command	Description	Permission
/pf join	Opens the interactive arena selection GUI.	pillarfall.player
/pf leave	Leaves the current arena/spectator mode	pillarfall.player
/pf stats	Shows your personal statistics	pillarfall.player
/pf start	Shortens the lobby countdown to 5 seconds.	pillarfall.start
/pf forcestart	Start the game in the arena immediately.	pillarfall.forcestart
/pf setlobby	Sets the main lobby.	pillarfall.admin
/pf createarena <name>	Creates a new arena	pillarfall.admin
/pf deletearena <name>	Delets an arena	pillarfall.admin
/pf setpillar <arena>	Adds a pillar in the arena	pillarfall.admin
/pf removepillar <arena> <index>	Removes a pillar	pillarfall.admin
/pf setwaitingspawn <arena>	Sets the waitingspawn for arena	pillarfall.admin
/pf setspectatorspawn <arena>	Sets spectatorspawn for arena	pillarfall.admin
/pf setminplayers <arena> <minplayers>	Sets minimum players of arena to start	pillarfall.admin
/pf setmaxtime <arena> <time>	Sets maximum playtime	pillarfall.admin
/pf enable/disable <arena>	Enables/Disables an arena	pillarfall.admin
/pf info <arena>	Gets infos about arena	pillarfall.admin
/pf list	Lists all arenas	pillarfall.admin
/pf reload	Reloads the plugin	pillarfall.admin
-	Permission for particle effect ingame	pillarfall.particle

---

🧩 Placeholders (PlaceholderAPI)

Use these placeholders in your scoreboards or other plugins:

• %pillarfight_stats_games% – total games played
• %pillarfight_stats_wins% – total wins
• %pillarfight_stats_kills% – total kills
• %pillarfight_stats_losses% – total losses
• %pillarfight_stats_kdr% – kill/death ratio
• %pillarfight_arena_name% – current arena name (or "none")
• %pillarfight_arena_status% – current arena status
• %pillarfight_arena_players% – players in current arena
• %pillarfight_arena_maxplayers% – max players in current arena
• %pillarfight_arena_timeleft% – time left in current game
• %pillarfight_arena_kills% – kills in current game
• %pillarfight_arena_<name>_status% – status of a specific arena
• %pillarfight_arena_<name>_players% – player count of a specific arena