ObsidianOutbreak

Survive endless waves of enemies with weapon progression, dynamic shops, combo systems, and team modes.

Features

🎮 Game Modes

• Solo - Face the waves alone
• Duo - Team up with a partner
• Squad - Survive with up to 4 players

⚔️ Combat System

• Progressive weapon tiers with multiple categories
• Combo multiplier system for skilled players
• Hearts/lives system with respawn mechanics
• Dynamic difficulty scaling

🛒 Shop System

• Weapons - Upgrade your arsenal mid-game
• Food - Restore health and gain buffs
• Potions - Speed, strength, and regeneration
• Utilities - Ender pearls and tactical items

📊 Progression

• Score-based economy
• Player statistics tracking
• Session and lifetime stats
• Combo rewards for consecutive kills

🏟️ Arena Management

• Multiple arenas with customizable spawn points
• Lobby system with intuitive GUI
• Grace periods between waves
• Automated wave scaling

Commands

Player Commands

• /ob menu - Open the lobby menu
• /ob join <arena> - Join an arena directly
• /ob leave - Leave current arena
• /ob stats - View your statistics
• /ob shop - Open the shop (in-game only)

Admin Commands

• /arena create <name> - Create a new arena
• /arena delete <name> - Delete an arena
• /arena setspawn <name> - Set arena spawn point
• /arena setlobby <name> - Set lobby spawn point
• /arena addmobspawn <name> - Add mob spawn location
• /arena start <name> - Force start an arena
• /arena stop <name> - Stop an arena
• /arena list - List all arenas

Permissions

• outbreak.admin - Access to arena management (default: op)
• outbreak.play - Ability to join and play (default: true)

Installation

1. Download the plugin JAR file
2. Place it in your server's plugins folder
3. Restart your server
4. Configure arenas using /arena commands
5. Players can join via /ob menu

Requirements

• Server Software: Paper 1.21+ (or compatible fork)
• Java Version: 17 or higher

Support

Join our Discord or open an issue on GitHub for support and bug reports.

---

Note: This is an alpha release. Features may change and bugs may exist. Please report any issues you encounter!