PRODUCTION READY – Advanced multi-world SkyWars plugin with complete automation
CookieSkyWars is a powerful, fully automated SkyWars plugin with extensive customization options, designed to deliver a modern and dynamic gaming experience. Perfect for production servers, testing environments, and competitive gameplay.

Current Status

• Fully Production Ready – Extensively tested and optimized for live servers
• Multi-player Compatible – Supports unlimited concurrent games across multiple maps
• Advanced Game Management – Complete automation from lobby to game end
• Professional Grade – Enterprise-level features with robust error handling

⭐ Core Features
Multiple Game Modes
Complete support for all major SkyWars variants through clean, intuitive GUI menus:

• Solo SkyWars – Classic 1v1v1v1 gameplay
• Doubles SkyWars – Team-based 2v2v2v2 and more action
• Normal Mode – Balanced gameplay with standard loot
• Insane Mode – High-intensity matches with enhanced loot tables
• Mega SkyWars – Large-scale battles with extended gameplay
• Mini SkyWars – Quick matches for fast-paced action
• Ranked Mode – Competitive gameplay with skill-based matchmaking
• Duels Mode – Direct 1v1 confrontations

Intelligent Automation System

• Smart Arena Assignment – Automatic player placement on available arenas with no waiting
• Dynamic Map Loading – Automatic world loading and unloading based on demand
• Intelligent Chest Detection – Automatically identifies and populates the 3 nearest chests at each spawn
• Balanced Loot Distribution – Configurable loot tables with rarity-based item distribution
• Automatic Game Cycling – Seamless transitions between game states

Advanced Player Progression

• Experience System – Gain XP through gameplay, kills, and victories
• Dynamic Leveling – Automatic level progression with customizable XP requirements
• Prestige System – Unlock exclusive symbols and emblems as you advance
• Comprehensive Statistics – Track solo/team kills, wins, coins, souls, and tokens
• Reward Distribution – Automatic currency and XP rewards based on performance

Extensive Cosmetics System

• Prestige Icons – 16+ unique symbols including runes, stars, and special characters
• Cage Variations – Multiple spawn cage designs with glass color customization
• SOON Kill Effects – Dynamic visual effects triggered on eliminations
• SOON Victory Dances – Celebratory animations for match winners
• SOON Death Cries – Customizable elimination messages
• SOON Projectile Trails – Visual effects for arrows and projectiles
• SOON Balloons & Sprays – Additional cosmetic elements for personalization

️ Advanced Map Management
Interactive map selection system with detailed information:

• Map Browser – Visual interface showing map name, player count, and availability
• Favorite Maps – Players can bookmark preferred maps for quick access
• Map Statistics – Track join counts and popularity metrics
• Load Balancing – Automatic distribution across available map instances
• Custom Map Support – Easy integration of community-created maps

Quest & Challenge System
Comprehensive quest system powered by Quest Master NPCs:

• Daily Quests – Fresh challenges reset every 24 hours
• Weekly Challenges – Longer-term objectives with greater rewards
• Auto-Accept Option – Premium players can automatically accept available quests
• Progress Tracking – Real-time quest completion monitoring
• Reward Distribution – Automatic XP, coins, and token distribution

Smart NPC System
Powered by ProtocolLib for seamless player interaction:

• Custom Skins – NPCs display player skins for authenticity
• Dynamic Holograms – Real-time player count updates above each NPC
• Type-Specific NPCs – Different NPCs for Normal, Insane, Mega, Mini, Duels, and Ranked modes
• Game Mode Detection – NPCs automatically detect and display appropriate game options
• Quest Master Integration – Special villager NPCs for quest management

Complete Map Creation Tools
Comprehensive suite for map development:

• Visual Map Editor – In-game tools for boundary setting and spawn placement
• Automatic Spawn Detection – Uses beacon blocks for precise spawn point placement
• Boundary System – Configurable map boundaries with automatic player containment
• Map Copying – Duplicate existing maps for variations and testing
• Archive Management – Automatic .zip compression for map distribution
• Configuration Templates – Pre-built settings for different game modes

How to Add Maps
The map creation process is streamlined and intuitive:

