PillarSSS

# PillarSSS (Pillar of Fortune) - Ultimate Competitive Minigame Plugin

## 📋 Plugin Overview

PillarSSS (also known as Pillar of Fortune) is a high-performance, competitive minigame plugin designed for Minecraft servers running Paper/Spigot. Players compete in fast-paced battles on floating pillars, collecting random items and eliminating opponents through PvP combat or environmental hazards.

### 🎯 Core Concept Players are teleported to individual bedrock pillars scattered across the game area. The goal is simple: be the last player standing. Through random item drops, special events, and PvP combat, players must strategically eliminate their opponents while avoiding falling into the void.

## 🌟 Key Features

### ⚔️ Competitive Gameplay - Individual Pillar Spawning: Each player gets their own bedrock pillar for safety - Dynamic Player Elimination: Players are automatically eliminated when they die or disconnect - Real-time Leaderboard: Live player count broadcasts during gameplay - Winner Rewards: Configurable experience and item rewards for victors

### 🎲 Random Item System - Progressive Item Distribution: Better items become available as the game progresses - Configurable Item Pools: Customize which items players can receive - Balanced Gameplay: Items range from basic building materials to powerful weapons - Inventory Management: Automatic inventory clearing at game start

### 🎪 Special Events - Moon Gravity: Jump boost effects for chaotic movement - Meteor Shower: TNT projectiles rain from above (configurable safety) - Golden Rain: Golden apples drop for health boosts - Event Scheduling: Random events occur during gameplay for added excitement

### 🛡️ Safety & Performance - Crash Prevention: Thread-safe operations prevent server crashes - Memory Management: Automatic cleanup prevents memory leaks - Player Limits: Configurable minimum and maximum player counts - Permission System: Granular access control for all commands

## ⚙️ Technical Specifications

### Requirements - Minecraft Version: 1. 21+ - Server Software: Paper/Spigot/Bukkit - Java Version: 21+ - Dependencies: None (standalone plugin)

### Performance - Memory Usage: Minimal (~2-5MB with 16 players) - CPU Usage: Optimized for 16+ concurrent players - Thread Safety: Fully thread-safe operations - Memory Leaks: Zero memory leak design

### Compatibility - Multi-world Support: Configurable world selection - Plugin Conflicts: Compatible with most PvP and minigame plugins - Economy Integration: Ready for economy plugin integration - Permission Plugins: Full support for permission management plugins

## 📖 Installation & Setup

### Installation Steps 1. Download the plugin JAR file (`pillar-of-fortune-1. 0-SNAPSHOT.jar`) 2. Place the JAR in your server's `plugins/` folder 3. Restart your server to generate configuration files 4. Configure `config.yml` to your server needs 5. Restart again or use `/pillar reload` for config changes

### Basic Configuration ```yaml game-settings: min-players: 2 # Minimum players to start max-players: 16 # Maximum players allowed pillar-y-level: 100 # Height of pillars item-interval-seconds: 10 # Item drop frequency

random-events: enabled: true # Enable/disable special events

random-items: - DIRT:16 # Building materials - IRON_SWORD:1 # Combat items - GOLDEN_APPLE:1 # Health items ```

### Permission Setup ```yaml # Basic permissions (grant to all players) pillar.play: true

# Game management (grant to moderators) pillar.start: true

# Administrative access (grant to admins) pillar.admin: true pillar.force: true ```

## 🎮 Gameplay Guide

### Starting a Game 1. Ensure 2+ players are online (configurable minimum) 2. Use `/pillar start` command (requires permission) 3. Wait for countdown (default 10 seconds) 4. Game begins automatically!

### During Gameplay - Collect Items: Random items drop every 10 seconds - Fight Players: PvP combat on pillars - Avoid Events: Special events add chaos and strategy - Stay on Pillar: Falling = elimination - Last Survivor: Wins the game!

### Winning & Rewards - Automatic Detection: Last player standing wins - Experience Rewards: Configurable XP levels - Item Rewards: Customizable victory items - Broadcast Announcements: Server-wide victory messages

## 🔧 Command Reference

### Player Commands ```bash /pillar status # View current game status /pillar help # Show available commands ```

### Moderator Commands ```bash /pillar start # Start a new game ```

### Admin Commands ```bash /pillar stop # Emergency game stop /pillar force # Force stop current game /pillar reload # Reload configuration `