━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Bring the ultimate duel system to your Minecraft server! 1vs1 by Dyroxplays offers a highly professional, fully automatic duel system, similar to GommeHD.net. Players can challenge each other, join queues, and compete in direct 1-on-1 matches across an unlimited number of arenas.
With an interactive map selection, a flexible kit system, a live stats wall, and full MySQL synchronization, this plugin is the perfect duel system for your server network!
⚔️ The most professional 1vs1 duel system for your Minecraft server – fully automatic, performance-optimized, and absolutely flicker-free!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

WHY 1VS1? THE ADVANTAGES IN DETAIL:

» Queue System (Queue): Players can easily join the queue via a GUI or by clicking an item. The system automatically matches two players and teleports them to an available arena.
» Automatic, Unlimited Arena System: Save server resources and time! The plugin dynamically instantiates and clones the configured worlds. This means: Even if you have only set up a single arena, 100 or more matches can take place on it simultaneously and independently without any issues! After the match, the instance is automatically cleaned up (World-Reset).
» Challenge with Map Selection: Players can challenge other players directly. A GUI menu opens where the desired kit and even the specific battle arena can be selected.
» Detailed Kit Creation: Set up up to 9 different hotbar kits (e.g., Soup, SG, UHC) easily in-game. Arrange your inventory, equip armor, and save the kit using /1vs1 saveKit <0-8>. You can create up to 9 hotbar kits that are displayed in the corresponding hotbar slots of players in the lobby.
» Live Statistics & Top Wall: MySQL database connection stores all wins, losses, kills, and deaths. Create a stats wall with player heads and signs that represents the top 10 players live on your server.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

KEY FEATURES AT A GLANCE:

» Challenge via Left-Click/Hit: Challenge a player by left-clicking them with a kit item in hand. Accepting is just as easy: Either via the interactive chat button or by having the challenged player hit the challenger in the lobby with the same kit item.
» Health Display Above Name: See exactly how many hearts your opponent has left during the fight (can be disabled in the config).
» Flicker-Free Scoreboard: A dynamic scoreboard displays all important data during the match (e.g., opponent name, ping, remaining hearts).
   * Note: The integrated scoreboard only works on version 1.8.x (packets). For newer Minecraft versions, we recommend using our plugin ScoreboardPlus.
» Spectator Mode: Players can watch ongoing duels and move freely around the map without disturbing the fight.
» PlaceholderAPI Support: Integrate statistics such as wins, losses, or kills into your server scoreboard, TabList, or chat prefixes.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

COMMANDS

» /1vs1 setLobby - Sets the spawn and lobby point for players
» /1vs1 setspawnpos <1/2> - Sets the spawn points for players in an arena (arena name corresponds to the world name)
» /1vs1 worldTP - Allows administrators to teleport to the save worlds for setup purposes
» /1vs1 saveKit <0-8> - Saves your current inventory as a kit (number determines the hotbar slot in the lobby)
» /1vs1 settopwall <1-10> - Sets the top 10 stats wall on the targeted sign / head
» /quit - Allows players to forfeit an ongoing match (counted as a loss)
» /stats (<Player>) - Retrieves 1vs1 player statistics

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

PERMISSIONS

» 1vs1.admin - Full access to all administrative commands and setup

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

SETUP GUIDE & SCHRITT-FÜR-SCHRITT SETUP:
IMPORTANT: For the setup to work, setup: true must be set in the config!

1. Put the plugin on your server.
2. Join the server and set the lobby using /1vs1 setLobby (You need OP or the permission: 1vs1.admin, since the server is still in setup mode).
3. Create a wall with a player head at the top and an empty sign at the bottom. Look at the player head and set the Top 10 wall using /1vs1 settopwall <1-10>.
4. Stop the server.
5. Go to the folder /plugins/1vs1/saves and place your maps inside.
6. Open the config and enter your MySQL database credentials.
7. Start the server and join it.
8. All worlds from the saves folder should now be loaded (as long as setup: true is in the config).
9. Teleport to the worlds using /1vs1 worldTP.
10. Set the spawn points for this arena using /1vs1 setspawnpos <1/2> (The arena name corresponds to the world name).
11. Stop the server and adjust any remaining configuration (e.g., messages) if needed.
12. Go to the config and set setup: false -> This ensures only up to 9 random arenas are loaded and the game is playable for everyone.
13. Start the server and you're good to go!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

IN-GAME KIT CREATION & SETUP:

1. Arrange your inventory exactly as you want the kit to be (enchantments, armor, etc.).
2. Save your inventory as a kit using: /1vs1 saveKit <0-8> -> 0-8 are the slots where the kit item will appear in the lobby inventory (0 is the first slot and 8 is the last slot!).
3. Open /plugins/1vs1/kits.yml. There you will find your saved slot (e.g., '0'). Modify the display item (displayItem) as desired.
   Format: MATERIALNAME:SHORTID:DISPLAYNAME (e.g., STONE_SWORD:0:&7Starter Kit – from 1.13 onwards, the ShortID is always 0).
4. Save kits.yml and restart the server (a reload is possible, but a restart is recommended!).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

SETUP & SYSTEM INFO:

● Update Guarantee: Fully compatible from version 1.8.8 up to the latest Minecraft version!
● Scoreboard Note: The integrated scoreboard is optimized for version 1.8.x. For newer versions, we recommend ScoreboardPlus.
● Database: MySQL is required for storing and synchronizing statistics.