可配置的封禁系统,支持原因 ID
SmartBans 是一款轻量且功能强大的封禁系统,专为希望快速、一致地执行封禁并附带清晰理由的服务器工作人员设计。无需每次输入完整的封禁理由,只需使用简短的可配置原因 ID(例如 /ban Notch 1)即可立即应用预设惩罚。
✅ 特性:
通过原因 ID 封禁 – 为各种惩罚分配数字代码(例如 1 = 作弊,2 = 破坏)。
⚙️ 完全可配置 – 在 config.yml 中自定义你的原因、持续时间和消息。
轻量且高效 – 无多余冗余;适用于所有规模的服务器。
基于权限 – 对工作人员角色进行精细控制。
示例用法
/ban Notch 1
→ 因“作弊”将 Notch 封禁 30 天
/ban Herobrine 2
→ 因“破坏”将 Herobrine 封禁 7 天
/unban Notch
→ 解除对 Notch 的封禁
权限:
剧透
banplugin.ban
> 允许封禁玩家
banplugin.unban
> 允许解除封禁
banplugin.admin
> 允许封禁和解除封禁
banplugin.mute
> 允许禁言
banplugin.unmute
> 允许解除禁言
banplugin.*
> 授予所有权限
banplugin.bypass
> 允许你不会被封禁/禁言/踢出
banplugin.history
> 允许查看玩家的封禁/禁言历史
banplugin.reload
> 允许重载插件
配置示例:
剧透
# Ban Plugin Configuration
# Configure ban reasons, durations, and IDs
settings:
use-id-system:
ban: true # true = use IDs (1,2,3), false = use reasons directly
mute: true # true = use IDs (1,2,3), false = use reasons directly
bans:
1:
reason: "Cheating/Hacking"
duration: "30d"
2:
reason: "Griefing"
duration: "7d"
3:
reason: "Spam/Advertising"
duration: "1h"
4:
reason: "Toxic Behavior"
duration: "3d"
5:
reason: "Exploiting"
duration: "14d"
6:
reason: "Inappropriate Username"
duration: "1d"
7:
reason: "Ban Evasion"
duration: "60d"
8:
reason: "Staff Disrespect"
duration: "2d"
mutes:
1:
reason: "Chat Spam"
duration: "1h"
2:
reason: "Insulting Players"
duration: "2h"
3:
reason: "Racism"
duration: "7d"
4:
reason: "Advertising"
duration: "1d"
5:
reason: "Toxic Behavior"
duration: "3d"
# Duration format:
# s = seconds, m = minutes, h = hours, d = days
# Examples: 30s, 5m, 2h, 7d
消息
messages:
ban-success: "&a成功封禁 &c{player},原因:&e{reason},持续时间:&c{duration}"
unban-success: "&a成功解除对 &c{player} 的封禁"
kick-success: "&a成功踢出 &c{player},原因:&e{reason}"
player-not-found: "&c未找到该玩家!"
player-not-online: "&c该玩家不在线!"
invalid-ban-id: "&c无效的封禁 ID!可用 ID:{ids}"
no-permission: "&c你没有权限使用此命令!"
player-banned: "&c你已被此服务器封禁!\n&c原因:&e{reason}\n&c到期时间:&e{expires}"
player-kicked: "&c你已被踢出服务器!\n&c原因:&e{reason}"
already-banned: "&c{player} 已经被封禁!"
not-banned: "&c{player} 未被封禁!"
cannot-ban-staff: "&c你无法封禁该玩家——他们拥有绕过权限!"
cannot-kick-staff: "&c你无法踢出该玩家——他们拥有绕过权限!"
usage-ban: "&c用法:/ban <玩家> <ID>"
usage-unban: "&c用法:/unban <玩家>"
usage-kick: "&c用法:/kick <玩家> <理由>"
mute-success: "&a成功禁言了 &c{player} &a,原因是 &e{reason} &a,禁言时长为 &c{duration}"
unmute-success: "&a成功解除了对 &c{player} 的禁言"
player-muted: "&c你已被此服务器禁言!\n&c原因:&e{reason}\n&c过期时间:&e{expires}"
player-unmuted: "&c你已在此服务器解除禁言!"
already-muted: "&c{player} 已经被禁言了!"
not-muted: "&c{player} 未被静音!"
cannot-mute-staff: "&c你无法静音该玩家——他们拥有绕过权限!"
usage-mute: "&c用法:/mute <player> <mute-id>"
invalid-mute-id: "&c无效的静音 ID!可用 ID:{ids}"
history:
title: "&8{player} 的历史记录"
no-entries: "&c未找到历史记录条目"
entry:
ban: "&e封禁"
mute: "&e静音"
by: "&7操作者:&f{staff}"
reason: "&7原因:&f{reason}"
date: "&7日期:&f{date}"
duration:
permanent: "&7持续时间:&f永久"
temporary: "&7持续时间:&f{duration}"
invalid-player: "&c请输入有效的玩家名称"
history-usage: "&c用法:/history <player>"
reload-success: "&a配置已成功重载!"
usage-format:
divider: "&7&m--------------------------------"
ban-command:
header: "&c用法:&7/ban <玩家> <封禁ID>"
list-header: "&c可用的封禁ID:"
format: "&7ID:&c{id} &7| 原因:&c{reason} &7| 时长:&c{duration}"
mute-command:
header: "&c用法:&7/mute <玩家> <静音ID>"
list-header: "&c可用的静音ID:"
格式:"&7ID: &c{id} &7| 原因: &c{reason} &7| 持续时间: &c{duration}"
踢出命令:
头部信息:"&c用法: &7/kick <玩家> <原因>"
列表头部:"&c踢出命令帮助:"
信息:"&7在玩家名称后输入你自定义的踢出原因。"
示例:"&7示例: &c/kick Player1 Breaking the rules"
</details>
为什么选择 SmartBans?
SmartBans 非常适合希望在不每次输入理由的情况下,快速、清晰且专业地执行处罚的管理员。它适用于生存服、小游戏服、阵营服或任何需要高效且一致管理的服务器类型。
即将推出?
- 基于 GUI 的封禁功能(可切换开启/关闭)
- CMS 网页插件
- 支持 MySQL / PostgreSQL
已实现功能
- 静音系统 ✔️
- 绕过权限 ✔️
- 踢出命令 ✔️
- 混合切换功能 ✔️
- 历史记录系统 ✔️
Configurable Ban System with Reason IDs
SmartBans is a lightweight yet powerful banning system designed for server staff who want to ban players quickly, consistently, and with clear reasoning. Instead of typing out full reasons every time, use short configurable reason IDs like /ban Notch 1 to apply a preset punishment instantly.
✅ Features:
Ban with Reason IDs – Assign numeric codes to punishments (e.g. 1 = Cheating, 2 = Griefing).
⚙️ Fully Configurable – Set your own reasons, durations, and messages in config.yml.
Lightweight & Fast – No unnecessary bloat; perfect for all server sizes.
️ Permission-Based – Fine-tuned control for staff roles.
Example Usage
/ban Notch 1
→ Bans Notch for 30 days for "Cheating"
/ban Herobrine 2
→ Bans Herobrine for 7 days for "Griefing"
/unban Notch
→ Unbans Notch
Permissions:
Spoiler
banplugin.ban
> Allows banning players
banplugin.unban
> Allows unbanning players
banplugin.admin
> Allows banning and unbanning
banplugin.mute
> Allows muting
banplugin.unmute
> Allowes unmuting
banplugin.*
> Grants all permissions
banplugin.bypass
> Allows that you can't be banned/muted/kicked
banplugin.history
> Allows to see a players ban / mute history
banplugin.reload
> Allowes reloading the plugin
Config Example:
Spoiler
# Ban Plugin Configuration
# Configure ban reasons, durations, and IDs
settings:
use-id-system:
ban: true # true = use IDs (1,2,3), false = use reasons directly
mute: true # true = use IDs (1,2,3), false = use reasons directly
bans:
1:
reason: "Cheating/Hacking"
duration: "30d"
2:
reason: "Griefing"
duration: "7d"
3:
reason: "Spam/Advertising"
duration: "1h"
4:
reason: "Toxic Behavior"
duration: "3d"
5:
reason: "Exploiting"
duration: "14d"
6:
reason: "Inappropriate Username"
duration: "1d"
7:
reason: "Ban Evasion"
duration: "60d"
8:
reason: "Staff Disrespect"
duration: "2d"
mutes:
1:
reason: "Chat Spam"
duration: "1h"
2:
reason: "Insulting Players"
duration: "2h"
3:
reason: "Racism"
duration: "7d"
4:
reason: "Advertising"
duration: "1d"
5:
reason: "Toxic Behavior"
duration: "3d"
# Duration format:
# s = seconds, m = minutes, h = hours, d = days
# Examples: 30s, 5m, 2h, 7d
# Messages
messages:
ban-success: "&aSuccessfully banned &c{player} &afor &e{reason} &afor &c{duration}"
unban-success: "&aSuccessfully unbanned &c{player}"
kick-success: "&aSuccessfully kicked &c{player} &afor &e{reason}"
player-not-found: "&cPlayer not found!"
player-not-online: "&cPlayer is not online!"
invalid-ban-id: "&cInvalid ban ID! Available IDs: {ids}"
no-permission: "&cYou don't have permission to use this command!"
player-banned: "&cYou are banned from this server!\n&cReason: &e{reason}\n&cExpires: &e{expires}"
player-kicked: "&cYou have been kicked from the server!\n&cReason: &e{reason}"
already-banned: "&c{player} is already banned!"
not-banned: "&c{player} is not banned!"
cannot-ban-staff: "&cYou cannot ban this player - they have bypass permission!"
cannot-kick-staff: "&cYou cannot kick this player - they have bypass permission!"
usage-ban: "&cUsage: /ban <player> <id>"
usage-unban: "&cUsage: /unban <player>"
usage-kick: "&cUsage: /kick <player> <reason>"
mute-success: "&aSuccessfully muted &c{player} &afor &e{reason} &afor &c{duration}"
unmute-success: "&aSuccessfully unmuted &c{player}"
player-muted: "&cYou have been muted in this server!\n&cReason: &e{reason}\n&cExpires: &e{expires}"
player-unmuted: "&cYou have been unmuted in this server!"
already-muted: "&c{player} is already muted!"
not-muted: "&c{player} is not muted!"
cannot-mute-staff: "&cYou cannot mute this player - they have bypass permission!"
usage-mute: "&cUsage: /mute <player> <mute-id>"
invalid-mute-id: "&cInvalid mute ID! Available IDs: {ids}"
history:
title: "&8History of {player}"
no-entries: "&cNo history entries found"
entry:
ban: "&eBan"
mute: "&eMute"
by: "&7By: &f{staff}"
reason: "&7Reason: &f{reason}"
date: "&7Date: &f{date}"
duration:
permanent: "&7Duration: &fPermanent"
temporary: "&7Duration: &f{duration}"
invalid-player: "&cPlease enter a valid player name"
history-usage: "&cUsage: /history <player>"
reload-success: "&aConfiguration successfully reloaded!"
usage-format:
divider: "&7&m--------------------------------"
ban-command:
header: "&cUsage: &7/ban <player> <ban-id>"
list-header: "&cAvailable Ban IDs:"
format: "&7ID: &c{id} &7| Reason: &c{reason} &7| Duration: &c{duration}"
mute-command:
header: "&cUsage: &7/mute <player> <mute-id>"
list-header: "&cAvailable Mute IDs:"
format: "&7ID: &c{id} &7| Reason: &c{reason} &7| Duration: &c{duration}"
kick-command:
header: "&cUsage: &7/kick <player> <reason>"
list-header: "&cKick Command Help:"
info: "&7Write your custom kick reason after the player name."
example: "&7Example: &c/kick Player1 Breaking the rules"
Why Choose SmartBans?
SmartBans is perfect for staff who want clear, fast, and professional punishments without typing reasons every time. It's ideal for survival, minigame, faction, or any type of server where moderation needs to be efficient and consistent.
Coming Soon?
- GUI Based bans (toggle on and off)
- Web Plugin for CMS
- Add MySQL / PostgreSQL support
Already Implemented
- Mute System ✔️
- Bypass permission ✔️
- Kick Command ✔️
- Hybrid toggle function ✔️
- History System ✔️
评论 0
登录后参与评分
还没有评论,来抢沙发吧