1. Place Map Files: Copy your world folder to /plugins/CookieSkyWars/maps/ or use .zip archives
2. Load the Map: Execute /csw map load <MapName> to import the world
3. Teleport for Setup: Use /csw map tp <MapName> to enter the world
4. Configure Game Mode: Run /csw map create <Mode> <Type> <MapName>
   • Example: /csw map create solo normal SkyIsland
5. Set Boundaries: Use the provided tools to mark the playable area
6. Place Spawn Points: Position beacon blocks at desired player spawn locations
7. Save Configuration: Use the in-game save tool to finalize all settings

Your map is now ready for automatic matchmaking and manual selection!

⚙️ Complete Automation Features
⏱️ Game Flow Management

• Countdown System – Configurable pre-game timers with dynamic messaging
• Winner Announcement – Automatic victory detection with top 3 killer leaderboard
• Arena Reset – Instant world restoration after each match
• Lobby Return – Automatic player teleportation to lobby with inventory clearing
• Slot Recycling – Efficient reuse of arena positions for optimal performance

Live Information Display

• Dynamic Scoreboards – Real-time game information with customizable layouts
• Player Statistics – Live kill counts, time remaining, and player counts
• Map Information – Current map name, game mode, and match progress
• Leaderboards – Real-time top performers during active matches

❄️ Advanced Game Features

• Anti-Freeze Protection – Prevents post-game lag and player freezing
• Chunk Pre-loading – Ensures smooth gameplay with optimized world loading
• Fall Damage Protection – Temporary invulnerability after game start
• Smart Inventory Management – Automatic kit distribution and item handling

️ User Interface & Commands
GUI Menus
Intuitive graphical interfaces for all player interactions:

• Mode Selection – Choose between different game types and variants
• Map Picker – Visual map browser with detailed information
• Cosmetics Menu – Browse and equip unlocked cosmetic items
• Kit Selection – Choose from available kits based on game mode
• Statistics Display – Comprehensive player performance overview
• Quest Management – Track active quests and claim rewards

Inventory Tools
Essential items for quick navigation:

• Return Bed (Slot 8) – Instant teleportation back to lobby
• Kit Selector (Right-click) – Quick access to kit menu during games
• Compass Integration – NPC interaction for game joining

⌨️ Administrative Commands
The plugin features a comprehensive command system with intelligent tab completion and detailed help menus for every function.

Core Command Structure:

• Main command: /csw with extensive subcategories
• Quick lobby access: /lobby for instant teleportation
• Permission-based access control for all administrative functions
• Interactive help system with detailed usage examples

Map Management Commands:

• /csw map load <MapName> – Load map from file system or .zip archive
• /csw map tp <MapName> – Teleport to specified map for editing
• /csw map goto <MapName> – Navigate to map while preserving previous location
• /csw map back – Return to previously visited map
• /csw map change <MapName> – Enter map editing mode with specialized tools
• /csw map create <solo|doubles> <normal|insane|ranked> <Name> – Register new map configuration
• /csw map copy <source> <destination> – Duplicate existing maps with all settings
• /csw map mode <MapName> <solo|doubles> <normal|insane|ranked> – Modify map type and variant

NPC Management Commands:

• /csw npc create <ID> <normal|insane|mega|mini|duels|ranked|question> – Spawn new game NPC or Quest Master villager
• /csw npc skin <ID> <PlayerName> – Update NPC appearance with player skin (supports async skin fetching)
• /csw npc remove <ID> – Delete existing NPC and cleanup associated holograms

Game Control Commands:

• /csw game status wait – Start countdown timer for current game
• /csw game status start – Force start game immediately (bypasses player requirements)
• /csw game status end – Forcefully terminate current match
• /csw game again – Intelligent game restart (finds similar map and teleports players)

Lobby Management:

• /csw lobby set – Set lobby spawn point at current location (saves coordinates and rotation)
• /csw lobby go – Teleport to configured lobby location
• /lobby – Quick lobby teleport with 3-second delay and cancellation option

Menu Access Commands:

• /csw menu skywars – Open main SkyWars interface
• /csw menu cosmetics – Access cosmetic selection interface
• /csw menu prestige – Open prestige icon selection menu
• /csw menu prestige random – Unlock random prestige symbol

Player Statistics Management:

