SighWeb
一款面向 Paper / Folia Minecraft 服务器的基于 Web 的白名单申请与管理插件。
概览
SighWeb 内嵌了一个轻量级 HTTP 服务器,提供精美的单页应用(SPA)仪表盘。玩家通过浏览器提交白名单申请;管理员可以审核、批准或拒绝这些申请——所有操作均自动同步至你的服务器。
功能特性
- Web 应用门户 — 玩家可通过响应式 SPA 进行注册、申请并跟踪状态
- 管理仪表盘 — 审核申请、管理白名单与黑名单、查看操作日志
- 自动同步 — 批准的申请自动添加至服务器白名单,并可选发送游戏内通知
- 安全加固 — BCrypt 密码哈希、会话超时机制、API 速率限制、支持 CORS
- 多语言支持 — 内置中文与英文,可随时切换
- 主题切换 — 深色/浅色模式
- 兼容 Paper 与 Folia — 开箱即用,同时适用于两个平台
命令
/sighweb — 查看信息、重载配置、检查状态、同步白名单
/sighweb sync — 手动将白名单同步至服务器
/sighweb status — 显示插件统计信息
/sighweb reload — 热重载配置
/sighweb-admin addwl <player> — 将玩家加入白名单
/sighweb-admin removewl <player> — 从白名单移除
/sighweb-admin addbl <player> [reason] — 将玩家加入黑名单
/sighweb-admin removebl <player> — 从黑名单移除
权限: sighweb.admin(默认:OP) · sighweb.apply(默认:所有玩家)
安装
- 将
SighWeb.jar 放入 plugins/ 目录
- 重启服务器
- 在
http://<server-ip>:25555 访问 Web UI
- 通过 Web UI 注册首个管理员(或在
config.yml 中设置凭据)
要求: Paper 1.20.X 1.21.X 26.1.X 26.2 / Folia 1.20.X 1.21.X 26.1.X 26.2 · JDK 17+
配置
plugins/SighWeb/config.yml 中的关键设置:
| 设置项 |
默认值 |
描述 |
web.host |
0.0.0.0 |
绑定地址(0.0.0.0 = 所有接口) |
web.port |
25555 |
Web 服务器端口 |
data.storage-format |
json |
json 或 sqlite |
security.rate-limiting |
true |
API 请求速率限制 |
whitelist.auto-sync |
true |
批准/拒绝时自动同步至服务器 |
whitelist.notify-on-add |
true |
加入白名单时发送游戏内通知 |
SighWeb
A web-based whitelist application and management plugin for Paper / Folia Minecraft servers.
Overview
SighWeb embeds a lightweight HTTP server that provides a polished SPA dashboard. Players submit whitelist applications through their browser; admins review, approve, or reject them — all synced automatically to your server.
Features
- Web Application Portal — Players register, apply, and track status via a responsive SPA
- Admin Dashboard — Review applications, manage whitelists & blacklists, view operation logs
- Auto Sync — Approved applications automatically added to server whitelist with optional in-game notification
- Secure — BCrypt password hashing, session timeout, API rate limiting, CORS support
- Multilingual — Built-in Chinese & English, switchable at any time
- Theme Toggle — Dark / light mode
- Paper & Folia compatible — Works on both platforms out of the box
Commands
/sighweb — View info, reload config, check status, sync whitelist
/sighweb sync — Manually sync whitelist to server
/sighweb status — Show plugin statistics
/sighweb reload — Hot-reload configuration
/sighweb-admin addwl <player> — Add player to whitelist
/sighweb-admin removewl <player> — Remove from whitelist
/sighweb-admin addbl <player> [reason] — Add to blacklist
/sighweb-admin removebl <player> — Remove from blacklist
Permissions: sighweb.admin (default: OP) · sighweb.apply (default: all players)
Installation
- Place
SighWeb.jar into plugins/
- Restart the server
- Access the Web UI at
http://<server-ip>:25555
- Register your first admin via the Web UI (or set credentials in
config.yml)
Requirements: Paper 1.20.X 1.21.X 26.1.X 26.2 / Folia 1.20.X 1.21.X 26.1.X 26.2 · JDK 17+
Configuration
Key settings in plugins/SighWeb/config.yml:
| Setting |
Default |
Description |
web.host |
0.0.0.0 |
Bind address (0.0.0.0 = all interfaces) |
web.port |
25555 |
Web server port |
data.storage-format |
json |
json or sqlite |
security.rate-limiting |
true |
API request rate limiting |
whitelist.auto-sync |
true |
Auto-sync to server on approve/reject |
whitelist.notify-on-add |
true |
In-game notification on whitelist add |
评论 0
登录后参与评分
还没有评论,来抢沙发吧