L-duel

THIS PLUGIN IS IN BETA PHASE!

A comprehensive duel plugin for Minecraft servers running version 1.21.1 with 1.21.x support.

Features

Multi-Language Support

- English 🇬🇧 - Turkish 🇹🇷 - Configurable language selection in `config.yml`

Data Storage

- Local file-based storage - MySQL database support (coming soon) - Player statistics tracking: - Total duels - Wins - Losses - Win ratio - Leaderboard rankings

Duel System

- GUI menu system (`/duel`) - Direct player challenges (`/duel <playername>`) - Queue-based matchmaking - Player vs player combat - Customizable arenas - Draw command for mutual agreement (`/draw`) - Configurable duel timeout (default 5 minutes) - Automatic victory when opponent leaves during duel - Configurable command restrictions with permission bypass - Restricted movement and interactions during duel preparation - Opponent info display in action bar before duels (name and win percentage) - Enhanced item collection period (winner can drop items, open inventory, and collect items)

Arena Management

- Admin commands for arena creation/deletion - Interactive Duel Wand for arena selection - Individual spawn point configuration - Arena validation before activation - Automatic arena reset after duels - BedWars-style boundary restrictions (players can only build/break within arena bounds)

Item System

- Players duel with their own inventories - Losing player's items drop on the ground - Winner can collect dropped items for a limited time - Clear messaging about item collection period and teleportation - Automatic teleportation of both players to spawn after duels - Complete arena restoration after duels (placed blocks removed, broken blocks restored)

Admin Features

- Enhanced arena management with interactive wand selection - Player spectating - Arena watching capabilities - Force stop duels - Detailed statistics - Replay system for watching past duels - Configurable replay recording (can be enabled/disabled in config) - Dedicated admin commands and permissions

Commands

Player Commands

- `/duel` - Open duel menu - `/duel <playername>` - Send a duel request to a specific player - `/duel accept` - Accept a duel request - `/duel deny` - Deny a duel request - `/duel stats [player]` - View duel statistics - `/duel help` - Show help page - `/draw` - Request a draw in an active duel (both players must use to agree)

Admin Commands

- `/duel admin arena create <name>` - Create a new temporary arena (requires Duel Wand selection) - `/duel admin arena setspawn1 <name>` - Set spawn point 1 for a temporary arena - `/duel admin arena setspawn2 <name>` - Set spawn point 2 for a temporary arena - `/duel admin arena save <name>` - Save and activate a temporary arena - `/duel admin arena delete <name>` - Delete an arena - `/duel admin arena list` - List all arenas - `/duel admin arena watch <arena>` - Watch an active arena - `/duel admin spectate <player>` - Spectate a player's duel - `/duel admin watch <arena>` - Watch an active arena (alternative) - `/duel admin forcestop <arena>` - Forcefully stop a duel - `/duel admin reload` - Reload configuration and language files - `/duel admin setspawn` - Set the global spawn point for players after duels - `/duel admin replay list` - List all available duel replays - `/duel admin replay watch <replayId>` - Watch a saved duel replay - `/duel admin replay delete <replayId>` - Delete a saved duel replay

Duel Wand Commands

- `/duelwand` or `/duelw` - Get the Duel Wand for arena selection - Left-click to select position #1 - Right-click to select position #2

Permissions

- `duel.use` - Use basic duel commands (default: true) - `duel.admin` - Access admin commands (default: op) - `duel.draw` - Use the /draw command (default: true) - `duel.bypass.command` - Bypass command restrictions during duels (default: op)

Configuration

The plugin can be configured through `config.yml`:

```

Language Settings

language: en # Available: en (English), tr (Turkish)

Storage Settings

storage-type: file # file or mysql

MySQL Configuration (only used if storage-type is mysql)

mysql: host: localhost port: 3306 database: duel_plugin username: root password: password table-prefix: dp_

Duel Settings

duel: item-collection-time: 10 # Time in seconds that winner can collect items cooldown: 30 # Cooldown between duels in seconds max-duration: 5 # Maximum duel duration in minutes (0 for no timeout) allowed-commands: # Commands allowed during duels (empty list allows all) - msg - tell - w - whisper - draw

Replay settings

replay: enabled: true # Enable or disable replay recording

Arena Settings

arena:

Spawn point for players after duel (set via admin command)

Use /duel admin setspawn to set the spawn point

```

Installation

1. Download the plugin JAR file 2. Place it in your server's `plugins` folder 3. Restart your server 4. Configure the plugin in `plugins/L-duel/config.yml` 5. Use `/duelwand` to get the arena selection tool 6. Set the global spawn point using `/duel admin setspawn` 7. Create temporary arenas using `/duel admin arena create <name>` 8. Set spawn points using `/duel admin arena setspawn1 <name>` and `/duel admin arena setspawn2 <name>` 9. Save and activate arenas using `/duel admin arena save <name>` 10. Reload configuration with `/duel admin reload` after making changes

PlaceholderAPI Support

The plugin supports PlaceholderAPI with the following placeholders: - `%duel_total_duels%` - Total duels played - `%duel_wins%` - Total wins - `%duel_losses%` - Total losses - `%duel_win_ratio%` - Win ratio percentage - `%duel_rank_wins%` - Player's rank by wins (numeric) - `%duel_rank_wins_formatted%` - Player's rank by wins (#1, #2, etc.) - `%duel_top_winner%` - Player with the most wins - `%duel_top_loser%` - Player with the most losses - `%duel_top_winner_1%` to `%duel_top_winner_10%` - Players ranked 1st to 10th by wins

SUPPORT

discord: squezsaz