⚔️ OGDuels | Ultimate 1v1 & Killstreak System
OGDuels is a highly optimized, high-performance 1v1 dueling and competitive combat engine built explicitly for modern PaperMC and Spigot networks. Combining lightning-fast SQLite persistence with modular kit structures and professional matchmaking presentation, OGDuels provides a seamless, competitive arena environment for your players.
✨ Core Features
- ⚡ Zero-Lag Matchmaking Pipeline: Asynchronous thread orchestration manages player states, queuing pools, and tournament data without blocking your server's main tick loop.
- 🔒 Automated Inventory & State Syncing: Clears, caches, and rolls back precise inventories, status profiles, and survival game modes instantly upon arena transitions.
- 🔥 Immersive Countdown Engine: A cinematic, hard-coded 5-second match countdown. Locks players securely at their designated spawns (allowing camera head rotation) while cycling high-impact action audio structures (
BLOCK_NOTE_BLOCK_CHIME) before releasing combat with an explosive climax. - 🏆 Dynamic SQLite Persistent Storage: Complete native tracking of
current_streakandhighest_streakdata metrics synced locally to a structureddata.dbfootprint. - 📊 Native PlaceholderAPI Interfacing: Exposes real-time data expansions (
%killstreak_current%,%killstreak_max%) alongside dynamic top-tier positioning caches out-of-the-box. - 🛡️ Dedicated Lobby Protection: Built-in world-bound listeners completely negate incoming PvP and structural fall damage vectors within designated hub spaces.
🛠️ Configuration & Customization
OGDuels splits its core management tools into independent files for easy scaling:
config.yml: Global lobby dimensions, world coordinate registries, and framework tracking properties.guis.yml: Fine-tune interface hierarchies, layouts, and selection screen parameters.streak.yml: Set customizable milestones that trigger global chat broadcasts or run automated console rewards (e.g., executing/ecoconfigurations or distributing dynamic item sets) when players hit certain killstreaks.
📈 Placeholder Expressions
| Placeholder | Outputs |
|---|---|
%killstreak_current% |
Returns the player's current active combat match streak. |
%killstreak_max% |
Returns the player's lifetime record-breaking peak streak. |
%ogduels_highest_position% |
Returns numerical ranking position layout or Unranked. |
⚙️ Dependencies & Requirements
- Platform Engine: PaperMC or Spigot (Targeting 1.21+)
- Required Dependencies: None (Self-contained)
- Optional Hooks: PlaceholderAPI (For custom scoreboard and tab integration)
