⚔️ 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)

ItzJatinOG

OG Plugins