EasyBan

EasyBan 提供跨服统一的封禁、禁言、警告、举报工单管理及反小号检测功能。

这里提供了EasyBanV和EasyBanPaper两个插件版本，你需要将EasyBanV安装在Velocity上，EasyBanPaper安装再子服上，其中EasyBanV是EasyBanPaper的硬依赖，如果你只安装了EasyBanPaper，插件无法工作。

• 本项目以AGPL-3.0开源，因此，如果您修改了 此程序，并将其部署在服务器上通过网络提供服务，则您必须向所有通过网络与该程序交互的用户提供获取完整源代码（包含您的修改）。

---

指令

理由规则

• 无 ! 指令（全服通告版）— [理由] 必填，无理由则拒绝执行
• 有 ! 指令（静默版）— [理由] 选填，留空使用默认理由

玩家指令（默认可用）

指令	说明	别名
/reportv <玩家> [理由]	举报玩家	/举报v
/report-confirm <ID>	确认自己的工单已完成
/report-close <ID>	关闭自己的工单

管理员指令（默认 OP）

全服通告版（理由必填）

指令	说明	权限
/ban <玩家> <时间> <理由>	封禁玩家（全服通告）	easyban.lowadmin.ban.use
/banip <玩家/IP> <时间> <理由>	IP 封禁	easyban.lowadmin.banip.use
/unban <玩家> <理由>	解封玩家	easyban.lowadmin.unban.use
/unbanip <玩家/IP> <理由>	解封 IP	easyban.lowadmin.unbanip.use
/warn <玩家> <理由>	警告玩家	easyban.lowadmin.warn.use
/unwarn <玩家> <理由>	撤销警告	easyban.lowadmin.warn.use
/mute <玩家> <时间> <理由>	禁言玩家	easyban.lowadmin.mute.use
/unmute <玩家> <理由>	解除禁言	easyban.lowadmin.unmute.use
/kick <玩家> <理由>	踢出玩家	easyban.lowadmin.kick.use

静默版（理由选填，无全服通告）

指令	说明	权限	默认理由
/ban! <玩家> [时间] [理由]	静默封禁	easyban.admin.ban.use	被封禁
/banip! <玩家/IP> [时间] [理由]	静默 IP 封禁	easyban.admin.banip.use	被封禁
/unban! <玩家> [理由]	静默解封	easyban.admin.unban.use	已解封
/unbanip! <玩家/IP> [理由]	静默解封 IP	easyban.admin.unbanip.use	已解封
/warn! <玩家> [理由]	静默警告	easyban.admin.warn.use	我在看着你！
/unwarn! <玩家> [理由]	静默撤销警告	easyban.admin.warn.use	已撤销警告
/mute! <玩家> [时间] [理由]	静默禁言	easyban.admin.mute.use	被禁言
/unmute! <玩家> [理由]	静默解除禁言	easyban.admin.unmute.use	已解除禁言
/kick! <玩家> [理由]	静默踢出	easyban.admin.kick	你已被踢出游戏

IP 封禁离线玩家

/banip Steve 10d 作弊 或 /banip Steve@0.*.*.* 10d 作弊 — 若玩家不在线，不会报错，而是记录待执行。待该玩家下次上线时自动获取其 IP 进行封禁。

查询

指令	说明	权限
/ip <玩家>	查询玩家 IP 与归属地	easyban.admin.ip
/banlistv	查看封禁列表	easyban.admin.banlist

举报管理

指令	说明	权限
/report-admin-set-status <ID> <状态>	设置工单状态	easyban.admin.reportstatus
/report-admin-set-adminmessage <ID> <消息>	设置管理员回复	easyban.admin.reportmessage
/report-admin-force-reopen <ID>	强制重开工单	easyban.xadmin.forcereopenreport
/report-admin-force-delete <ID>	强制删除工单	easyban.xadmin.forcedeletereport
/report-confirm <ID>	确认工单完成（玩家）	easyban.player.confirmmyreport
/report-close <ID>	关闭工单（玩家）	easyban.player.closemyreport

系统

指令	说明	权限
/easybanv	检查版本更新	无
/easybanv reload	重载配置	easyban.xadmin.reload
/easybanv testai	测试 DeepSeek AI	easyban.xadmin.testai
/easybanv help	显示指令帮助	无

