LocoPillars

What is LocoPillars?

LocoPillars is a feature-complete, production-ready Pillars of Fortune server plugin. Players spawn in isolated cages, get released into the arena, and compete to build the tallest pillar while fighting off every other player. Last one standing wins.

Under the hood it runs multi-instance arena management, fully scriptable LuckyBlocks, a drag-and-drop cosmetics shop, 27+ achievements, a per-player stats database, 100+ PlaceholderAPI placeholders, and an in-game map editor. All configurable without touching a single line of code.


Feature Overview

Category	Highlights
Gameplay	Solo & team modes · Multi-instance arenas · Cage countdown
LuckyBlocks	50 pre-designed effects · Fully scriptable via Kotlin .kts
Cosmetics	64 pre-designed cosmetics · Kill / Death / Win effects · Custom cages
Achievements	27+ achievements · 4 difficulty tiers · Reward system
Statistics	Full stats DB · Leaderboards · Streaks · Playtime · Multi-kills
Voting Events	Coming soon, fully scriptable via modules
Chat	Context-aware formats · Team chat · Social spy · Profanity filter
Editor	In-game map editor · WorldEdit/FAWE schematics · Validation
Scoreboards	5 dynamic scoreboard types · Live team status · Timers
PlaceholderAPI	100+ placeholders covering stats, teams, maps, achievements
Database	H2 (embedded) · MySQL · MariaDB · PostgreSQL · HikariCP

Gameplay

Players drop into cages at the start of each round. After the countdown, cages open and everyone scrambles to build a pillar and fight for survival. The last team (or player) alive wins.

Multi-Instance Arenas
Run multiple simultaneous games on the same server, each in its own isolated world. Set a number in config.yml and LocoPillars handles the rest.

Team Support

• Configurable players-per-team and number of teams
• Team-colored leather armor
• Team chat (/teamchat)
• Team status on scoreboard & TAB list

LuckyBlocks

LuckyBlocks are fully scriptable. Each block is its own folder containing a Settings.json for metadata and a Luckyblock.kts for the effect. The plugin ships with 50 pre-designed LuckyBlocks. Drop a new folder into plugins/LocoPillars/Luckyblocks/ and it gets picked up automatically with no restart needed.

Settings.json
Rarity options: COMMON UNCOMMON RARE EPIC LEGENDARY. Chances per rarity are configured in config.yml.

Luckyblock.kts

The script receives player (who broke the block) and game (utility helper). The full Bukkit/Paper API is available.


Cosmetics

Cosmetics work the same way as LuckyBlocks. Each cosmetic is a folder under plugins/LocoPillars/Cosmetics/<type>/ with a Settings.json and a Cosmetic.kts script. The plugin ships with 64 pre-designed cosmetics across four categories. Players buy and equip cosmetics through /cosmetics using in-game coins.

Type	Count	Trigger
Kill effects	20	Triggered when the player gets a kill
Death effects	20	Triggered when the player is eliminated
Win effects	20	Triggered when the player's team wins
Cages	4	The skin used for the spawn cage

Settings.json
Cosmetic.kts

The script receives player (the cosmetic owner, killer for kill effects or the eliminated player for death effects) and game.


Voting Events (Coming Soon)

Voting events are mid-game modifiers that players vote on during a game. This system uses the same module-based approach as LuckyBlocks and Cosmetics. Drop a folder into plugins/LocoPillars/modules/voting/ and it becomes available in-game without a restart.

settings.json
script.kts

The script receives game and players. Use game.registerEventListener to hook into Bukkit events. The listener is automatically cleaned up when the game ends.


Achievements

27+ built-in achievements across 4 difficulty tiers, each with configurable XP and coin rewards. Add your own by dropping a .yml file in plugins/LocoPillars/Achievements/.

Difficulty	Examples
Easy	first_win · builder_basics · explorer
Normal	warrior · demolisher · team_player
Hard	champion · survivor · multi_killer
Extreme	legendary · perfect_game · comeback_king

Commands

Player Commands

Command	Aliases	Description
/pillars join <type|random>	/pof, /games	Join a game or a random available game
/pillars leave	Leave your current game
/pillars list	List available game types
/pillars status	View current game status
/pillars stats	View server-wide statistics
/pillars help	Show help overview
/spawn	/hub, /lobby	Teleport to the lobby
/stats	/mystats	View personal statistics
/achievements	/ach	Open achievements overview
/cosmetics	/cosm	Browse and equip cosmetics
/luckyblocks	/luckyb	Open the LuckyBlocks menu
/teamchat	/tc	Toggle team chat mode
/hideme	/hm	Hide yourself from other players
/hideothers	/ho	Hide all other players from your view
/showothers <player>	/so	Show a specific player while hideothers is on

Admin Commands

