UDFFA — Duels & FFA Practice Plugin

UDFFA is a lightweight, customizable Minecraft practice plugin created by UDStudios for competitive Duels and Free-for-All gameplay.

It supports Paper servers running Minecraft 1.21 and newer, Java 21, and is designed with simple setup and configuration in mind.

Main Features

• Custom Duels system
• Custom FFA system
• Kit-based matchmaking
• Random arena selection
• Kit-specific arena assignment
• Multiple arenas per kit
• Arena regeneration after matches
• Large arena support
• Automatic dropped-item cleanup
• Arena boundary protection
• Five-second match-found preview
• Opponent name shown before teleporting
• Five-second pre-match countdown
• Countdown movement lock
• Match-start BEGIN title
• Configurable duel sounds
• Winner and loser result screens
• Spectator mode during result screens
• Automatic return to lobby
• Safe cleanup when players disconnect
• /leave duel and /leave ffa

Kit System

• Create kits from your inventory
• Edit existing kits
• Delete kits
• Exact inventory copying
• Separate FFA and Duel kits
• FFA kit creation and editing
• Copy Duel kits into FFA kits
• Assign kits to specific FFA modes
• Assign kits to specific Duel arenas
• Assign one kit to multiple arenas
• Personal player kit editor
• Personal slot layouts
• Custom kit icons
• Custom kit names
• GUI confirmation buttons

Duel Features

• Player-to-player duel requests
• /duel <player> <kit>
• Accept and deny duel requests
• Queue-based matchmaking
• Queue leave button
• Red dye queue exit item
• Queue status action bar
• Queue timer
• Match-found title
• Opponent display
• Kit-specific arena restrictions
• Full arena detection
• Automatic arena restoration
• Players cannot escape configured arena regions

FFA Features

• Dedicated FFA modes
• Dedicated FFA arenas
• Instant joining
• FFA kit menus
• Automatic kit restocking after kills
• Respawn handling
• Inventory clearing after leaving
• Automatic cleanup after death
• Dedicated FFA spawn locations

Combat

• Vanilla Minecraft melee damage
• Vanilla crystal damage
• Vanilla respawn-anchor damage
• Vanilla explosion behavior
• No global custom damage overrides
• Crystal and anchor combat supported
• Normal knockback behavior

Scoreboard and UI

• Separate scoreboard.yml configuration
• Fully customizable duel scoreboard
• RGB color support using &#RRGGBB
• Hidden scoreboard score numbers
• Custom titles and lines
• Player and opponent information
• Ping display
• Match timer
• Kit and arena display
• Win statistics display

ELO and Tier System

• Persistent ELO system
• New players start at 0 Elo
• New players begin as Unranked
• First completed match promotes players to LT5
• Configurable Elo thresholds
• Configurable tier names
• Configurable tier multipliers
• HT1, LT1, HT2, LT2, HT3, LT3, HT4, LT4, HT5, and LT5 defaults
• Internal tier management
• LuckPerms is not required for tier progression
• Persistent wins, kills, deaths, and matches
• ELO administration command
• Configurable quick-win and standard-win rewards

Killstreaks

• Killstreaks begin at five kills
• Milestones continue every five kills
• Supports streaks up to 1000
• Killstreak broadcast messages
• Killstreak loss messages
• Highest killstreak tracking

PlaceholderAPI Support

Includes placeholders for:

• Current killstreak
• Highest killstreak
• ELO
• Tier
• Position
• Leaderboard position
• Kills
• Deaths
• Wins
• Total wins
• Player name
• Opponent name
• Duel kit
• Duel arena
• Queueing players
• Fighting players
• Top 10 Elo leaderboard entries

Example leaderboard placeholders:

%udffa_topelo_1%
%udffa_topelo_2%
%udffa_topelo_3%

Configuration

UDFFA includes separate configuration files for:

• General plugin settings
• Duel and FFA menus
• Sounds
• Scoreboard
• ELO and tiers
• Player ELO data
• Kits
• Debug testing

Debug Testing

• Configurable debug mode
• /spawntestnpc <name> <kit>
• Damageable stationary test dummy
• Knockback configuration
• Attack damage configuration
• Max health configuration
• Kit equipment support
• Automatic removal after death

Dependencies

• Paper 1.21+
• Java 21
• PlaceholderAPI is optional
• WorldGuard and WorldEdit are not required
• FAWE is not required for arena regeneration

Author

UDStudios