DeathBan - 死亡封禁插件

DeathBan 是一款现代化的 Minecraft 插件，它允许服务器在玩家死亡时进行封禁。你可以为玩家设置生命值，当生命耗尽时他们将被自动封禁。插件支持自定义封禁时间格式，并能根据玩家的权限组分配不同的生命值和封禁时长。

💡核心功能

• 玩家每次死亡会扣除生命值，生命耗尽时自动封禁。
• 支持为不同权限组的玩家设置不同的初始生命值和封禁时长。
• 提供丰富的自定义选项，包括封禁消息、时间显示格式等。
• 支持通过命令转移生命值或复活被封禁的玩家。
• 兼容 PlaceholderAPI，可在其他插件中显示相关数据。

🎮命令列表

基础命令（所有玩家可用）

• /lives [玩家名] - 查看自己或指定在线玩家的生命值及统计信息。
• 权限节点：deathban.command.lives (默认所有人拥有)
• /revive <玩家名> - 将自己的一条生命转移给另一名玩家。如果目标玩家已被封禁，则会解除其封禁。若你只有一条生命，执行此操作后你将被封禁。
• 权限节点：deathban.command.revive (默认所有人拥有)
• /deathban - 查看插件版本信息。
• 权限节点：deathban.command.info (默认所有人拥有)

管理员命令

以下命令需要权限节点 deathban.command.admin (默认 OP 拥有)：

• /deathban reset <玩家名> - 解除玩家的死亡封禁，并将其生命值恢复至最大值。
• /deathban set <玩家名> <生命值> - 设置玩家的生命值数量（若玩家离线，且其权限赋予的生命值与默认值不同，此设置可能不准确）。
• /deathban add <玩家名> <生命值> - 为玩家增加生命值（对离线玩家有效），可以超过其最大生命值上限。
• /deathban ban <玩家名> <时间> - 模拟玩家生命耗尽，立即封禁指定玩家一段时间。
• /deathban reload - 重新加载插件的配置文件。

🔧权限节点

• deathban.bypass - 拥有此权限的玩家不会因死亡而失去生命值。默认无人拥有。
• deathban.command.lives - 允许使用 /lives 命令。默认所有人拥有。
• deathban.command.revive - 允许使用 /revive 命令。默认所有人拥有。
• deathban.command.info - 允许使用 /deathban 命令查看版本。默认所有人拥有。
• deathban.command.admin - 允许使用所有 /deathban 子命令。默认 OP 拥有。
• deathban.notify - 当服务器 DeathBan 插件有更新时，拥有此权限的玩家在进入服务器时会收到通知。

✨配置文件详解

配置文件 (config.yml) 允许你深度自定义插件行为。主要配置项如下：

时间格式 (`time-format`)

用于控制封禁消息中时间的显示方式。提供多种预设和自定义格式。

示例格式：

# 使用 Java 标准日期/时间格式（长短组合）
time-format: 'date-format long long'
# 使用完全自定义的日期格式
# time-format: 'custom-date-format EEE, d MMM yyyy HH:mm:ss'
# 使用相对时间描述（如“5小时2分钟”）
# time-format: 'in 0 months weeks days hours minutes'

消息 (`messages`)

自定义插件发送给玩家的各类消息。支持使用占位符，如 %time%（解封时间）、%player%（玩家名）、%lives%（剩余生命）等。

• ban：玩家被封禁时在封禁界面显示的消息。
• kick：玩家因死亡被踢出服务器时看到的聊天栏消息。
• lives：查看生命值时的消息，分为查看自己 (self) 和查看他人 (other) 两种。

复活设置 (`revive`)

控制 /revive 命令的相关行为。

• revive-confirm: 10 - 当玩家因转移生命而将导致自己被封禁时，给予其 10 秒的确认时间。设为 0 则禁用确认。
• revive-lives: all - 玩家被复活后获得的生命值。可选值：
• all：恢复至最大生命值。
• 正整数（如 3）：获得指定数量的生命值。
• 负整数（如 -4）：获得比最大生命值少指定数量的生命值（例如最大10条命，设置-4，则获得6条命）。

默认设置 (`default`)

为新玩家或没有特定权限的玩家设置默认规则。

• lives: 10 - 默认生命值数量。
• time: 10h - 默认封禁时长。也可以使用列表来设置递增的封禁时间。

  time:
    - 10m  # 第一次封禁10分钟
    - 1h   # 第二次封禁1小时
    # 如果封禁次数超过列表长度，将被永久封禁（100年）

• commands: - （可选）玩家被封禁时执行的命令列表。

权限组 (`groups`)

你可以为拥有特定权限的玩家定义不同的生命值和封禁规则。权限组支持设置优先级 (priority)，当玩家拥有多个组的权限时，将采用优先级最高的配置。

配置示例：

groups:
  donator:
    permission: deathban.group.donator
    lives: 20
    time: 5h
    priority: 1
  staff:
    permission: deathban.group.staff
    lives: 15
    time: 1h
    priority: 2

⭐PlaceholderAPI 支持

如果安装了 PlaceholderAPI，可以使用以下占位符：

• %deathban_max_lives% - 玩家在被封禁前可拥有的最大生命值。
• %deathban_bans% - 玩家已被死亡封禁的次数。
• %deathban_deaths% - 玩家自上次封禁以来的死亡次数（每次封禁后重置）。
• %deathban_lives% - 玩家在被封禁前还能死亡的次数（剩余生命值）。