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

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

# 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

/pillar status    # View current game status
/pillar help      # Show available commands

Moderator Commands

/pillar start     # Start a new game

Admin Commands

/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

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

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

Winner Rewards

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

Performance Settings

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

---

🔒 Safety Features

Crash Prevention

• Thread-Safe Operations: Prevents ConcurrentModificationException
• Memory Management: Automatic cleanup prevents leaks
• Player Validation: Comprehensive null checks and validation

Grief Protection

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

Admin Controls

• Emergency Stop: Force end games in crisis situations
• Player Teleportation: 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

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

Game Management

• Monitor Games: Use /pillar status to track active games
• Emergency Controls: Keep admins with pillar.force permission online
• Configuration Tuning: Adjust pillar spacing for different map sizes

Community Guidelines

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

---

🐛 Troubleshooting

Common Issues

• Game won't start: Check minimum player requirements
• Players stuck: Use /pillar force for emergency cleanup
• Memory issues: Ensure proper Java heap allocation
• Permission errors: Verify permission plugin configuration

Debug Information

• Status Command: Use /pillar status for game state information
• Console Logs: Check server console for error messages
• Configuration: Validate config.yml syntax

Support

• Plugin Version: Check version in plugin.yml
• Server Version: 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

• Performance First: Optimized for large player counts
• Safety Focused: Comprehensive crash and grief prevention
• User Experience: Intuitive commands and clear feedback
• Extensibility: Ready for future enhancements and integrations

Future Roadmap

• Team Modes: 2v2 and team-based gameplay
• Custom Maps: Support for custom pillar layouts
• Spectator Mode: 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!