LiteBansBridge

## Preview !(https://cdn.modrinth.com/data/cached_images/1627445ad1e3025289d7f6ed5b708fb0327c6f84.png) # 🌐 **LiteBansBridge Version 2.0** Instant Web Interface for LiteBans Turn your BungeeCord Proxy and Bukkit, Paper, Purpur into a LiteBans Web Host instantly. ## 🌍 **Universal Cross-Platform Support** - **One Jar Fits All**: A single `.jar` file works flawlessly across multiple server architectures. - Supported Platforms: * Bukkit - Spigot - Paper - Purpur - BungeeCord - Waterfall - **BungeeGuard Compatible**: By running its own internal HTTP server, the web bridge entirely bypasses BungeeGuard proxy firewalls, ensuring it always works even on highly secured backend servers. ## 🌐 **Dual-Website System** The plugin now hosts two completely separate web interfaces simultaneously on the same port, tailored for different audiences: - **Public Website** `(http://your-ip:PORT/)`: - No login or authentication required. - Allows normal players to view the ban and kick history of the server. - Minimalist, safe, and privacy-friendly display. - **Staff Portal** `(http://your-ip:PORT/staff)`: - Secured by API Key: Requires the secret authentication key to access. - Remembers staff logins locally so they don't have to type the key every time. - Displays sensitive server information (Player IP Addresses, Last Server Location). ## 🎨 **Modern, Responsive Web Design** Both websites feature a completely overhauled, visually stunning UI: - **Sleek Dark Mode**: Built with a modern dark theme using TailwindCSS. - **Live Search & Filtering**: Instantly search through punishments by Player Name, Reason, or IP Address without reloading the page. - **Tabbed Interface**: Easily switch between Bans and Kicks with smooth animations. - **Dynamic Player Avatars**: Automatically fetches 3D Minecraft heads for both the punished player and the punishing staff member. - **Status Badges**: Clear, color-coded badges to indicate if a ban is `Active`, `Expired`, or `Unbanned`. ## ⚡ **Live-Reloading & Customization** - **Instant HTML Updates**: The `index.html` and `staff.html` files are extracted to your `plugins/LiteBansBridge/` folder. You can edit these files directly (change logos, colors, text) and simply refresh your browser to see the changes. **No server restart required!** - **Custom Port**: Change the web server port (default `8888`) to any available port in the `config.yml`. - **In-Game Commands**: Use `/lbbridge reload` to instantly reload the configuration file, apply new ports, or generate new API keys on the fly. ## 🔌 **Direct LiteBans Database Hook** - Bypasses the need for complex MySQL web setups (like Apache or Nginx). - Uses the native `LiteBansAPI` to hook directly into the database already configured by LiteBans. - Automatically formats Unix timestamps into readable Dates and Expiration times. - Securely formats SQL queries to prevent injection. ## 📥 **Installation Guide** LiteBansBridge V2 is designed to be a "Drop-In & Play" solution. Whether you are running a single Paper server or a massive BungeeCord network, the installation is identical! ### **Step 1: Download & Drop** 1. Download the latest `LiteBansBridge-2.0.jar`. 2. Place the `.jar` file into the `plugins/` folder of your server. - If using a Proxy: Drop it into your BungeeCord/Waterfall `plugins` folder. - If using a Backend Server: Drop it into your Bukkit/Paper/Purpur `plugins` folder. 3. Restart your server to generate the configuration files. ### **Step 2: Configuration `config.yml`** After the first restart, navigate to plugins/LiteBansBridge/config.yml. The file will look like this: ```yml # ========================================== # # LiteBansBridge Settings # # Version: 2.0 # # ========================================== # # The port you want the website to run on. port: 8888 # The secret API key used for the STAFF website. # If left blank, the plugin will generate one automatically. api-key: "lb_generated_key_here" ``` 1. Port Setup: By default, the websites are hosted on port `8888`. You can change this to any unused port `(e.g., 8080, 1234)`. 2. API Key Setup: The plugin automatically generates a secure API key for you. You can change this to a custom password if you prefer. Do not share this key with regular players! 3. Save the file and run /lbbridge reload in the console or in-game to apply the changes. ### **Step 3: Port Forwarding (Crucial!)** For players outside of your home network or hosting machine to see the website, you **MUST** open the port you set in `config.yml`. - If your port is `8888`, you must TCP port-forward `8888` on your router or your hosting provider's firewall dashboard. ### **Step 4: Accessing the Websites** Once the server is running and the port is open, you can access the two web portals by typing your server's numerical IP Address (or connected domain) into any web browser: - 🌍 **Public Player Website**: http:/