我制作 ByteBans 是因为我希望惩罚措施能在我的多个服务器间生效,同时又不牺牲快捷指令和实用的 Tab 补全功能。它使用 SQLite 或 MySQL 数据库来存储封禁、静音、踢出、警告、员工备注、冻结以及历史记录。你可以针对单个指定名称的服务器、一组服务器或整个网络进行配置。
开始使用
将适用于受支持的 Paper 或 Purpur 版本的 JAR 文件放入 plugins/ 目录并启动服务器。全新安装默认使用本地 SQLite 数据库,因此你无需先设置 MySQL。请在 plugins/ByteBans/config.yml 中为每个服务器设置不同的 server.name。如果你希望跨服务器共享惩罚记录,请将它们指向同一个 MySQL 数据库。在升级前请备份现有数据库。
指令使用 key:value 形式的参数,并在输入时自动建议键名、玩家名称、作用域(scope)以及已知的记录 ID。例如:
/tempban user:Steve time:1d reason:Griefing scope:*
/ipmute user:Steve time:1h reason:Spam
/history user:Steve page:1
/freeze user:Steve reason:Investigation
IP 封禁和 IP 静音可能会影响同一网络下的其他用户。它们使用的是你的服务器所看到的地址,因此在依赖这些功能前,请先在代理服务器上配置真实 IP 转发。仅授予你信任的员工 IP 管理权限。玩家必须先加入服务器,才能通过名称解析其身份。
可选集成
Discord 通知和本地管理页面默认关闭。如果你启用了 Discord 通知并填写了自己的 Webhook URL,ByteBans 会将管理操作及原因发送到该 Discord 频道。IP 惩罚记录可包含 IP 地址。除非单独启用,否则员工备注不会包含在内。请保持 Webhook 及其频道的私密性。
管理页面允许员工搜索历史记录并执行管理操作。它监听 127.0.0.1,需要其生成的访问令牌;请使用本地浏览器或通过 SSH 隧道访问。切勿将其端口直接暴露在互联网上。有关设置、指令、权限和升级详情,请参阅 README。
新的 1.1.0 测试版为经过测试的十四个 Paper 和 Purpur 版本以及没有对应 Purpur 构建的 Paper 26.1.1 提供了独立的兼容性条目。仅含 Paper 的文件与主文件包含相同的类和资源;区别仅在于 JAR 清单不同。两个文件均通过了所列出的实时检查。早期 1.0.0 版本保留其原有的兼容性标签;此更新未在 Bukkit 或 Spigot 上验证。
ByteBuilders Hosting 是项目作者的联盟链接。
I made ByteBans because I wanted punishments to work across my servers without giving up quick commands and useful tab completion. It keeps bans, mutes, kicks, warnings, staff notes, freezes, and history in SQLite or MySQL. You can target one named server, a set of servers, or the whole network.
Getting started
Put the JAR for a supported Paper or Purpur version in plugins/ and start the server. A new installation uses a local SQLite database, so you do not need to set up MySQL first. Give each server a distinct server.name in plugins/ByteBans/config.yml. If you want to share punishments across servers, point them at the same MySQL database. Back up an existing database before upgrading.
Commands use key:value arguments and suggest keys, player names, scopes, and known record IDs as you type. For example:
/tempban user:Steve time:1d reason:Griefing scope:*
/ipmute user:Steve time:1h reason:Spam
/history user:Steve page:1
/freeze user:Steve reason:Investigation
IP bans and mutes can affect other people on the same network. They use the address your server sees, so configure real-IP forwarding on a proxy before relying on them. Grant IP moderation permissions only to staff you trust. Players must have joined before commands can resolve them by name.
Optional integrations
Discord notifications and the local admin page are off by default. If you enable Discord notifications and enter your own webhook URL, ByteBans sends moderation actions and reasons to that Discord channel. IP punishments can include IP addresses. Staff notes are excluded unless you enable them separately. Keep the webhook and its channel private.
The admin page lets staff search history and take moderation actions. It listens on 127.0.0.1 and needs its generated access token; use a local browser or an SSH tunnel. Do not publish its port directly to the internet. See the README for setup, commands, permissions, and upgrade details.
The new 1.1.0 beta has separate compatibility entries for the fourteen tested Paper and Purpur versions and for Paper 26.1.1, which has no Purpur build. The Paper-only file contains the same classes and resources as the main file; only its JAR manifest differs. Both files passed their listed live checks. Earlier 1.0.0 files keep their existing compatibility labels; this update is not verified on Bukkit or Spigot.
ByteBuilders Hosting is an affiliate link from the project author.
评论 0
登录后参与评分
还没有评论,来抢沙发吧