PillarFight

# 🏛️ PillarFight | The ultimate pillar survival minigame (https://img.shields.io/badge/Minecraft-latest-brightgreen.svg)](https://www.spigotmc.org/) (https://img.shields.io/badge/Platform-PaperMC%20%7C%20Spigot%20%7C%20Bukkit%20%7C%20Purpur-blue.svg)](https://papermc.io/) (https://img.shields.io/badge/Dependencies-PlaceholderAPI-orange.svg)]() **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