## Preview
\n
\n# \ud83c\udf10 **LiteBansBridge Version 2.0**<\/p>\n
Instant Web Interface for LiteBans Turn your BungeeCord Proxy and Bukkit, Paper, Purpur into a LiteBans Web Host instantly.<\/p>\n
## \ud83c\udf0d **Universal Cross-Platform Support**
\n– **One Jar Fits All**: A single `.jar` file works flawlessly across multiple server architectures.
\n– Supported Platforms: * Bukkit
\n – Spigot
\n – Paper
\n – Purpur
\n – BungeeCord
\n – Waterfall
\n– **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.<\/p>\n
## \ud83c\udf10 **Dual-Website System**
\nThe plugin now hosts two completely separate web interfaces simultaneously on the same port, tailored for different audiences:
\n– **Public Website** `(http:\/\/your-ip:PORT\/)`:
\n – No login or authentication required.
\n – Allows normal players to view the ban and kick history of the server.
\n – Minimalist, safe, and privacy-friendly display.
\n– **Staff Portal** `(http:\/\/your-ip:PORT\/staff)`:
\n – Secured by API Key: Requires the secret authentication key to access.
\n – Remembers staff logins locally so they don’t have to type the key every time.
\n – Displays sensitive server information (Player IP Addresses, Last Server Location).<\/p>\n
## \ud83c\udfa8 **Modern, Responsive Web Design**
\nBoth websites feature a completely overhauled, visually stunning UI:
\n– **Sleek Dark Mode**: Built with a modern dark theme using TailwindCSS.
\n– **Live Search & Filtering**: Instantly search through punishments by Player Name, Reason, or IP Address without reloading the page.
\n– **Tabbed Interface**: Easily switch between Bans and Kicks with smooth animations.
\n– **Dynamic Player Avatars**: Automatically fetches 3D Minecraft heads for both the punished player and the punishing staff member.
\n– **Status Badges**: Clear, color-coded badges to indicate if a ban is `Active`, `Expired`, or `Unbanned`.<\/p>\n
## \u26a1 **Live-Reloading & Customization**
\n– **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!**
\n– **Custom Port**: Change the web server port (default `8888`) to any available port in the `config.yml`.
\n– **In-Game Commands**: Use `\/lbbridge reload` to instantly reload the configuration file, apply new ports, or generate new API keys on the fly.
\n## \ud83d\udd0c **Direct LiteBans Database Hook**
\n– Bypasses the need for complex MySQL web setups (like Apache or Nginx).
\n– Uses the native `LiteBansAPI` to hook directly into the database already configured by LiteBans.
\n– Automatically formats Unix timestamps into readable Dates and Expiration times.
\n– Securely formats SQL queries to prevent injection.<\/p>\n
## \ud83d\udce5 **Installation Guide**
\nLiteBansBridge 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!<\/p>\n
### **Step 1: Download & Drop**
\n1. Download the latest `LiteBansBridge-2.0.jar`.
\n2. Place the `.jar` file into the `plugins\/` folder of your server.
\n – If using a Proxy: Drop it into your BungeeCord\/Waterfall `plugins` folder.
\n – If using a Backend Server: Drop it into your Bukkit\/Paper\/Purpur `plugins` folder.
\n3. Restart your server to generate the configuration files.<\/p>\n
### **Step 2: Configuration `config.yml`**
\nAfter the first restart, navigate to plugins\/LiteBansBridge\/config.yml. The file will look like this:
\n“`yml
\n# ========================================== #
\n# LiteBansBridge Settings #
\n# Version: 2.0 #
\n# ========================================== #<\/p>\n
# The port you want the website to run on.
\nport: 8888<\/p>\n
# The secret API key used for the STAFF website.
\n# If left blank, the plugin will generate one automatically.
\napi-key: “lb_generated_key_here”
\n“`
\n1. Port Setup: By default, the websites are hosted on port `8888`. You can change this to any unused port `(e.g., 8080, 1234)`.
\n2. 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!
\n3. Save the file and run \/lbbridge reload in the console or in-game to apply the changes.
\n### **Step 3: Port Forwarding (Crucial!)**
\nFor players outside of your home network or hosting machine to see the website, you **MUST** open the port you set in `config.yml`.
\n– If your port is `8888`, you must TCP port-forward `8888` on your router or your hosting provider’s firewall dashboard.<\/p>\n
### **Step 4: Accessing the Websites** \ud83c\udfa8 **Customizing the Websites** ### **\u2699\ufe0f Commands & Permissions** ## Instant Web Interface for LiteBans Turn your BungeeCord Proxy and Bukkit, Paper, Purpur into a LiteBans Web Host instantly.<\/p>\n","protected":false},"featured_media":94504,"template":"","meta":{"_minecraft_slug":"litebansbridge","_minecraft_project_id":"zGYJG6Zh","_minecraft_author":"Bellanoo","_minecraft_license":"MIT","_minecraft_downloads":717,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"litebansbridge.zip","_minecraft_size_bytes":64960,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T09:36:27.523381Z","_minecraft_date_created":"2026-02-15T06:26:02.691054Z","_minecraft_date_modified":"2026-03-01T04:52:16.332341Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/litebansbridge","_minecraft_icon_attachment_id":94504,"_minecraft_imported_at":"2026-06-05T09:49:38+00:00","_minecraft_import_hash":"7c698642dcc0f0abeab10072f13cc116","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,894,127,128,129,123],"mod_loader":[130,895,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-94503","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-bungeecord","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_loader-bukkit","mod_loader-bungeecord","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n
\nOnce 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:
\n– \ud83c\udf0d **Public Player Website**: http:\/\/
\n– \ud83d\udee1\ufe0f **Secure Staff Portal**: http:\/\/
\n> _(Staff members will be asked to enter the `pi-key` from your config the first time they visit the Staff Portal)._<\/p>\n
\nUnlike traditional web bridges that require complicated Apache or Nginx setups, LiteBansBridge serves the HTML directly from your plugin folder!
\n1. Go to `plugins\/LiteBansBridge\/` on your server.
\n2. You will see two files: `index.html` (Public) and `staff.html` (Staff).
\n3. Open either file in a text editor (like Notepad++ or VSCode).
\n4. You can edit the text, change the background colors, or replace the logo URLs.
\n5. Save the file.
\n6. **Refresh the page in your browser**. The changes will appear instantly! You do **not** need to restart the server or run any reload commands when editing the HTML files.<\/p>\n
\n– **Command**: `\/lbbridge`
\n– **Permission**: `lbbridge.admin`
\n– **Description**: Displays the current operating Port and the secret API Key. Useful for quickly checking the Staff Portal password in-game.
\n– **Command**: `\/lbbridge reload`
\n– **Permission**: `lbbridge.admin`
\n– **Description**: Reloads the `config.yml`. Instantly restarts the internal web server if the port was changed.<\/p>\n
\n“Made with \u2764\ufe0f by Bellanoo and Ly_No“<\/p>\n","protected":false},"excerpt":{"rendered":"