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

• 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:

# ========================================== #
#          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://:8888/
• 🛡️ Secure Staff Portal: http://:8888/staff

(Staff members will be asked to enter the pi-key from your config the first time they visit the Staff Portal).

🎨 Customizing the Websites 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. 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.

⚙️ Commands & Permissions

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

Made with ❤️ by Chéngzé and Ly_No