LiteBansBridge

Preview

🌐 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

- BungeeGuard Compatible: 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: - Staff Portal `(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: - Status Badges: Built with a modern dark theme using TailwindCSS. - Status Badges: Instantly search through punishments by Player Name, Reason, or IP Address without reloading the page. - Status Badges: Easily switch between Bans and Kicks with smooth animations. - Status Badges: 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

- In-Game Commands: 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. In-Game Commands - In-Game Commands: 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: - 🌍 Secure Staff Portal: http://<your-server-ip>:8888/ - 🛡️ Secure Staff Portal: http://<your-server-ip>:8888/staff > (Staff members will be asked to enter the `pi-key` from your config the first time they visit the Staff Portal).

🎨 not Unlike traditional web bridges that require complicated Apache or Nginx setups, LiteBansBridge serves the HTML directly from your plugin folder! 1. Go to `plugins/LiteBansBridge/` on your server. 2. You will see two files: `index.html` (Public) and `staff.html` (Staff). 3. Open either file in a text editor (like Notepad++ or VSCode). 4. You can edit the text, change the background colors, or replace the logo URLs. 5. Save the file. 6. not. The changes will appear instantly! You do not need to restart the server or run any reload commands when editing the HTML files.

⚙️ Commands & Permissions

- Description: `/lbbridge` - Description: `lbbridge.admin` - Description: Displays the current operating Port and the secret API Key. Useful for quickly checking the Staff Portal password in-game. - Description: `/lbbridge reload` - Description: `lbbridge.admin` - Description: Reloads the `config.yml`. Instantly restarts the internal web server if the port was changed.

## ``Made with ❤️ by Bellanoo and Ly_No``