SmartBans - 智能封禁管理

💡SmartBans 简介

SmartBans 是一款功能完善的封禁管理插件，它允许你为被封禁的玩家显示 100% 可自定义的提示信息。该插件使用 UUID 进行封禁，有效防止玩家通过更改用户名来绕过处罚，并会详细记录被封禁玩家的名称、执行封禁的管理员、封禁理由以及封禁时长。

🎮安装方法

• 下载插件文件，将其放入服务器的 plugins 文件夹中。
• 重启服务器以生成必要的配置文件。

🎮配置说明

配置文件 config.yml 中的每个选项都控制着特定的提示信息。你可以根据需要自定义以下内容：

消息配置

• already-banned: 当管理员尝试封禁一名已被封禁的玩家时，发送给管理员的提示。
• ban-check-message: 当管理员使用 /check <玩家> 命令时显示的封禁详情。
• ban-exempt: 当管理员尝试封禁一名拥有 smartbans.exempt 权限（且管理员没有 smartbans.override 权限）的玩家时显示的提示。
• ban-message: 玩家被封禁时，或尝试加入服务器但仍处于封禁期时看到的提示信息。
• default-perm: 当玩家被永久封禁时，在封禁时长部分显示的文本。
• default-reason: 当封禁未指定理由时使用的默认理由。
• expired-ban: 当玩家的临时封禁到期后，在 prev-banned.yml 文件的“解封者”部分显示的文本。
• no-time: 当封禁时长为 0 天/0 小时等时显示的文本，避免留空。
• player-not-found: 当指定的用户名不存在时，发送给管理员的提示。
• player-not-banned: 当管理员尝试解封或检查一名未被封禁的玩家时显示的提示。

通知配置

• perm-banned-notif: 当玩家被永久封禁时，在聊天栏中向拥有 smartbans.notify 权限的玩家发送的通知。
• temp-banned-notif: 当玩家被临时封禁时，在聊天栏中向拥有 smartbans.notify 权限的玩家发送的通知。
• unban-notif: 当玩家被解封时，在聊天栏中向拥有 smartbans.notify 权限的玩家发送的通知。

🎮变量使用

你可以在 config.yml 的文本中使用变量，插件会自动将其替换为实际内容。例如，%player% 会被替换为目标玩家的名字。

变量列表

• %player%: 替换为目标玩家的名称。
• %NL%: 换行符。
• %banned-by%: 替换为执行封禁的玩家名称（如果由控制台执行，则显示 CONSOLE）。
• %ban-length%: 剩余的封禁时长。
• %reason%: 封禁理由。
• %unbanned-by%: 替换为执行解封的玩家名称（如果由控制台执行，则显示 CONSOLE）。

变量适用位置

不同变量仅适用于特定的配置项

• %player%: 适用于 already-banned, ban-check-message, ban-exempt, player-not-found, player-not-banned, perm-banned-notif, temp-banned-notif, unban-notif。
• %NL%: 适用于 ban-check-message, ban-message, perm-banned-notif, temp-banned-notif, unban-notif。
• %banned-by%: 适用于 ban-check-message, ban-message, perm-banned-notif, temp-banned-notif。
• %ban-length%: 适用于 ban-check-message, ban-message, perm-banned-notif, temp-banned-notif, unban-notif。
• %reason%: 适用于 ban-check-message, ban-message, perm-banned-notif, temp-banned-notif。
• %unbanned-by%: 适用于 unban-notif。

🎮权限节点

• smartbans.ban: 允许使用 /ban 命令。
• smartbans.check: 允许用户查看被封禁玩家的详细信息（理由、执行者、时长）。
• smartbans.exempt: 使玩家免于被封禁，通常授予管理员。
• smartbans.notify: 当有人被封禁或临时封禁时，在聊天栏接收通知。
• smartbans.override: 允许你封禁拥有 smartbans.exempt 权限的玩家，通常保留给 OP 或高级管理员。
• smartbans.tempban: 允许使用 /tempban 命令。
• smartbans.unban: 允许使用 /unban 命令。

🎮命令用法

• /ban <player> <reason>: 封禁一名玩家并指定理由。如果未输入理由，将使用配置中的默认理由。
• /check <player>: 显示玩家被封禁的理由、执行者以及剩余时长。
• /tempban <player> <length> <reason>: 临时封禁一名玩家。<length> 参数允许你指定天数、小时、分钟和秒，用逗号分隔。例如：/tempban oceantheskatr 2d,3h,1m,20s 制作了一个超棒的插件！ 这将临时封禁 “oceantheskatr” 2天3小时1分20秒，理由为“制作了一个超棒的插件！”。
• /unban <player>: 解封玩家。该玩家将从封禁列表移至历史封禁列表 (prev-banned.yml)，其中会记录所有过去的封禁信息，包括解封者、封禁理由、时长和封禁执行者。

✨当前功能

• 为被封禁玩家提供 100% 可自定义的加入提示信息。
• 基于 UUID 的封禁系统，安全可靠。
• 可以封禁任何玩家，即使他们从未加入过你的服务器。
• 存储封禁理由、封禁时长和执行封禁的管理员。

🔧计划功能

• 添加 /banlist 命令，以 GUI 形式直观展示被封禁玩家列表。
• 欢迎提出功能建议！

⭐支持与捐赠

如果你喜欢这个插件并想支持我的工作，可以通过 PayPal 进行捐赠：

https://paypal.me/OceanSharma

❓其他信息

• 更新日志请查看插件下载页面以获取最新信息。
• 如果遇到任何错误，请提交问题报告或直接联系我，而不是留下负面评论。
• 插件图标由 Kicjow 制作。