CasualBans 是 LiteBans、AdvancedBan 及类似处罚插件的现代替代品。它专为 Paper 1.21+ 从头构建,具备跨服务器同步、强大的模板系统、Discord 集成以及简洁的开发者 API —— 全部包含在一个零依赖的 JAR 文件中。
特性
- 8 种处罚类型 — Ban(封禁)、TempBan(临时封禁)、IP-Ban(IP 封禁)、Mute(静音)、TempMute(临时静音)、IP-Mute(IP 静音)、Warn(警告)、Kick(踢出)
- 跨服务器同步 — 共享数据库的所有服务器间同步处罚、广播和通知
- 3 种存储后端 — JSON(默认)、H2、MySQL、MariaDB、PostgreSQL
- 模板系统 — 基于梯队的处罚升级与加权模板组
- 管理员工具 — 回滚、历史修剪、锁定、聊天静音、清除聊天、管理员备注
- 调查工具 — 多开检测(DupeIP alt detection)、IP 历史、名称历史、上次会话、GeoIP
- Discord Webhooks — 实时推送关于处罚、多开和管理员操作的通知
- 内置 Web 仪表盘 — 深色主题 UI,支持实时统计、搜索和 REST API
- 插件集成 — PlaceholderAPI、ProtocolLib、Vault、LuckPerms
- 开发者 API — 完整的
StorageProvider+PunishmentManager用于程序化控制 - 导入系统 — 从 LiteBans、AdvancedBan、Vanilla 或 JSON 迁移数据
- Folia 支持 — 完全兼容区域化线程模型
- 命令参数 —
-s静默、-S额外静默、-p公开、-m修改、-d删除、-IIP - 管理员分组 — 可配置的分层权限,支持冷却时间、时长限制和权重层级
- 自定义消息 — MiniMessage 格式,支持十六进制颜色和渐变
- 零运行时依赖 — HikariCP、Gson、H2、MySQL、PostgreSQL 驱动均已打包
快速开始
# 1. 下载最新版本
# 2. 将 CasualBans-<version>.jar 放入你的 plugins/ 文件夹
# 3. 启动服务器(配置文件自动生成)
# 4. 配置存储和功能
# 5. 开始管理
# plugins/CasualBans/config.yml (关键设置)
server:
name: 'my-server'
default-scope: '*'
storage:
driver: JSON # 或 MYSQL, MARIADB, POSTGRESQL, H2
命令
| 命令 | 描述 | 权限节点 |
|---|---|---|
/ban <player> [duration] [reason] |
封禁玩家 | casualbans.ban |
/tempban <player> <duration> [reason] |
临时封禁 | casualbans.tempban |
/ipban <player> [duration] [reason] |
IP 封禁 | casualbans.ipban |
/mute <player> [duration] [reason] |
静音玩家 | casualbans.mute |
/tempmute <player> <duration> [reason] |
临时静音 | casualbans.tempmute |
/warn <player> [reason] |
警告玩家 | casualbans.warn |
/kick <player> [reason] |
踢出玩家 | casualbans.kick |
/unban <player> [reason] |
解除封禁 | casualbans.unban |
/unmute <player> [reason] |
解除静音 | casualbans.unmute |
/history <player> [type] [limit] |
查看处罚历史 | casualbans.history |
/checkban <player> |
检查封禁状态 | casualbans.checkban |
/banlist [page] |
列出活跃封禁 | casualbans.banlist |
/dupeip <player> |
查找多开账号 | casualbans.dupeip |
/lockdown [reason|end] |
服务器锁定 | casualbans.lockdown |
/mutechat [-s] |
切换聊天静音 | casualbans.mutechat |
/casualbans <reload|import|info> |
管理员命令 | casualbans.admin |
权限概览
| 类别 | 关键权限 |
|---|---|
| 处罚 | casualbans.ban, .tempban, .ipban, .mute, .tempmute, .warn, .kick |
| 解除 | casualbans.unban, .unmute, .unwarn (及其 .own 变体) |
| 调查 | casualbans.history, .checkban, .banlist, .dupeip, .iphistory, .geoip |
| 管理员工具 | casualbans.lockdown, .mutechat, .clearchat, .staffrollback, .note |
| 通知 | casualbans.notify, .notify.silent, .notify.broadcast |
| 豁免 | casualbans.exempt, .exempt.ban, .exempt.mute |
| 参数 | casualbans.silent, .extrasilent, .public, .modify, .delete |
| 管理员 | casualbans.admin |
配置
# plugins/CasualBans/config.yml (缩写版)
server:
name: 'casualbans'
default-scope: '*'
storage:
driver: JSON
sql:
host: localhost
port: 3306
database: casualbans
username: root
password: ''
mutes:
enabled: true
command-blacklist: ['/me', '/say', '/msg']
warnings:
expire-after: 30d
actions:
- '3:kick $player Final warning: $reason'
- '4:tempban $player 7d Reached 4 warnings'
durations:
limits:
admin:
permission: casualbans.group.admin
tempban: 6 months
cooldown-ban: 0s
weight: 100
webhooks:
enabled: false
punishment-url: ''
alt-url: ''
staff-url: ''
web:
enabled: false
port: 8291
文档
完整文档请访问
| 页面 | 描述 |
|---|---|
| 安装 | 要求、构建、首次设置 |
| 命令 | 完整的命令参考 |
| 权限 | 所有权限节点 |
| 配置 | config.yml, messages.yml, templates.yml |
| 存储 | JSON 与 SQL 设置 |
| Webhooks | Discord webhook 设置 |
| Web 界面 | 仪表板与 REST API |
| 开发者 API | 编程集成 |
| 导入 | 从 LiteBans、AdvancedBan 等迁移 |
| 常见问题解答 | 常见问题 |
技术栈
- Paper API — Minecraft 服务器 API
- HikariCP — 连接池
- Gson — JSON 序列化
- MySQL Connector — MySQL 驱动
- PostgreSQL JDBC — PostgreSQL 驱动
- H2 Database — 嵌入式 SQL
- Lombok — 减少样板代码
- GeoIP2 — IP 地理位置
- Adventure — 现代 Minecraft 文本 API
许可证
本项目采用 MIT 许可证。详细信息请参见 LICENSE。
支持
- GitHub Issues — Bug 报告与功能请求
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