• /csw stats – Display comprehensive player statistics with formatted output
• /csw stats add EXP <amount> – Award experience points (triggers automatic leveling)
• /csw stats add LVL <amount> – Grant levels directly (calculates required XP automatically)
• /csw stats set EXP <amount> – Override player experience (resets and sets new value)
• /csw stats set LVL <amount> – Set specific player level (recalculates progression)
• /csw stats remove EXP <amount> – Reduce player experience (prevents negative values)
• /csw stats remove LVL <amount> – Lower player level (minimum level 1 protection)

System Maintenance Tools:

• /csw tools cleanstands – Remove orphaned armor stands and holograms (async cleanup with progress reporting)
• /csw tools reload – Refresh plugin configuration without restart (preserves active games and player data)

Advanced Features:

• Smart Tab Completion – Context-aware suggestions for all commands and parameters
• Permission Integration – Granular permission system for each command category
• Error Handling – Comprehensive validation with helpful error messages
• Async Operations – Non-blocking execution for resource-intensive operations
• Progress Reporting – Real-time feedback for long-running operations
• Safety Checks – Prevents data corruption and maintains game integrity

️
️ Active Development Roadmap
Enhanced Cosmetics

• New Cage Designs – Additional spawn cage variations with animated elements
• Victory Effects – Spectacular end-game celebrations and fireworks
• Kill Streak Rewards – Special effects for consecutive eliminations
• Seasonal Cosmetics – Limited-time items for special events

Advanced Statistics & Leaderboards

• Global Leaderboards – Server-wide ranking systems for kills, wins, and experience
• Detailed Analytics – Match history, performance trends, and gameplay insights
• Achievement System – Unlock special rewards for reaching milestones
• Competition Tracking – Seasonal tournaments and special events

Expanded Progression System

• Level Rewards – Unlock cosmetics, perks, and bonuses as you advance
• Prestige Benefits – Additional rewards and recognition for high-level players
• Daily Login Bonuses – Incentivize regular server participation
• Referral Rewards – Benefits for bringing friends to the server

⚔️ Kit & Perk System

• Balanced Kit Selection – Unique loadouts for different playstyles
• Upgradeable Perks – Enhance abilities through gameplay progression
• Mode-Specific Kits – Specialized equipment for different game variants
• Custom Kit Creation – Allow players to design personalized loadouts

Database Integration

• MySQL Support – Persistent player data storage across server restarts
• Cross-Server Compatibility – Shared statistics across multiple server instances
• Backup Systems – Automatic data protection and recovery options
• Performance Optimization – Advanced caching for improved response times

Additional Features

• Daily Quests & Challenges – Fresh objectives to maintain player engagement
• Spectator Mode – Watch ongoing matches with advanced camera controls
• Replay System – Record and review spectacular matches
• Custom Events – Special game modes for holidays and celebrations

⚠️ System Requirements
Minimum Server Specifications:

• Minecraft Version: 1.8.8 - 1.19.4
• Server Software: Spigot, Paper, or Purpur (Paper recommended for optimal performance)
• RAM: 2GB minimum, 4GB+ recommended for multiple concurrent games
• Storage: 1GB available space for maps and player data
• CPU: Multi-core processor recommended for optimal performance

Required Dependencies:

• ProtocolLib – Essential for NPC functionality and advanced packet handling

Configuration & Customization
CookieSkyWars offers extensive customization options through multiple configuration files:

Main Configuration (config.yml):

• Game mode settings and map configurations
• Loot tables and rarity distributions
• Experience and leveling progression rates
• Economy settings and reward multipliers

Scoreboards Configuration (Configs/scoreboards.yml):

• Customizable scoreboard layouts for all game states
• Placeholder support for dynamic information display
• Color and formatting options for visual consistency

Rewards Configuration (SkyWarsSettingConfigs/rewardLvl.yml):

• Level-based reward distribution
• Currency amounts and experience bonuses
• Special milestone rewards and achievements

The plugin maintains backward compatibility while continuously adding new features and improvements. Regular updates ensure optimal performance, bug fixes, and exciting new content for players.

CookieSkyWars represents the pinnacle of automated SkyWars gameplay, combining professional-grade features with intuitive user experience. Whether you're running a small community server or a large network, this plugin provides the tools and flexibility needed to create an exceptional SkyWars experience for your players.