OnSiteDuels
The arena is wherever the players are standing.
NO SEPARATE ARENA WORLDS
Players challenge someone nearby, review a complete duel contract, and fight directly inside your configured spawn district.A terrain-fitted visual fence marks the combat boundary without permanently placing, removing, or changing any real blocks.
COMPETITIVE SYSTEMS
- Ranked and casual matches
- Persistent Elo ratings
- Wins, losses, and win streaks
- Clickable leaderboards
- Detailed player profiles
- Repeated-opponent anti-farming protection
- Best-of-1, best-of-3, and best-of-5 contracts
CONTRACTS, KITS & WAGERS
- GUI-based duel contract builder
- Recipient review and confirmation screen
- Kit catalogue with complete inventory previews
- Armor and equipment previews
- In-game kit creation and editing
- Protected kit removal confirmations
- Item-based wagers
- Optional Vault economy wagers
- Crash-recoverable escrow storage
- Safe overflow item delivery
SERVER EVENTS
- Randomized single-elimination tournaments
- Automatic bracket creation
- Automatic bracket byes
- Automatic match progression
- GUI event setup wizard
- Captain selection system
- Captain-led crew recruitment
- Simultaneous team battles
- Vault money rewards
- Item rewards
- Console-command rewards
BUILT FOR PUBLIC SERVERS
- SQLite database persistence
- WAL mode with non-blocking writes
- Configurable world restrictions
- Configurable spawn-radius restrictions
- Protected-spawn duel damage handling
- Inventory restoration
- Health and hunger restoration
- Experience restoration
- Position and game-mode restoration
- Staff duel cancellation tools
- Elo management and profile resets
- Escrow recovery tools
- Paper and Spigot support
- Compatible from Minecraft 1.8.8 through current releases
INSTALLATION
- Stop your Minecraft server.
- Place OnSiteDuels-4.1.1.jar inside the server's plugins folder.
- Start the server once to generate the required files.
- Configure the allowed worlds and maximum distance from world spawn.
- Configure your kits, wager limits, event rewards, and protection settings.
- Restart the server.
- Test duels and events on a staging server before launching publicly.
GENERATED FILES
- plugins/OnSiteDuels/config.yml
- plugins/OnSiteDuels/duels.db
- plugins/OnSiteDuels/escrow.yml
BACKUP NOTICE
Always back up duels.db and escrow.yml together to preserve player statistics and pending escrow deliveries.PLAYER COMMANDS
/duel player
Opens the duel contract builder for a nearby player./duel accept [player]
Accepts a pending duel challenge./duel deny
Declines a pending duel challenge./duel kit [name]
Browses available kits or previews a specific kit./duel leave
Forfeits the current duel or leaves spectator mode./duel rematch
Challenges your previous opponent to another match./duel spectate player
Watches a player currently participating in a duel./duel stats [player]
Opens your duel profile or another player's profile./duel top
Opens the ranked leaderboard./duel toggle
Enables or disables incoming duel requests.EVENT COMMANDS
/duel event start event-name
Opens the administrator event setup wizard./duel event join
Joins an open tournament being hosted at spawn./duel event invite player
Invites a player to join the captain's crew./duel event accept
Accepts a pending crew invitation./duel event begin
Launches the configured server event./duel event status
Displays information about the active event./duel event cancel
Safely cancels the current event.ADMINISTRATOR COMMANDS
/duel kit create name
Creates a kit using the administrator's current inventory and armor./duel kit edit name
Opens an existing kit for in-game editing./duel kit remove name
Opens a protected confirmation screen before removing a kit./duel admin cancel player
Safely cancels a player's active duel./duel admin setelo player rating
Sets a player's Elo rating./duel admin reset player
Resets a player's duel statistics and profile./duel admin claim player
Attempts to deliver any pending escrow items belonging to a player./duel reload
Reloads the plugin configuration.PERMISSIONS
onsiteduels.use
Default: EveryoneAllows access to standard player duel commands.
onsiteduels.ranked
Default: EveryoneAllows players to create ranked duel contracts.
onsiteduels.wager
Default: EveryoneAllows players to create contracts containing wagers.
onsiteduels.admin
Default: Server operatorsAllows access to kit management, ratings, escrow recovery, duel administration, and server events.
onsiteduels.reload
Default: Server operatorsAllows administrators to reload the plugin configuration.
PLACEHOLDERAPI SUPPORT
The following placeholders are available when PlaceholderAPI is installed:- %onsiteduels_elo%
- %onsiteduels_wins%
- %onsiteduels_losses%
- %onsiteduels_streak%
EVENT REWARDS
TOURNAMENT EVENTS
The configured reward is paid once to the final tournament champion.TEAM EVENTS
The configured reward is paid individually to every member of the victorious crew.SUPPORTED REWARD TYPES
- Vault economy money
- ItemStack rewards
- Console commands
- Player-specific commands using {player}
- Event-specific commands using {event}
FREQUENTLY ASKED QUESTIONS
Does OnSiteDuels require separate arena maps?
No. Duels and server events take place directly inside the configured spawn district.Does the visual fence modify the map?
No. The combat boundary is displayed visually to participating clients. Any temporary visuals are restored when combat ends.Are player inventories protected?
Yes. When state restoration is enabled, the player's complete pre-combat state is saved and restored after the duel.This can include:
- Inventory contents
- Equipped armor
- Health
- Hunger
- Experience
- Location
- Game mode
