Obsidian Outbreak

📖About Obsidian Outbreak

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

Download the plugin JAR file
Place it in your server's plugins folder
Restart your server
Configure arenas using /arena commands
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!