CraftersBan – 适用于 Spigot/Paper 的高级处罚与管理套件
CraftersBan 是一款专为 Minecraft 服务器设计的完整处罚管理插件,旨在提供快速、有序且现代化的审核工作流。它将最重要的员工工具整合在一起:封禁(bans)、临时封禁(tempbans)、静音(mutes)、临时静音(tempmutes)、警告(warnings)、临时警告(tempwarnings)、踢出(kicks)、IP 处罚、处罚历史记录、活跃处罚列表、账号调查工具、锁定控制、聊天审核以及 Discord Webhook 支持。
CraftersBan 针对实际生产环境设计,专注于:
- 简洁的员工工作流
- 灵活的 YAML 配置
- 实用的审核辅助功能
- 同时支持本地和网络式服务器架构
- 基于 MySQL 或 H2 的可靠存储
⚔️ 主要功能
- 完整的处罚系统 – 支持
ban、mute、warn、tempwarn、kick、ipban和ipmute。 - 对员工友好的命令 – 查看活跃处罚、玩家历史记录,以及浏览封禁、静音和警告列表。
- 警告管理 – 支持
unwarn(撤销警告)和警告查询命令。 - 静默处罚 – 仅限员工使用的审核操作,不会在公共聊天中显示。
- 处罚模板 – 预设常用理由,加快员工响应速度。
- 小号/账号查找 – 通过存储的玩家 IP 历史记录调查关联账号。
- GeoIP 查找支持 – 了解玩家的连接地理位置。
- 锁定模式 – 在发生事件时限制服务器访问。
- 聊天审核 – 提供
clearchat(清空聊天)和mutechat(静音聊天)工具。 - Discord Webhook 集成 – 将处罚日志和警报发送到 Discord。
- 自动配置合并 – 更新不会覆盖您现有的自定义设置。
?️ 截图
展示给受罚玩家的封禁界面。
玩家的全量处罚历史记录视图。
玩家被移除服务器时显示的踢出消息。
展示给受影响玩家的静音通知。
带有过期详情的临时封禁界面。
? 命令亮点
- 处罚类:
/ban、/ipban、/mute、/ipmute、/warn、/tempwarn、/unwarn、/kick - 查询类:
/history、/checkban、/checkmute、/checkwarn、/alts、/geoip、/lastuuid - 列表类:
/banlist、/mutelist、/warnlist - 服务器管理类:
/lockdown、/clearchat、/mutechat、/punish、/craftersban
? 存储与集成
- 存储后端: MySQL、H2
- 软依赖项: LuckPerms、Vault、PlaceholderAPI
- 通知支持: Discord Webhook
✅ 兼容性
- 平台: Bukkit / Spigot / Paper
- 版本: 1.13+
- 编译基准: Spigot API 1.21.5
- Java 版本: Java 11+
- Velocity: 不支持
? 为什么选择 CraftersBan?
CraftersBan 专为那些希望在高压力环境下保持审核工具一致性和易用性的服务器而构建。无论员工需要快速发出处罚、审查玩家完整历史记录、调查关联账号,还是暂时锁定服务器,该插件都将所有内容集中在一个专注的系统中。
目标很简单:减少员工摩擦,提高一致性,并随着服务器规模的扩大,使处罚管理更易于控制。
由 xUnknowns 开发 | 文档:
许可与知识产权
© 2026 Crafters Development。保留所有权利。
未经 Crafters Development 明确许可,禁止重新分发、复制或修改本软件。此代码受智利知识产权法 17.336 保护的知识产权。
[!IMPORTANT] 重新分发澄清: 禁止重新分发的规定严格适用于将软件托管或上传至外部下载网站或未授权的第三方平台。
此限制不适用于通过以下方式分享信息、截图或官方链接:
- 即时通讯应用: Discord、WhatsApp、Telegram 等。
- 社交媒体: Twitter (X)、Facebook 等。
- 社区群组: 私设服务器聊天或员工群组。
CraftersBan – Advanced Punishment & Moderation Suite for Spigot/Paper
CraftersBan is a complete punishment management plugin for Minecraft servers that want a fast, organized, and modern moderation workflow. It brings the most important staff tools into one place: bans, tempbans, mutes, tempmutes, warnings, tempwarnings, kicks, IP punishments, punishment history, active punishment lists, account investigation tools, lockdown controls, chat moderation, and Discord webhook support.
Designed for real production use, CraftersBan focuses on:
- Clean staff workflows
- Flexible YAML configuration
- Useful moderation utilities
- Support for both local and network-style server setups
- Reliable storage with MySQL or H2
⚔️ Main Features
- Full punishment system –
ban,mute,warn,tempwarn,kick,ipbanandipmute. - Staff-friendly commands – Check active punishments, view player history, and browse ban, mute and warning lists.
- Warning management –
unwarnand warning lookup commands. - Silent punishments – Staff-only moderation actions hidden from public chat.
- Punishment templates – Quick reasons for faster staff responses.
- Alt/account lookup – Investigate linked accounts through stored player IP history.
- GeoIP lookup support – Know where players are connecting from.
- Lockdown mode – Restrict server access during incidents.
- Chat moderation –
clearchatandmutechattools. - Discord webhook integration – Punishment logs and alerts sent to Discord.
- Auto config merge – Updates never overwrite your existing customization.
?️ Screenshots
Ban screen shown to a punished player.
Full punishment history view for a player.
Kick message displayed when a player is removed from the server.
Mute notification shown to the affected player.
Temporary ban screen with expiration details.
? Command Highlights
- Punishments:
/ban,/ipban,/mute,/ipmute,/warn,/tempwarn,/unwarn,/kick - Lookup:
/history,/checkban,/checkmute,/checkwarn,/alts,/geoip,/lastuuid - Lists:
/banlist,/mutelist,/warnlist - Server:
/lockdown,/clearchat,/mutechat,/punish,/craftersban
? Storage & Integrations
- Storage: MySQL, H2
- Soft dependencies: LuckPerms, Vault, PlaceholderAPI
- Notifications: Discord webhook support
✅ Compatibility
- Platform: Bukkit / Spigot / Paper
- Versions: 1.13+
- Compiled against: Spigot API 1.21.5
- Java: Java 11+
- Velocity: Not supported
? Why CraftersBan?
CraftersBan is built for servers that want moderation tools to feel consistent and easy to use under pressure. Whether staff need to issue a fast punishment, review a player's full history, investigate linked accounts, or temporarily lock down the server, the plugin keeps everything in one focused system.
The goal is simple: reduce staff friction, improve consistency, and make punishment management easier to control as your server grows.
Developed by xUnknowns | Documentation:
License & Intellectual Property
© 2026 Crafters Development. All rights reserved.
Redistribution, copying, or modification of this software is prohibited without the express permission of Crafters Development. This code is intellectual property protected by Chilean Intellectual Property Law 17.336.
[!IMPORTANT] Redistribution Clarification: The prohibition on redistribution applies strictly to hosting or uploading the software to external download websites or unauthorized third-party platforms.
This restriction DOES NOT apply to sharing information, screenshots, or official links through:
- Messaging Apps: Discord, WhatsApp, Telegram, etc.
- Social Media: Twitter (X), Facebook, etc.
- Community Groups: Private server chats or staff groups.
下载 CraftersBan
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CraftersBan
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CraftersBan
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CraftersBan
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CraftersBan
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
CraftersBan v2.9 — 高级版
发布日期: 2026年10月
兼容性: Spigot / Paper / Purpur 1.13–1.21+ | BungeeCord / Velocity
概述
CraftersBan v2.9 对惩罚追踪与识别机制进行了重大内部重构,提升了启动可靠性和数据库初始化过程,全面修复了 Adventure 和 MiniMessage 格式化的问题,并新增了一组全局及玩家专属的统计占位符。
此次发布还改进了可选的 PlaceholderAPI 集成、依赖隔离、错误报告以及跨支持服务器平台的兼容性。
? 新功能
1. 独立的顺序惩罚 ID
惩罚 ID 现在采用针对每个惩罚类别独立跟踪的顺序计数器,使识别更加一致且有条理。
- 永久封禁(
/ban): 独立计数器,用于永久封禁(如#1、#2等)。 - 临时封禁(
/tempban或/ban <duration>): 独立计数器,用于临时封禁。 - IP 封禁(
/ipban): 专用计数器,用于 IP 封禁。 - 静音与 IP 静音(
/mute、/ipmute): 玩家静音和 IP 静音分别使用独立的计数器。 - 踢出与警告(
/kick、/warn): 独立的顺序计数器。
技术改进:
- 在
PunishmentRepository、SqlPunishmentRepository和CachedPunishmentRepository中添加了getNextTypeId方法。 - 更新了
CraftersBanAPIImpl#dispatchPunishment,使其在向数据库插入处罚记录前自动分配相应的顺序type_id。 - 更新了
BanCommand、IpBanCommand、MuteCommand、IpMuteCommand、WarnCommand和KickCommand,以支持新的 ID 分配系统。
2. 新增统计信息与占位符
新增的占位符允许服务器管理员在消息、踢出界面及其他支持的集成中显示处罚统计信息。
全服消息占位符
可在 messages.yml 和踢出界面消息中使用:
%craftersban_total_sanctions%— 已记录的制裁总数,包括封禁、静音、踢出和警告。%craftersban_total_permanent_bans%— 永久封禁的总数。%craftersban_total_temporary_bans%— 临时封禁的总数。%craftersban_total_ip_bans%— IP 封禁的总数。
PlaceholderAPI — 全局统计
以下占位符无需指定目标玩家即可使用:
%craftersban_total_punishments%/%craftersban_total_sanctions%— 记录的处罚总数。%craftersban_total_permanent_bans%/%craftersban_total_perm_bans%— 永久封禁的总数。%craftersban_total_temporary_bans%/%craftersban_total_temp_bans%— 临时封禁的总数。%craftersban_total_ip_bans%/%craftersban_total_ipbans%— IP 封禁的总数。
PlaceholderAPI — 玩家专属统计信息
这些占位符提供单个玩家的历史处罚统计数据:
%craftersban_player_total_sanctions%/%craftersban_player_total_punishments%— 该玩家记录的处罚总数。%craftersban_player_permanent_bans%— 该玩家收到的永久封禁总数。%craftersban_player_temporary_bans%— 该玩家收到的临时封禁总数。%craftersban_player_ip_bans%— 与该玩家关联的 IP 相关处罚总数。
3. MiniMessage、Adventure 及颜色格式修复
修复了在消息渲染过程中 [CraftersBan] 前缀中的渐变和其他格式样式丢失的问题。
- 移除了
MessageManager#send()中可能导致 MiniMessage 渐变(如<gradient:#ff4b4b:#aa0000>)失效的旧版LegacyComponentSerializer重新序列化逻辑。 - 更新
send()方法以直接委托给sendComponent(),在向玩家和控制台发送消息时保留原生的 Adventure 组件。 - 更新
PlayerCommandListener,在涉及静音命令的锁定通知和限制中使用sendComponent()。 - 修复了
PlayerChatListener中的静音和 IP 静音消息,使其能正确解析前缀和颜色。 - 更新
AsyncPlayerChatListener中的违禁词过滤功能以使用sendComponent()。 - 标准化了
LockdownCommand、MuteChatCommand和LastUuidCommand中的基于组件的消息传递。
4. 启动可靠性与数据库初始化改进
改进了插件的启动流程,以防止因配置问题导致的数据库连接失败。
- 修复了
onEnable()期间加载数据库凭据的问题。 - 连接设置(
host、port、name、username和password)现在通过类型化的ConfigManager访问器从settings/database.yml正确获取。 - 降低了因错误加载数据库设置而导致插件意外禁用的风险。
- 当 HikariCP、MySQL 或 H2 初始化失败时,添加了详细的连接初始化错误日志记录,包括
Level.SEVERE级别下的完整堆栈跟踪。
5. 打包与依赖改进
- 改进了 Guice 和 MaxMind 依赖的阴影处理与重定位。
- 将库包迁移至
dev.xunknown.craftersban.libs.*下,以降低与其他插件发生类冲突的风险。 - 通过 CircleCI 验证了 Maven 构建流水线,并统一了对支持 Paper 1.20+ 和 1.21+ 环境的部署工作流。
6. 更安全的 PlaceholderAPI 集成
当服务器未安装 PlaceholderAPI 时,其处理方式现在更加安全。
- 移除了
CraftersBanModule中对CraftersBanPlaceholderExpansion的静态引用和导入,防止 JVM 在缺少依赖时尝试加载 PlaceholderAPI 类。 - 修复了之前因在未安装 PlaceholderAPI 的情况下尝试加载
me.clip.placeholderapi.expansion.PlaceholderExpansion而导致的java.lang.NoClassDefFoundError。 - CraftersBan 现在无需 PlaceholderAPI 即可正常启动。
- 添加了清晰简洁的控制台提示,说明必须安装 PlaceholderAPI 才能启用
%craftersban_...%占位符,并附带下载链接。
? 兼容性
- Minecraft 服务器: Spigot、Paper 和 Purpur 1.13–1.21+
- 代理平台: BungeeCord 和 Velocity
- 数据库支持: MySQL 和 H2
- 可选集成: PlaceholderAPI
? 备注
PlaceholderAPI 为可选组件。CraftersBan 可在无 PlaceholderAPI 的情况下运行,但依赖于 PlaceholderAPI 的占位符需要安装该集成才能生效。
CraftersBan v2.9 专注于更可靠的惩罚追踪、改进的消息渲染、更安全的依赖处理以及为服务器管理员提供更详尽的统计数据。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