SpaceDuel

[!(https://i.imgur.com/g8Ob1Go.png)](https://ko-fi.com/klaidi4)

# ⚔️ SpaceDuel SpaceDuel is a powerful add-on for SpacePvP that introduces a comprehensive 1vs1 dueling system. Allow your players to challenge each other using a GUI or commands, with support for both Arena and Random Location battles.

✨ Feature List ✨

✅ Direct Challenges — Challenge any player via command or a customizable GUI. ✅ Two Game Modes — Support for Arena (pre-built) and Random Location (wild) duels. ✅ Interactive Chat — Fully clickable JSON chat messages (`` / ``) for instant interaction. ✅ Smart GUI — Supports Custom Skulls (via `basehead-`), PlaceholderAPI, and permission-based locking. ✅ Smart Skipping — Automatically skips the menu if the player only has permission for one mode. ✅ Full Match Control — Separate settings for duels: enable/disable Regeneration, configure Kits, inventory clearing, and Potion Effects. ✅ Safety Checks — Prevents invites if the target is busy, in a queue, or if no arenas are available. ✅ Integration — Works seamlessly with SpacePvP systems (stats, cooldowns, combat checks). ✅ Support for colors in HEX, Legacy (&), and MiniMessage formats.

✨ Command Reference ✨

✨ Permissions ✨

Main Permissions: `spaceduel.command.duel` — Allows access to the main `/duel` command. `spaceduel.command.reload` — Allows reloading the configuration.

Game Mode Permissions: `spaceduel.type.arena` — Allows sending invites for Arena duels. `spaceduel.type.default` — Allows sending invites for Random Location duels.

✨ Configuration Highlights ✨

Game Settings: SpaceDuel allows you to override default SpacePvP settings specifically for duels: Regeneration: Enable/Disable arena regeneration after the fight (saves resources for simple duels). Effects: Apply custom potion effects (e.g., Speed II, Glowing) when the duel starts. Kits: Force specific kits or use the default one. Delays: Configure teleport delays after the match ends.

Menu Customization: You can use custom textures for heads in the GUI without any texture pack! Example in `menu.yml`: ``` material: "basehead-eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUv..." ```

``` ✨ Dependencies ✨

Required: SpacePvP (Core plugin system) v4. 4

Soft Dependencies (Optional): PlaceholderAPI — For displaying stats and names in the GUI/Messages. * LuckPerms — For displaying prefixes and ranks in chat invites.

📥 Installation

1. Install SpacePvP and ensure it is running correctly. 2. Download SpaceDuel. 3. Place the .jar file in your server's plugins folder. 4. Restart the server. 5. Configure `settings.yml`, `messages.yml`, and `menu.yml` to your liking! ```