AdventureBan v1.0.0

惩罚类型

命令标记 (Flags)

时长格式

支持灵活的时长表达，可组合使用：

• 30s - 30 秒
• 10m - 10 分钟
• 2h - 2 小时
• 7d - 7 天
• 2w - 2 周
• 1mo - 1 个月
• 1y - 1 年
• 1d12h30m - 1天12小时30分钟 (组合)
• permanent - 永久

Spigot / Paper / Purpur 端

1. 将 AdventureBan-Spigot-1.0.0.jar 放入服务器的 plugins/ 目录
2. 启动服务器，插件会自动生成默认配置文件
3. 编辑 plugins/AdventureBan/config.yml，设置数据库和服务器名称
4. 使用 /adventureban reload 重载配置

Velocity 代理端

1. 将 AdventureBan-Velocity-1.0.0.jar 放入 Velocity 的 plugins/ 目录
2. 启动代理服务器，自动生成 config.json 和 messages.json
3. 编辑配置文件，确保数据库设置与 Spigot 端一致
4. 重启代理服务器

跨服配置要点

• 所有服务器必须连接同一数据库（推荐 MySQL）
• 每个服务器需要设置唯一的 server-name
• 同步通过数据库 adventureban_sync 表自动完成
• 可选：在 Velocity 端部署以实现代理级别拦截

# 当前服务器名称 (跨服同步标识)
server-name: "lobby"

# 数据库配置
database:
  type: h2          # h2 或 mysql
  mysql:
    host: localhost
    port: 3306
    database: adventureban
    username: root
    password: ""
    ssl: false

# 跨服同步轮询间隔 (ticks)
sync:
  interval-ticks: 40

# 默认行为
defaults:
  silent: false

# 关联账号检测
alt-detection:
  notify: true       # 加入时通知管理员
  auto-ban: false    # 自动封禁关联账号

# 禁言时屏蔽的命令
mute:
  blocked-commands:
    - msg
    - tell
    - whisper
    - r
    - reply
    - me
    - say

# 锁服设置
lockdown:
  bypass-op: true

prefix: "&6[AdventureBan] "

# 封禁踢出界面 (支持 \n 换行)
ban-screen: "&c&l你已被封禁\n\n&7原因: &f$reason\n..."

# 广播消息
broadcast-ban: "&c$player &7被 &e$executor &7封禁了..."

# 禁言提示
muted-message: "&c你已被禁言! &7剩余: &f$remaining..."

# 变量: $player, $executor, $reason, $duration, $remaining, $date, $id, $server, $type

模板示例 - templates.yml

templates:
  cheating:
    type: ban                    # 惩罚类型
    tiers:
      - duration: 7d             # 第一次: 7天封禁
        reason: "作弊行为 (第一次)"
      - duration: 30d            # 第二次: 30天封禁
        reason: "作弊行为 (第二次)"
      - duration: permanent      # 第三次: 永久封禁
        reason: "作弊行为 (永久封禁)"

  toxic:
    type: mute
    group: chat-offense          # 组名 (同组共享进度)
    tiers:
      - duration: 1h
        reason: "辱骂 (第一次)"
      - duration: 1d
        reason: "辱骂 (第二次)"
      - duration: permanent
        reason: "辱骂 (永久禁言)"

  rule-break:
    type: warn
    tiers:
      - reason: "违反规则 (警告)"
      - reason: "再次违规"
        commands:                 # 触发附加命令
          - "tempban $player 1d 多次违规"

# 模板组 (同组模板共享违规计数)
groups:
  chat-offense:
    - toxic
    - spam

工作原理

1. 执行 /ban Steve cheating
2. 系统查找名为 cheating 的模板
3. 计算 Steve 在该模板（及同组模板）中的历史违规次数
4. 根据违规次数选择对应的 Tier（等级）
5. 自动使用 Tier 中定义的时长和原因执行惩罚
6. 如果 Tier 中定义了 commands，自动执行附加命令

discord:
  enabled: true
  url: "https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN"
  username: "AdventureBan"

每种惩罚类型使用不同的颜色：

• 封禁/IP封禁 - 🔴 红色
• 禁言/IP禁言 - 🟠 橙色
• 警告 - 🟡 黄色
• 踢出 - 🔵 蓝色

AdventureBan/
├── common/           # 共享模块
│   ├── model/        # Punishment, PunishmentType, PlayerRecord
│   ├── database/     # DatabaseManager (H2/MySQL, HikariCP)
│   ├── template/     # Template, TemplateManager
│   └── util/         # DurationParser, UUIDUtil, CommandFlagParser
├── spigot/           # Spigot/Paper 端
│   ├── command/      # MainCommand (所有命令)
│   ├── listener/     # Login, Join, Chat, CommandBlock 监听
│   ├── manager/      # PunishmentManager, TemplateManager, SyncService
│   ├── config/       # ConfigManager, Messages
│   └── hook/         # PlaceholderAPIHook, DiscordWebhook
└── velocity/         # Velocity 代理端
    ├── command/       # VelocityBanCommand, VelocityAdminCommand
    ├── listener/      # VelocityLoginListener, VelocityChatListener
    ├── manager/       # VelocitySyncService
    └── config/        # VelocityConfig

v1.0.0 - 初始版本

• 完整的惩罚系统: 封禁、禁言、警告、踢出、IP封禁、IP禁言
• 跨服同步 (通过数据库同步表)
• 模板/阶梯惩罚系统
• 关联账号 (Alt) 检测和通知
• 数据库: H2 内嵌 + MySQL/MariaDB
• PlaceholderAPI 集成
• Discord Webhook 通知
• Velocity 代理端完整支持
• 员工回滚 (staffrollback)
• 服务器锁定 (lockdown)
• 完整的权限系统 (命令/通知/豁免/绕过)
• 自定义消息和踢出界面
• 命令标记: 静默、全局、IP、删除、服务器范围