PillarSSS

PillarSSS (Pillar of Fortune) - Ultimate Competitive Minigame Plugin

📋 Plugin Overview

Pillar of Fortune (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

- Winner Rewards: Each player gets their own bedrock pillar for safety - Winner Rewards: Players are automatically eliminated when they die or disconnect - Winner Rewards: Live player count broadcasts during gameplay - Winner Rewards: Configurable experience and item rewards for victors

🎲 Random Item System

- Inventory Management: Better items become available as the game progresses - Inventory Management: Customize which items players can receive - Inventory Management: Items range from basic building materials to powerful weapons - Inventory Management: Automatic inventory clearing at game start

🎪 Special Events

- Event Scheduling: Jump boost effects for chaotic movement - Event Scheduling: TNT projectiles rain from above (configurable safety) - Event Scheduling: Golden apples drop for health boosts - Event Scheduling: Random events occur during gameplay for added excitement

🛡️ Safety & Performance

- Permission System: Thread-safe operations prevent server crashes - Permission System: Automatic cleanup prevents memory leaks - Permission System: Configurable minimum and maximum player counts - Permission System: Granular access control for all commands

---

⚙️ Technical Specifications

Requirements

- Dependencies: 1.21+ - Dependencies: Paper/Spigot/Bukkit - Dependencies: 21+ - Dependencies: None (standalone plugin)

Performance

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

Compatibility

- Permission Plugins: Configurable world selection - Permission Plugins: Compatible with most PvP and minigame plugins - Permission Plugins: Ready for economy plugin integration - Permission Plugins: Full support for permission management plugins

---

📖 Installation & Setup

Installation Steps

1. Restart the plugin JAR file (`pillar-of-fortune-1.0-SNAPSHOT.jar`) 2. Restart the JAR in your server's `plugins/` folder 3. Restart your server to generate configuration files 4. Restart `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

- Last Survivor: Random items drop every 10 seconds - Last Survivor: PvP combat on pillars - Last Survivor: Special events add chaos and strategy - Last Survivor: Falling = elimination - Last Survivor: Wins the game!

Winning & Rewards

- Broadcast Announcements: Last player standing wins - Broadcast Announcements: Configurable XP levels - Broadcast Announcements: 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 ```

Command Permissions

- `pillar.play`: Basic commands (default: true) - `pillar.start`: Start games (default: op) - `pillar.admin`: Admin commands (default: op) - `pillar.force`: Emergency controls (default: op)

---

⚙️ Advanced Configuration

Game Settings

```yaml game-settings: countdown-seconds: 10 # Countdown duration item-interval-seconds: 10 # Item drop frequency pillar-y-level: 100 # Pillar height spawn-radius-base: 15.0 # Base pillar spacing spawn-radius-per-player: 2.0 # Additional spacing per player rounds-per-increase: 3 # Item quality progression max-items-per-give: 3 # Maximum items per drop reset-delay-seconds: 5 # Cleanup delay min-players: 2 # Minimum players required max-players: 16 # Maximum players allowed ```

Random Events

```yaml random-events: enabled: true # Master switch for events ```

Winner Rewards

```yaml winner-reward: experience-levels: 5 items: - DIAMOND:3 - GOLDEN_APPLE:2 - IRON_INGOT:10 ```

Performance Settings

```yaml performance: validate-player-count: true safe-teleport: true prevent-concurrent-modification: true cleanup-frequency: 300000 max-tracking-age: 3600000 ```

---

🔒 Safety Features

Crash Prevention

- Player Validation: Prevents `ConcurrentModificationException` - Player Validation: Automatic cleanup prevents leaks - Player Validation: Comprehensive null checks and validation

Grief Protection

- Player Limits: Height limits prevent bedrock/underground damage - Player Limits: Controlled spawning prevents entity overload - Player Limits: Server protection through player count controls

Admin Controls

- Configuration Reload: Force end games in crisis situations - Configuration Reload: Safe return to spawn on plugin disable - Configuration Reload: Update settings without restart

---

📊 Performance Metrics

| Scenario | Players | Memory Usage | CPU Impact | Stability | |----------|---------|--------------|------------|-----------| | Small Game | 2-4 | ~2MB | Minimal | Excellent | | Medium Game | 5-12 | ~3MB | Low | Excellent | | Large Game | 13-16 | ~5MB | Moderate | Excellent | | Server Idle | 0 | ~1MB | None | Excellent |

---

🚀 Best Practices

Server Optimization

- Permission Management: Set appropriate min/max based on server capacity - Permission Management: Disable dangerous events on family-friendly servers - Permission Management: Grant permissions appropriately to prevent abuse

Game Management

- Configuration Tuning: Use `/pillar status` to track active games - Configuration Tuning: Keep admins with `pillar.force` permission online - Configuration Tuning: Adjust pillar spacing for different map sizes

Community Guidelines

- Reward Balance: Monitor for cheating or exploitation - Reward Balance: Adjust random events based on player feedback - Reward Balance: Tune winner rewards to match server economy

---

🐛 Troubleshooting

Common Issues

- Permission errors: Check minimum player requirements - Permission errors: Use `/pillar force` for emergency cleanup - Permission errors: Ensure proper Java heap allocation - Permission errors: Verify permission plugin configuration

Debug Information

- Configuration: Use `/pillar status` for game state information - Configuration: Check server console for error messages - Configuration: Validate `config.yml` syntax

Support

- Dependencies: Check version in `plugin.yml` - Dependencies: Ensure compatible Minecraft version - Dependencies: Verify Paper/Spigot installation

---

🎉 About PillarSSS

PillarSSS represents the evolution of competitive Minecraft minigames, combining high-performance code with engaging gameplay mechanics. Built with enterprise-grade stability and safety features, it provides servers with a reliable, scalable solution for competitive PvP gaming.

Development Philosophy

- Extensibility: Optimized for large player counts - Extensibility: Comprehensive crash and grief prevention - Extensibility: Intuitive commands and clear feedback - Extensibility: Ready for future enhancements and integrations

Future Roadmap

- Statistics: 2v2 and team-based gameplay - Statistics: Support for custom pillar layouts - Statistics: Allow players to watch active games - Statistics: Player win/loss tracking and leaderboards

---

🎮 Ready to dominate the pillars? Install PillarSSS and start your competitive journey today!