Command	Aliases	Description
/editor toggle	/adminedit	Enter / exit admin editor mode
/editor create <name>	Create a new arena map
/editor edit <name>	Edit an existing arena
/editor delete <name>	Delete an arena
/editor list	List all arenas
/editor save	Save current editor session
/editor cancel	Cancel without saving
/editor spawn	Manage spawn / cage positions
/editor validate	Validate arena configuration
/editor settings	Open editor settings GUI
/editor hotbar	Open the editor hotbar tool manager
/editor files	Manage arena schematic files
/editor doctor	Run auto-diagnostics on arena
/editor setup	Quick-setup wizard
/editor resize	Resize a schematic
/editor info	Show arena info
/setspawn	Set the lobby spawn point
/vanish [player]	/v	Toggle vanish for yourself or another player
/chatadmin reload	/ca reload	Reload chat configuration
/chatadmin announce <msg>	/ca announce	Send a server announcement
/chatadmin mute <player>	/ca mute	Mute a player
/chatadmin unmute <player>	/ca unmute	Unmute a player
/chatadmin clear	/ca clear	Clear chat for all players
/chatadmin stats	/ca stats	View chat statistics
/chatadmin cooldown <player> <s>	Set a player chat cooldown
/socialspy	/spy, /ss	Toggle social spy
/cosmetics give <player> <id>	Give a cosmetic to a player
/cosmetics coins <player> <amount>	Modify a player coin balance
/cosmetics reload	Reload cosmetics configuration
/luckyblocks getluckyblock	Give yourself a LuckyBlock item
/memory check|clear|status	/mem	View / manage plugin memory usage
/tab reload	Reload TAB plugin config

Admin Editor (/editor)

LocoPillars ships with a full in-game map editor, no external tools needed.

1. Run /editor setup for the guided quick-setup wizard.
2. Use /editor create <name> to start a new arena.
3. Place cage spawn points with the hotbar tools (/editor hotbar).
4. Import WorldEdit / FAWE schematics and attach them to the arena.
5. Run /editor validate to catch configuration errors.
6. Save with /editor save and the arena is immediately available in-game.

Supports multiple schematics per arena, schematic resizing, and live hotbar-based spawn-point editing, all without leaving the game.


Scoreboards

Scoreboard	Shown When	Key Info
Lobby	Player is in the lobby	Rank · Coins · Level · XP · Achievements · Online count
Game Lobby	Waiting for a game to start	Game name · Map · Player count · Min players
Cage	Countdown before game starts	Start countdown · Game info
Active Game	During a live game	Live timer · Item drop timer · Team status
Spectate	Spectating a game	Live timer · Item timer · All team statuses

PlaceholderAPI

Requires PlaceholderAPI. All placeholders use the %locopillars_ prefix.







Requirements & Dependencies

Dependency	Type	Notes
Paper	Server	1.21+
WorldEdit or FastAsyncWorldEdit	Required	Auto-detected at startup
PlaceholderAPI	Required	2.11+
TAB[/TD>	Optional	5.2+, enhanced player list
ProtocolLib	Optional	5.4+, tab visibility management
Vault	Optional	1.7+, economy reward integration
ItemsAdder	Optional	3.6+, custom cosmetic item textures

Permissions Players (default: true)

Permission	Description
locopillars.pillars.*	All /pillars subcommands
locoPillars.play	Join and play games
locopillars.spawn	Teleport to lobby
locopillars.chat.use	Send chat messages
locopillars.chat.teamchat	Use team chat
locopillars.hideme	Hide yourself from others
locopillars.hideothers	Hide other players
locopillars.showothers	Show a specific player
locopillars.achievements.use	Use achievement commands
locopillars.luckyblocks.menu	Open the LuckyBlocks menu

Staff (default: op)

Permission	Description
locopillars.admin	All administrative access
locopillars.editor	Use /editor and all map tools
locopillars.setspawn	Set the lobby spawn location
locopillars.spawn.others	Teleport other players to spawn
locopillars.vanish	Toggle vanish mode
locopillars.memory.use	Memory management commands
locopillars.chat.admin	All chat administration
locopillars.chat.socialspy	View all player chat
locopillars.chat.bypass-cooldown	Skip chat cooldown
locopillars.chat.bypass-filter	Skip profanity filter
locopillars.achievements.admin	Administer achievements
locopillars.luckyblocks.getluckyblock	Get a LuckyBlock via command
locopillars.notify.update	Receive in-game update notifications
locopillars.tab	Reload TAB configuration

Database Set in config.yml, no code changes needed.

Backend	Notes
H2	Default, embedded, zero setup
MySQL	Recommended for production / network servers
MariaDB	Fully supported
PostgreSQL	Fully supported

All backends use HikariCP connection pooling. Configuration Automatic Update Checker LocoPillars checks Modrinth on startup for new releases. Staff with the locopillars.notify.update permission receive an in-game notification when an update is available. Can be disabled in config.yml.