OGDuels

<h1> OGDuels | Ultimate 1v1 &amp; Killstreak System</h1> <p><strong>OGDuels</strong> 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.</p> <hr /> <h2> Core Features</h2> <ul> <li><strong> Zero-Lag Matchmaking Pipeline:</strong> Asynchronous thread orchestration manages player states, queuing pools, and tournament data without blocking your server's main tick loop.</li> <li><strong> Automated Inventory &amp; State Syncing:</strong> Clears, caches, and rolls back precise inventories, status profiles, and survival game modes instantly upon arena transitions.</li> <li><strong> Immersive Countdown Engine:</strong> 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 (<code>BLOCK_NOTE_BLOCK_CHIME</code>) before releasing combat with an explosive climax.</li> <li><strong> Dynamic SQLite Persistent Storage:</strong> Complete native tracking of <code>current_streak</code> and <code>highest_streak</code> data metrics synced locally to a structured <code>data.db</code> footprint.</li> <li><strong> Native PlaceholderAPI Interfacing:</strong> Exposes real-time data expansions (<code>%killstreak_current%</code>, <code>%killstreak_max%</code>) alongside dynamic top-tier positioning caches out-of-the-box.</li> <li><strong> Dedicated Lobby Protection:</strong> Built-in world-bound listeners completely negate incoming PvP and structural fall damage vectors within designated hub spaces.</li> </ul> <hr /> <h2> Configuration &amp; Customization</h2> <p>OGDuels splits its core management tools into independent files for easy scaling:</p> <ul> <li><strong><code>config.yml</code>:</strong> Global lobby dimensions, world coordinate registries, and framework tracking properties.</li> <li><strong><code>guis.yml</code>:</strong> Fine-tune interface hierarchies, layouts, and selection screen parameters.</li> <li><strong><code>streak.yml</code>:</strong> Set customizable milestones that trigger global chat broadcasts or run automated console rewards (e.g., executing <code>/eco</code> configurations or distributing dynamic item sets) when players hit certain killstreaks.</li> </ul> <hr /> <h2> Placeholder Expressions</h2> <table> <thead> <tr> <th>Placeholder</th> <th>Outputs</th> </tr> </thead> <tbody> <tr> <td><code>%killstreak_current%</code></td> <td>Returns the player's current active combat match streak.</td> </tr> <tr> <td><code>%killstreak_max%</code></td> <td>Returns the player's lifetime record-breaking peak streak.</td> </tr> <tr> <td><code>%ogduels_highest_position%</code></td> <td>Returns numerical ranking position layout or <code>Unranked</code>.</td> </tr> </tbody> </table> <hr /> <h2> Dependencies &amp; Requirements</h2> <ul> <li><strong>Platform Engine:</strong> PaperMC or Spigot (Targeting 1.21+)</li> <li><strong>Required Dependencies:</strong> None (Self-contained)</li> <li><strong>Optional Hooks:</strong> PlaceholderAPI (For custom scoreboard and tab integration)</li> </ul>