CasualBans

插件

· 作者 Kyssta

管理惩罚的最佳插件

0 本站下载 0 关注 更新于 4 个月前

最新 v1.0.0 · 26.1 · Bukkit / Paper

一键开服(送7天)

CasualBans

面向 Paper 1.21+ 的现代、功能丰富的跨服务器处罚管理系统

文档


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 删除、-I IP
  • 管理员分组 — 可配置的分层权限,支持冷却时间、时长限制和权重层级
  • 自定义消息 — 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 等迁移
常见问题解答 常见问题

技术栈

许可证

本项目采用 MIT 许可证。详细信息请参见 LICENSE。

支持

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源