<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>

## ⚔️ About OGKillstreaks **OGKillstreaks** is a lightweight, high-performance killstreak and PvP statistics tracking plugin designed for competitive servers. Built on a fully asynchronous SQLite architecture, it ensures zero server thread lag during intense PvP combat. --- ## 🚀 Key Features * **Asynchronous Engine:** Flat-file SQLite data operations are handled off the main server thread to keep your TPS steady. * **Milestone Rewards:** Run custom console commands, trigger particle effects, or play global sounds when players hit specific milestones. * **Kit Refresher:** Automatically restores a portion of health or refreshes a player's inventory combat supplies instantly upon a kill. * **PlaceholderAPI Integration:** Exposes statistics easily to your scoreboards, tablists, and chat formatters. --- ## 📊 Placeholders * `%ogkillstreaks_current%` - Displays the player's active killstreak. * `%ogkillstreaks_highest%` - Displays the player's historical highest streak. * --- ## 🛠️ Configuration The entire plugin is highly configurable, allowing you to customize reward triggers, leaderboard settings, and combat-log penalties out of the box.