⚔️ The Bridge

A fast, lightweight, and fully customizable Hypixel-style The Bridge mini-game plugin for Minecraft Spigot & Paper servers, supporting versions 1.8 all the way up to 26.2!

---

✨ Features

• 🎮 Multi-Team & Flexible Modes: Supports 2-Team & 4-Team configurations with 1v1, 2v2, 3v3, and 4v4 match sizes.
• 🛠️ In-Game Hotbar & GUI Setup Editor: Easy visual setup using hotbar wands, hologram location markers, and an interactive status dashboard GUI.
• ⚡ Cross-Version Performance: Native cross-version NMS abstractions optimized for legacy 1.8 servers up to modern 26.x.
• 📊 PlaceholderAPI Integration: Built-in placeholders for player statistics, arena statuses, live player counts, and server stats.
• 🎨 Modern Config & Localization: Completely customizable chat messages, scoreboards, action bar notifications, countdown titles, and ASCII-styled configuration files.
• 💾 Dual Storage Options: Local SQLite/YML file storage or MySQL database connectivity for network setups.
• 🛡️ Built-in Protection & Reset: Automatic arena regeneration, void detection, hunger preservation, and building border constraints.

---

---

🚀 Quick Setup Guide

1. Download TheBridge.jar and place it into your server's plugins/ directory.
2. Start or reload your server to generate default configurations.
3. Run /tb create <arena_name> to enter interactive setup mode.
4. Use the hotbar wands to set:
   • 📍 Lobby Spawn
   • 🔴 The First Team Spawn & Goal Portal...
   • 🧱 Build Boundaries
5. Open the Setup Dashboard GUI (Slot 8) to verify all markers display green.
6. Click Save & Exit (Slot 9) and your arena is ready for players!

⚠️ Only set one side of the game, the other teams will be setup automatically as the game is symmetrical!

---

📜 Commands & Permissions

Command	Permission	Description
/tb play	TheBridge.play	Opens the GUI match selector menu.
/tb join <game>	TheBridge.play	Joins a specific game arena directly.
/tb leave	TheBridge.play	Leaves your current match or lobby.
/tb list	TheBridge.admin	Displays all configured arenas with live status & player counts.
/tb create <game>	TheBridge.admin	Creates a new arena and launches the interactive setup editor.
/tb edit <game>	TheBridge.admin	Opens the hotbar editor and GUI status dashboard for an arena.
/tb remove <game>	TheBridge.admin	Stops match, removes arena from memory, and deletes its config file.
/tb reload	TheBridge.admin	Reloads all configuration settings.

---

🧩 PlaceholderAPI Support

Integrate stats into scoreboards, TAB lists, holographic displays, or server hubs using %thebridge_*% placeholders:

Player Statistics

• %thebridge_player_kills% - Total player kills
• %thebridge_player_wins% - Total player victories
• %thebridge_player_scores% / %thebridge_player_goals% - Total goals scored

Arena & Server Status

• %thebridge_total_players% - Count of players currently playing across all arenas
• %thebridge_total_games% - Total number of configured arenas
• %thebridge_arena_status_<arena>% - Live state of <arena> (WAITING, PLAYING, ENDING)
• %thebridge_arena_players_<arena>% - Current player count in <arena>
• %thebridge_arena_max_players_<arena>% - Maximum player capacity in <arena>

---