⚔️ 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_streak and highest_streak data metrics synced locally to a structured data.db footprint.
• 📊 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 /eco configurations 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)