查看“AdvancedBan”的源代码

{{Plugin
|version=V2.3.0
|URL=https://www.spigotmc.org/resources/advancedban.8695/
}}
== 综述 ==
=== 介绍 ===
*AdvancedBan 是一个集合了警告、临时警告、禁言、临时禁言、封禁、临时封禁、IP封禁、临时IP封禁 和踢出功能的多合一惩罚系统。
*本插件提供玩家历史以供查阅玩家的被惩罚记录，同时本插件有可配置的时间&消息布局以实现根据特定原因自动计算和增加惩罚时间的操作。 
*AdvancedBan 还提供了一个完整的消息文件，因此您可以更改和翻译所有消息和一个包含许多有用设置的详细配置文件。 
*AdvancedBan 支持在 BungeeCord 和 Bukkit/Spigot 上运行，同时它支持 MySQL 和本地嵌入式数据库以提供高性能。
本插件由 [http://skamps.eu/ Leoko]开发

==指令==
[需要]
<可选>
| = 或
-s = 静默惩罚（不通知他人）

/kick <-s> [玩家] <原因 | @布局>
踢一名玩家

/ban /mute /warn /note <-s> [玩家] <原因 | @布局>
禁止/禁言/警告玩家/向玩家添加原因

/banip <-s> [玩家/IP] <原因 | @布局>
禁止玩家的IP。 如果您输入名称，它将使用缓存的 IP

/tempban /tempmute /tempwarn <-s> [玩家] [Xmo|Xd|Xh|Xm|Xs|#TIMELAYOUT] <原因 | @布局>
临时禁止/静音/警告玩家给定时间或自动时间计算的时间布局

/tempipban <-s> [玩家/IP] [Xmo|Xd|Xh|Xm|Xs|#TIMELAYOUT] <原因 | @布局>
临时IPban 一个给定时间或具有自动时间计算的时间布局的玩家
别名：/tipban

/change-reason [ID] [新原因]
通过id更改处罚原因

/change-reason [禁令/禁言] [玩家] [新理由]
更改玩家处罚的原因

/unban /unmute [玩家]
解禁令/解禁言玩家

/unwarn /unnote [ID]
删除警告/删除注释

/unwarn /unnote clear [玩家]
删除玩家的所有警告/注释

/unpunish [ID]
删除惩罚

/warns /notes <玩家>
查看您自己或玩家的警告/注意事项。

/check [玩家]
获取玩家状态：UUID/IP/Country/Ban-Status/Mute-Status/Warn-Count/Note-Count

/banlist <页面>
查看所有当前有效的惩罚

/history [玩家] <页面>
查看所有当前有效的惩罚
使用命令 - ab.history

/advancedban reload
重载插件

/advancedban help
显示advancedban的帮助

/systemprefs
显示一些对配置有用的系统信息 
==权限==
ab.kick.use - /kick 踢出玩家
ab.kick.exempt - Immune to kicking 免疫被踢
ab.notify.kick - Receives notification 接收kick通知

ab.ban.perma - /ban 封禁
ab.ban.temp - /tempban 临时封禁
ab.ban.undo - /unban 解除封禁
ab.ban.exempt - Immune to ban 免疫封禁
ab.notify.ban - Receives notification 接收封禁通知
ab.undoNotify.ban - Receives notification when someone gets unbanned 当有人被解禁时收到通知

ab.notify.tempban - Receives notification 接收临时禁令通知

ab.ipban.perma - /ipban IP封禁
ab.ipban.temp - /tempipban 临时IP封禁
ab.notify.ipban - Receives notification 接收临时IP封禁通知

ab.tempipban.exempt - Immune to tempipban 对临时IP封禁免疫
ab.notify.tempipban - Receives notification 接收临时IP封禁通知

ab.mute.perma - /mute 禁言
ab.mute.temp - /tempmute 临时禁言
ab.mute.undo - /unmute 解除禁言
ab.mute.exempt - Immune to mute 免疫禁言
ab.notify.mute - Receives notification 接收禁言通知
ab.undoNotify.mute - Receives notification when someone gets unmuted 当有人取消禁言时收到通知

ab.notify.tempmute - Receives notification 接收临时禁言通知

ab.warn.perma - /warn 警告
ab.warn.temp - /tempwarn 临时警告
ab.warn.undo - /unwarn 解除警告
ab.warn.exempt - Immune to warn 免疫警告
ab.notify.warn - Receives notification 接收警告通知
ab.undoNotify.warn - Receives notification when someone gets unwarned 当没有人被警告是通知

ab.notify.tempwarn - Receives notification 接收临时警告通知

ab.note.use - /note
ab.note.undo - /unnote
ab.note.exempt - Immune to receiving notes
ab.notify.note - Receives notification
ab.undoNotify.note - Receives notification when someone gets unnoted

ab.all.undo - /unpunish

ab.warns.own - /warns
ab.warns.other - /warns PLAYER

ab.notes.own - /notes
ab.notes.other - /notes PLAYER

ab.check - /check
ab.check.ip - Also shows IP

ab.changeReason - /change-reason
ab.banlist - /banlist
ab.history - /history
ab.reload - /advancedban reload
ab.help - /advancedban help
ab.systemprefs - /systemprefs

====Config.yml====
<syntaxhighlight lang="yaml">

# AdvancedBan v2 - 由 Leoko 编写
# 每项设置都有一段描述说明.
# 在更改任何字段前请认真阅读每段描述.
# 了解更多?请访问: https://www.spigotmc.org/resources/advancedban.8695/
# 需要定制插件或网站?访问我们的开发页面: http://dev.skamps.eu

# 如果设置为 false 所有封禁都会被本地存储在一个HSQLDB数据库内
UseMySQL: false

# 如果你只想在服务器后台看到简短的插件启用/禁用信息,请设置为 false
DetailedEnableMessage: true
DetailedDisableMessage: true

# 如果没有指定,那么这就是执行操作时的默认惩罚原因
DefaultReason: "none"

# 如果服务器时间与玩家不同,可以更改此项以调整
# 如 服务器时间: 16:43 | 你的时间: 13:43 | TimeDiff值应改为 -3
# 你可以使用 /systemPrefs 指令来查看服务器时间
TimeDiff: 0

# 这些指令会对被禁言的玩家显示
# 被禁言的玩家无法使用类似 /minecraft:me 等指令来绕过禁言发出消息
MuteCommands:
- 'me'
- 'say'
- 'action'
- 'eaction'
- 'describe'
- 'edescribe'
- 'eme'
- 'w'
- 'm'
- 'pm'
- 'whisper'
- 'ewhisper'
- 'emsg'
- 'msg'
- 'etell'
- 'tell'
- 'er'
- 'r'
- 'reply'
- 'ereply'
- 'ac'
- 'eac'
- 'amsg'
- 'eamsg'
- 'ehelpop'

# 惩罚操作不会对这些玩家生效(包括离线玩家)
ExemptPlayers:
- 'Leoko'
- 'md5'
- 'dutchy1001'
- 'ItzSomebody'

# 调用 %DATE% 变量时使用的日期格式
DateFormat: "dd.MM.yyyy-HH:mm"

# 此选项对 bungeecord 或不支持 *-泛权限的服务器很有用
# 设置为 true 后你可以使用 ab.all 权限节点以替代 ab.* 或 ab.ban.all 替代 ab.ban.*
# 此项对负权限无效! 如 -ab.all 并不能禁止用户使用ab权限
EnableAllPermissionNodes: false

# 如果你在使用外部 REST-API 那么他们会以 JSON 形式回应
# 以下 API 只对 NAME -> UUID 有效
# 而 UUID -> NAME 会调用官方 MojangAPI 或 InternFetcher
# 想知道是否可以使用 intern fetcher 请执行 /systemPerfs 指令并将你的 UUID 与 https://namemc.com 上的 UUID 对比
# 如果值相同,我们建议你使用 InternFetcher
UUID-Fetcher:
  # 如果 Dynamic 设置为 true 那么 Enabled 和 Intern 设置会被覆盖,同时会自动确定可能最佳的UUID匹配方式
  # 我们的建议:没出问题就不要把 Dynamic 设置为 false
  Dynamic: true
  Enabled: true
  Intern: false
  REST-API:
    URL: "https://api.mojang.com/users/profiles/minecraft/%NAME%?at=%TIMESTAMP%"
    Key: "id"
  BackUp-API:
    URL: "https://us.mc-api.net/v3/uuid/%NAME%"
    Key: "uuid"

# 这些是警告时会执行的指令
# 如果跳过等级数值那么将会执行之前的指令
# 你也可以使用如 broadcast 和 clear %PLAYER% 此类非AdvancedBan内置指令
# 变量: %PLAYER%, %REASON%, %COUNT%
WarnActions:
  3: "kick %PLAYER% &c&oYou have received your 3rd warning!"
  4: "tempban %PLAYER% 30m &c&oYou have received your 4th warning!"
  5: "tempban %PLAYER% 5h &c&oYou have received your 5th warning!"
  6: "tempban %PLAYER% 7d &c&oYou have received your 6th warning!"
  7: "tempban %PLAYER% 1mo &c&oYou have received your %COUNT%th warning!"
  10: "ban %PLAYER% &c&oYou have received your 10th warning!"

# 你可以在这里创建权限节点以定制不同惩罚等级的惩罚持续时间
# 如权限节点 "ab.tempban.dur.1" 允许玩家封禁 600秒 = 10分钟
# 而权限节点 "ab.tempwarn.dur.2" 允许玩家封禁 3600秒 = 1小时
# 你最多只能添加10个权限节点 这些权限节点会被 "ab.COMMAND.dur.max" 权限节点覆盖
TempPerms:
  1: 600
  2: 3600
  3: 43200
</syntaxhighlight>