预览

? LiteBansBridge Version 2.0
即时网页界面,用于 LiteBans。瞬间将你的 BungeeCord 代理以及 Bukkit、Paper、Purpur 服务器转变为 LiteBans 网页主机。
? 通用跨平台支持
- 一 Jar 通吃:单个
.jar 文件可在多种服务器架构上完美运行。
- 支持的平台:* Bukkit
- Spigot
- Paper
- Purpur
- BungeeCord
- Waterfall
- 兼容 BungeeGuard:通过运行其内置的 HTTP 服务器,Web 桥接完全绕过了 BungeeGuard 代理防火墙,确保即使在高度安全保护的后台服务器上也能正常工作。
? 双网站系统
插件现在在同一端口上同时托管两个完全独立的 Web 界面,分别针对不同受众:
- 公共网站
(http://your-ip:PORT/):
- 无需登录或身份验证。
- 允许普通玩家查看服务器的封禁和踢出记录。
- 简约、安全且注重隐私的展示方式。
- 员工门户
(http://your-ip:PORT/staff):
- 由 API Key 保护:需要输入秘密认证密钥才能访问。
- 本地记住员工的登录状态,无需每次输入密钥。
- 显示敏感的服务器信息(玩家 IP 地址、上次所在服务器位置)。
? 现代响应式网页设计
两个网站均拥有全面 overhaul 的视觉惊艳 UI:
- 时尚深色模式:使用 TailwindCSS 构建的现代深色主题。
- 实时搜索与筛选:无需重新加载页面即可通过玩家名称、原因或 IP 地址即时搜索处罚记录。
- 标签页界面:通过平滑动画轻松在“封禁”和“踢出”之间切换。
- 动态玩家头像:自动获取被处罚玩家和执行处罚的员工玩家的 3D Minecraft 头颅。
- 状态徽章:清晰的颜色编码徽章,指示封禁状态为
Active(生效中)、Expired(已过期)或 Unbanned(已解除)。
⚡ 实时重载与自定义
- 即时 HTML 更新:
index.html 和 staff.html 文件会提取到 plugins/LiteBansBridge/ 文件夹中。你可以直接编辑这些文件(更改标志、颜色、文本),只需刷新浏览器即可看到更改。无需重启服务器!
- 自定义端口:在
config.yml 中将 Web 服务器端口(默认 8888)更改为任何可用端口。
- 游戏内命令:使用
/lbbridge reload 即时重载配置文件、应用新端口或动态生成新的 API 密钥。
? 直接 LiteBans 数据库挂钩
- 无需复杂的 MySQL Web 设置(如 Apache 或 Nginx)。
- 使用原生的
LiteBansAPI 直接挂钩到由 LiteBans 配置的数据库。
- 自动将 Unix 时间戳格式化为可读的日期和到期时间。
- 安全地格式化 SQL 查询以防止注入攻击。
? 安装指南
LiteBansBridge V2 旨在成为即插即用的解决方案。无论你是运行单个 Paper 服务器还是庞大的 BungeeCord 网络,安装过程都是一样的!
步骤 1:下载并放入
- 下载最新的
LiteBansBridge-2.0.jar。
- 将
.jar 文件放入服务器的 plugins/ 文件夹中。
- 如果使用代理:将其放入 BungeeCord/Waterfall 的
plugins 文件夹。
- 如果使用后端服务器:将其放入 Bukkit/Paper/Purpur 的
plugins 文件夹。
- 重启服务器以生成配置文件。
步骤 2:配置 config.yml
首次重启后,导航至 plugins/LiteBansBridge/config.yml。文件内容如下所示:
# ========================================== #
# LiteBansBridge Settings #
# Version: 2.0 #
# ========================================== #
# 你希望网站运行的端口。
port: 8888
# 用于 STAFF 网站的秘密 API 密钥。
# 如果留空,插件将自动生成一个。
api-key: "lb_generated_key_here"
- 端口设置:默认情况下,网站托管在端口
8888 上。你可以将其更改为任何未使用的端口(例如 8080、1234)。
- API Key 设置:插件会自动为你生成一个安全的 API 密钥。如果你愿意,可以将其更改为自定义密码。切勿将此密钥分享给普通玩家!
- 保存文件并在控制台或游戏中运行
/lbbridge reload 以应用更改。
步骤 3:端口转发(至关重要!)
为了让家庭网络或托管机器之外的玩家看到网站,你必须打开你在 config.yml 中设置的端口。
- 如果你的端口是
8888,则必须在路由器或托管提供商的防火墙仪表板上对 TCP 端口 8888 进行端口转发。
步骤 4:访问网站
一旦服务器运行且端口已打开,你可以在任何网络浏览器中输入服务器的数字 IP 地址(或连接的域名)来访问这两个 Web 门户:
(员工首次访问员工门户时,将被要求输入配置文件中的 api-key。)
? 自定义网站
与传统需要复杂 Apache 或 Nginx 设置的 Web 桥接不同,LiteBansBridge 直接从你的插件文件夹提供 HTML!
- 前往服务器上的
plugins/LiteBansBridge/。
- 你会看到两个文件:
index.html(公共)和 staff.html(员工)。
- 在文本编辑器(如 Notepad++ 或 VSCode)中打开任一文件。
- 你可以编辑文本、更改背景颜色或替换标志 URL。
- 保存文件。
- 刷新浏览器中的页面。更改将立即出现!编辑 HTML 文件时,你不需要重启服务器或运行任何重载命令。
⚙️ 指令与权限
- 指令:
/lbbridge
- 权限:
lbbridge.admin
- 描述: 显示当前运行的端口和 API 密钥。方便在游戏内快速查看管理门户的密码。
- 指令:
/lbbridge reload
- 权限:
lbbridge.admin
- 描述: 重新加载
config.yml。如果端口已更改,将立即重启内部 Web 服务器。
由 Chéngzé 和 Ly_No 用 ❤️ 制作
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
- Download the latest
LiteBansBridge-2.0.jar.
- 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.
- 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"
- Port Setup: By default, the websites are hosted on port
8888. You can change this to any unused port (e.g., 8080, 1234).
- 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!
- 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:
- ?️ Secure Staff Portal:
(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!
- Go to
plugins/LiteBansBridge/ on your server.
- You will see two files:
index.html (Public) and staff.html (Staff).
- Open either file in a text editor (like Notepad++ or VSCode).
- You can edit the text, change the background colors, or replace the logo URLs.
- Save the file.
- 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