BungeeBan - 全服封禁管理

BungeeBan 是首个专为 BungeeCord 设计的跨服封禁插件，它允许管理员在 BungeeCord 网络层面执行本地或全局的玩家/IP封禁、临时封禁及解封操作，并提供灵活的权限与消息配置。

💡基本信息

• 许可证: MIT
• 依赖: BungeeCord
• 捐赠邮箱: [email protected] (请使用 PayPal)

重要提示

如果权限不生效，请务必在 BungeeCord 的 bungee.yml 配置文件中添加相应的权限节点。

🎮命令列表

命令格式说明：<必填参数> [可选参数]

本地封禁（针对单个服务器）

• /ban <玩家名> [服务器] [理由] - 将玩家从你所在的服务器永久封禁。
• /banip <玩家名/IP地址> [服务器] [理由] - 将IP从你所在的服务器永久封禁。
• /tempban <玩家名> <时长> [服务器] [理由] - 将玩家从你所在的服务器临时封禁指定时长。
• /tempbanip <玩家名/IP地址> <时长> [服务器] [理由] - 将IP从你所在的服务器临时封禁指定时长。
• /unban <玩家名> [服务器] - 将玩家从你所在的服务器解封。
• /unbanip <IP地址> [服务器] - 将IP从你所在的服务器解封。

全局封禁（针对所有服务器）

• /gban <玩家名> [理由] - 将玩家从所有服务器永久封禁。
• /gbanip <玩家名/IP地址> [理由] - 将IP从所有服务器永久封禁。
• /gtempban <玩家名> <时长> [理由] - 将玩家从所有服务器临时封禁指定时长。
• /gtempbanip <玩家名/IP地址> <时长> [理由] - 将IP从所有服务器临时封禁指定时长。
• /gunban <玩家名> - 全局解封玩家。
• /gunbanip <IP地址> - 全局解封IP。

实用命令

• /reloadbans - 重新加载封禁列表文件。
• /banlist [服务器|global|all] [页码] - 查看封禁列表。
• /lookup <用户名> [服务器|global|all] [页码] - 查询玩家封禁记录。
• /migrate <mysql|file> - 在 MySQL 和文件存储之间迁移数据。

🔧权限节点

说明：<服务器名> 可以是具体服务器名称，或使用 * 代表所有服务器。

管理员权限

• bans.superadmin - 拥有所有权限。
• bans.command.reloadbans - 允许使用 /reloadbans。
• bans.command.migrate - 允许使用 /migrate。
• bans.command.banlist - 允许使用 /banlist。
• bans.command.lookup - 允许使用 /lookup。
• bans.exempt - 使玩家自身免于被封禁。

服务器特定权限

• bans.admin.<服务器名> - 拥有指定服务器的所有本地封禁命令权限。
• bans.command.ban.<服务器名>
• bans.command.banip.<服务器名>
• bans.command.tempban.<服务器名>
• bans.command.tempbanip.<服务器名>
• bans.command.unban.<服务器名>
• bans.command.unbanip.<服务器名>

全局封禁权限

• bans.globaladmin - 拥有所有全局封禁命令权限。
• bans.command.gban
• bans.command.gbanip
• bans.command.gtempban
• bans.command.gtempbanip
• bans.command.gunban
• bans.command.gunbanip

玩家通知权限

• bans.player - 拥有以下所有查看权限。
• bans.see.ban - 当有人被封禁时看到消息。
• bans.see.gban
• bans.see.mute
• bans.see.gmute
• bans.see.tempban
• bans.see.gtempban

⭐配置说明

主要配置文件选项如下

# 存储类型：file 表示使用 .txt 文件存储，mysql 表示使用 MySQL 数据库。
storagetype: file

# 仅当 storagetype 为 mysql 时需要配置
database:
  address: localhost
  port: 3306
  name: minecraft
  username: bungeetest
  password: test123

# 默认的封禁理由和临时封禁时长（当操作者未提供时使用）
defaults:
  banreason: Banned by an operator.
  gbanreason: Banned by an operator.
  tempbanreason: Banned by an operator until %until%.
  gtempbanreason: Banned by an operator until %until%.
  tempbantime: 1d

# 封禁发生时发送的消息
message:
  # 如果在 server1 执行 /ban，是否要通知 server2 的玩家？
  sendLocalMsgGlobally: true
  ban: '&3%source% banned %banned% from %server% for %reason%'
  banip: '%source% banned %banned% from %server% for %reason%'
  gban: '%source% global banned %banned% for %reason%'
  gbanip: '%source% global banned %banned% for %reason%'
  unban: '%banned% got unbanned from %server%!'
  unbanip: '%banned% got banned from %server%!'
  gunban: '%banned% got unbanned globally!'
  gunbanip: '%banned% got unbanned globally!'
  tempban: '%source% tempbanned %banned% from %server% until %until% for %reason%'
  tempbanip: '%source% tempbanned %banned% from %server% until %until% for %reason%'
  gtempban: '%source% global tempbanned %banned% until %until% for %reason%'
  gtempbanip: '%source% global tempbanned %banned% until %until% for %reason%'

✨更新日志

• 1.8.1: 插件重新启动开发！
• 0.5: 大量新配置项、更好的权限支持、更新 BungeeYaml 依赖、代码清理。
• 0.4: 新的版本系统、支持 MySQL 后端、配置文件。
• 0.0.3: 修复了解封命令的大小写敏感问题。
• 0.0.2: 添加 PluginMessage 接口、添加 /reloadbans 命令、修复临时封禁不过期问题、修复命令参数计数错误、使封禁/踢出不区分大小写。
• 0.0.1: 首次发布。

❓计划功能

• 新命令:
• /mute <玩家名> <时长> <理由> [服务器] - 禁言玩家。
• /gmute <玩家名> <时长> <理由> - 全局禁言玩家。
• /unmute <玩家名> [服务器] - 解除禁言。
• /gunmute <玩家名> - 全局解除禁言。
• 开发 Bukkit 端插件以实现与 BungeeBan 的交互。
• 修复性能问题和重复封禁记录。

---

捐赠: 好的插件需要咖啡因支持！欢迎将捐赠发送至 [email protected]，非常感谢！