<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> <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/xA4VG_r4XY0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>