DuelsAddon

A modern GUI-focused expansion for the Duels plugin

This addon enhances the Duels plugin by replacing traditional command-based interactions with a modern and intuitive graphical interface. Players can browse online opponents, view ratings and win/loss statistics, and send duel challenges directly through an interactive menu. The Duel GUI supports pagination and filtering, making navigation smooth even on busy servers.

A dedicated kit-selection interface provides access to individual kit leaderboards. Each leaderboard is calculated from separate statistics tracked per kit, allowing players to compare performance accurately based on their preferred duel style.

The addon also integrates seamlessly with PlaceholderAPI using its own placeholder expansion. This allows duel-related information—such as player ratings and win/loss ratios—to be displayed in scoreboards, chat formats, and any other plugin that supports PlaceholderAPI. All menu text and messages are fully customizable through the included language file, making localization and stylistic changes simple.

Commands

/duelgui
Opens the main Duel GUI, allowing players to select and challenge opponents.

/duelleaderboard
Opens the kit-selection menu and displays the selected leaderboard.

/duelsaddon reload
Reloads the addon’s configuration and language files.

PlaceholderAPI Placeholders

All placeholders use data from every player stored in the playerdata directory. If a placeholder requests a rank higher than the number of players available, it returns null.

%duels_rating_<place>%
Shows the rating of the player at the specified leaderboard position.
Example: %duels_rating_1% displays the top player's rating.

%duels_name_<place>%
Shows the name of the player at the specified leaderboard position.
Example: %duels_name_1% displays the top player's name.

%duels_wlr_<place>%
Shows the win/loss ratio of the player at the specified leaderboard position.
Example: %duels_wlr_1% displays the top player's W/L ratio.

%duels_wlr%
Shows the win/loss ratio of the player using the placeholder.

Configuration

The configuration file includes detailed documentation for every placeholder and is structured for future expansion. All language entries can be modified in eng.yml to match your server’s style or language.

If you'd like, I can also prepare:

• A Polymart “Features” section
• A marketing-style short description for the sidebar
• Headers, banners, or screenshot captions
• A premium-style Polymart resource layout