SpaceDuel

⚔️ 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 ([Accept] / [Deny]) for instant interaction.
✅ Smart GUI — Supports Custom Skulls (via basehead-<texture>), 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 ✨

⚔️ Duel Commands (Click to expand)

• /duel <player> — Open the duel selection GUI for a specific player.
• /duel <player> arena — Send a quick invite for an Arena duel.
• /duel <player> default — Send a quick invite for a Random Location duel.
• /duel accept — Accept the last received invite.
• /duel deny — Deny the last received invite.
• /duel reload — Reload the plugin configuration.

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