PillarOfFortune

A competitive survival game plugin for Minecraft 1.21+ where players fight on tall bedrock pillars.

Features

• Multiple Game Modes: Solo, Duo, Trio, and Squad gameplay
• Dynamic World Generation: Flat worlds with tall bedrock pillars
• Party System: Create parties and play with friends
• Customizable Scoreboard: Shows player stats and server info
• NPC Integration: Citizens NPCs for easy game joining
• Random Item Distribution: Items given every 10 seconds during gameplay
• Spectator Mode: Watch the action after elimination
• Win/Loss Tracking: Player statistics and leveling system
• Configurable Settings: Everything customizable via config.yml

Commands

Main Commands

• /pof setlobby - Set the lobby location (Admin)
• /pof lobby - Teleport to lobby
• /pof reload - Reload configuration (Admin)
• /pof join <Solo/Duo/Trio/Squad> - Join a game mode

Party Commands

• /pof party create - Create a party
• /pof party disband - Disband your party (Leader only)
• /pof party invite <player> - Invite a player to your party
• /pof party accept - Accept a party invitation
• /pof party decline - Decline a party invitation
• /pof party leave - Leave your current party
• /pof party kick <player> - Kick a player from your party (Leader only)
• /pof party list - List all party members

NPC Commands

• /pof npc add <solo/duo/trio/squad> - Create an NPC for a game mode (Admin)
• /pof npc remove - Remove the nearest PillarOfFortune NPC (Admin)

Permissions

• pillaroffurtune.* - All permissions (Default: OP)
• pillaroffurtune.use - Basic plugin usage (Default: true)
• pillaroffurtune.admin - Administrative commands (Default: OP)
• pillaroffurtune.setlobby - Set lobby location (Default: OP)
• pillaroffurtune.reload - Reload configuration (Default: OP)
• pillaroffurtune.npc - Manage NPCs (Default: OP)

Installation

1. Download the plugin JAR file
2. Place it in your server's plugins/ folder
3. Install the required dependencies:
   • FancyNpcs (required, for NPC functionality)
   • PlaceholderAPI (recommended, for chat prefixes and advanced placeholders)
   • LuckPerms (optional, for permission-based chat prefixes)
   • Vault (optional, for economy integration)
4. Restart your server
5. Configure the plugin in plugins/PillarOfFortune/config.yml
6. Set the lobby location with /pof setlobby
7. Create NPCs with /pof npc add <mode>

Configuration

The plugin is highly configurable through the config.yml file. You can customize:

• Server information displayed on scoreboard
• Game settings (player limits, timers, pillar dimensions)
• Scoreboard appearance and content
• Messages and colors
• Random items given during gameplay
• Database settings for player statistics
• Chat formatting and LuckPerms integration

Game Mechanics

Game Flow

1. Players join a game mode (Solo/Duo/Trio/Squad)
2. They wait in a glass cube above the playing area
3. When enough players join, a countdown begins
4. Players are teleported to individual bedrock pillars
5. Every 10 seconds, random items are given to all players
6. Last player/team standing wins
7. Winner gets fireworks and title display
8. All players return to lobby after 10 seconds

Party System

• Party leaders can invite up to 8 players
• When a party leader joins a game, all members join together
• Parties are automatically disbanded when the leader leaves

Statistics

• Wins and losses are tracked per player
• Players gain experience and levels
• Statistics are displayed on the scoreboard
• Data is stored in SQLite database (MySQL support available)

Building

This project uses Maven for building:

mvn clean package

The compiled JAR will be in the target/ directory.

Dependencies

• Spigot/Paper 1.21+
• FancyNpcs (Required for NPC functionality)
• PlaceholderAPI (Recommended for chat prefixes)
• LuckPerms (Optional for permission-based prefixes)

Chat System

The plugin features a custom chat format that displays player levels:

• Format: [level⭐] playername: message
• With LuckPerms: [level⭐][prefix] playername: message
• Configuration: Enable/disable LuckPerms prefix via chat.show-luckperms-prefix in config.yml

Requirements for Chat Prefixes

• PlaceholderAPI must be installed
• LuckPerms must be installed and configured
• Set chat.show-luckperms-prefix: true in config.yml (default)

If LuckPerms is detected but PlaceholderAPI is missing, a warning will be logged.

Scoreboard System

The scoreboard supports both internal placeholders and PlaceholderAPI placeholders:

Internal Placeholders

• {player} - Player name
• {mode} - Current game mode (Solo/Duo/Trio/Squad/Lobby)
• {level} - Player level
• {wins} - Player wins
• {losses} - Player losses
• {server_ip} - Server IP from config

PlaceholderAPI Support

Any PlaceholderAPI placeholder can be used in the scoreboard, such as:

• %luckperms_prefix% - LuckPerms prefix
• %player_ping% - Player ping
• %server_tps% - Server TPS
• And many more from various plugins

Reload Command

Use /pof reload to reload the configuration and update all scoreboards in real-time.

Anti-Spam System

The plugin includes an anti-spam system for join commands to prevent double-clicking:

• Cooldown: 3-second cooldown between join attempts
• First Click: Shows "Configurazione mappa in corso, attendere prego..." message
• Spam Prevention: Shows "Hai già richiesto di entrare in una partita! Attendi..." if clicked too quickly
• Auto-Cleanup: Cooldowns are automatically removed when players leave the server

This prevents players from accidentally joining multiple games or spamming the join command.

Support

For issues, suggestions, or contributions, please visit the project repository.