BridgeDuels

BridgeDuels
Hypixel-style 1v1 Bridge duels — fully automatic, from join to map reset.

BridgeDuels turns a Paper server into a dedicated 1v1 Bridge arena. Two players join, the duel starts by itself, and when it's over the plugin sends everyone back to your lobby, restores a clean copy of the map and restarts the server for the next pair. No signs, no arenas.yml, no manual resets — you set up the arena once in-game and the server runs duels forever.

Built for the classic single-game BungeeCord server model: one small server per concurrent game, your Bungee lobby/queue sends pairs of players in.



⚔ FEATURES
- Fully automatic games — first two players become Red & Blue, everyone else spectates. Leaving mid-game = forfeit, the opponent wins.
- The real Bridge feeling — team-colored leather kits, unbreakable iron sword, 64 team terracotta, 3-2-1-GO title countdowns, score pauses, no death screens: lethal hits and void falls just reset you to your island with a fresh kit.
- Win holes of any size — score by jumping through the opponent's hole. Holes are box regions spanned by two corners and burn with fire particles the whole game.
- One-click setup GUI — /setup saves spawns, win holes and fall height from where you stand, with live status. Chat commands exist for everything too.
- Automatic clean-map reset — the arena world is snapshotted once; after every game the plugin shuts down, restores the clean map (verified, crash-safe, Windows-safe) and your start script boots it up again.
- Bulletproof arena protection — players can only place/break the bridge terracotta. The map itself is untouchable. No hunger, no mobs, no item drops, no weather, permanent noon.
- BungeeCord integration — after the game everyone is sent to your lobby server via plugin messaging before the restart.
- Beautiful presentation — clean minimal sidebar (Team Red / Team Blue with ★ round scores), gradients, titles and sounds everywhere.

HOW A GAME RUNS
1. Player 1 joins → parked on their island, waiting for an opponent.
2. Player 2 joins → kits, 3-2-1-GO, fight!
3. Bridge across, fight, jump through the opponent's hole to score a round.
4. First to the configured round wins (default 5) takes the game.
5. Victory celebration → everyone to the lobby → server restarts on a fresh map.

QUICK START
1. Drop the JAR into plugins/ and start the server.
2. Join as OP and run /setup — click through the buttons (2 spawns, 2 win holes, map height). The clean-map backup is created automatically when the setup completes.
3. Run the server from a simple restart-loop script (examples in the documentation) so it boots up again after each game.

⚙ REQUIREMENTS
- Paper 26.2 (or newer), Java 25
- A BungeeCord/Waterfall network with a lobby server (recommended — standalone works too, set send-to-lobby: false)
- Something that restarts the server after it stops: a wrapper loop script or your panel's auto-restart (Pterodactyl etc.)

COMMANDS & PERMISSIONS
/setup — one-click setup GUI
/setspawn <1|2> — save a spawn point
/setwinpos <1|2> <pos1|pos2> — save a win hole corner
/setmapheight — save the fall threshold
All admin commands require bridgeduels.admin (default: OP).
/bridgeduelsplugin — plugin info, for everyone.

Full setup guide, config reference, Bungee wiring and troubleshooting: see the Documentation tab.

Coded by ifCode.