时间格式

格式	示例	说明
数字	30	分钟
数字s	60s	秒
数字h	2h	小时
数字d	7d	天
数字w	2w	周
数字m	1m	月（30天）
数字y	1y	年（365天）

不指定时间 = 永久封禁/禁言。

---

权限

玩家权限（默认 true）

权限节点	说明
easyban.player.report.use	使用 /reportv
easyban.player.confirmmyreport	确认自己的工单
easyban.player.closemyreport	关闭自己的工单
easyban.report.seeothers	查看他人工单（GUI）

普通管理员权限（默认 OP，全服通告）

权限节点	说明
easyban.lowadmin.ban.use	使用 /ban
easyban.lowadmin.banip.use	使用 /banip
easyban.lowadmin.unban.use	使用 /unban
easyban.lowadmin.unbanip.use	使用 /unbanip
easyban.lowadmin.warn.use	使用 /warn /unwarn
easyban.lowadmin.mute.use	使用 /mute
easyban.lowadmin.unmute.use	使用 /unmute
easyban.lowadmin.kick.use	使用 /kick
easyban.lowadmin.confirmreport	将工单设为待确认

高级管理员权限（默认 OP，静默）

权限节点	说明
easyban.admin.ban.use	使用 /ban!
easyban.admin.banip.use	使用 /banip!
easyban.admin.unban.use	使用 /unban!
easyban.admin.unbanip.use	使用 /unbanip!
easyban.admin.warn.use	使用 /warn! /unwarn!
easyban.admin.mute.use	使用 /mute!
easyban.admin.unmute.use	使用 /unmute!
easyban.admin.kick	使用 /kick!
easyban.admin.ip	使用 /ip
easyban.admin.banlist	使用 /banlistv
easyban.admin.reportstatus	设置工单状态
easyban.admin.reportmessage	设置管理员回复
easyban.admin.warntoalerted	接收警告超限通知

时间权限

权限节点	说明
easyban.lowadmin.ban.time.<分钟>	/ban 最大时长
easyban.lowadmin.ban.time.*	/ban 时长无限制
easyban.admin.ban.time.<分钟>	/ban! 最大时长
easyban.admin.ban.time.*	/ban! 时长无限制
easyban.lowadmin.banip.time.<分钟>	/banip 最大时长
easyban.lowadmin.mute.time.<分钟>	/mute 最大时长
easyban.admin.banip.time.<分钟>	/banip! 最大时长
easyban.admin.mute.time.<分钟>	/mute! 最大时长

无时间权限时默认最长 1 分钟。拥有 * 权限时不指定时间为永久。

超级管理员权限

权限节点	说明
easyban.xadmin.reload	重载配置
easyban.xadmin.testai	测试 AI
easyban.xadmin.forcereopenreport	强制重开工单
easyban.xadmin.forcedeletereport	强制删除工单
easyban.xadmin.nocontrolme	不可被 ban/kick/warn/mute
easyban.xadmin.removeallwarn.use	清空所有警告
easyban.xadmin.reset-ban-record	重置封禁计数

---

配置

config.yml 主要选项

# 数据库（支持 SQLite / MySQL）
database:
  type: sqlite
  sqlite:
    file: "./EasyBanV.db"
  mysql:
    host: 127.0.0.1
    port: 3306
    user: root
    basename: EasyBanV
    prefix: "ezBanV_"
    password: the-password

# 反小号检测
password-detect: 1          # 密码比对检测
city-detect.enable: 0       # IP 归属地检测
name-detect.enable: 0       # AI 名称相似度检测
detect-time: 60             # 检测时间窗口（分钟）

# 封禁消息模板
banned-message:
  line1: "你被办了！"
  line2: "你是{player}，被{admin}因为"
  line3: "{reason}"

# 全服通告模板（可使用 {admin} {player} {reason} {time} {ip}）
IDidIt:
  ban: "<{admin}> 我刚刚依法查办了 {player}！我确信这小子{reason}！他必须滚出我们的视线直到{time}！"
  kick: "<{admin}> 我刚刚让 {player} 从我们的视线消失了！我确信这小子{reason}！"