DeathBan 是一款现代化 Minecraft 插件，用于在玩家死亡时对其进行封禁。您可以设置玩家在被封禁前拥有的生命数量，并为封禁消息使用自定义时间格式。此外，还可以根据玩家的权限赋予不同的封禁时间和生命值。

🎮 命令

• /revive <player> deathban.command.revive：将您的一条命转移给另一位玩家。如果他们被死亡封禁，将会被解封。如果您只有一条命，您将被死亡封禁。
• /lives [player] deathban.command.lives：查看您自己或其他在线玩家的生命数量和统计信息。
• /deathban deathban.command.info：查看插件版本。

以下命令需要 deathban.command.admin 权限：

• /deathban reset <player>：移除玩家的死亡封禁，并将其生命值恢复到最大值。
• /deathban set <player> <lives>：设置玩家的生命值（如果玩家离线，并且拥有通过权限赋予的不同生命值，则可能无法正确设置）。
• /deathban add <player> <lives>：增加玩家的生命值（适用于离线玩家），可以超过其最大生命值。
• /deathban ban <player> <time>：封禁玩家，如同其生命值耗尽一样。
• /deathban reload：从配置文件重新加载插件。

🔑 权限

• deathban.bypass 默认：无：不会失去生命值。
• deathban.command.lives 默认：所有人：/lives 命令。
• deathban.command.revive 默认：所有人：/revive 命令。
• deathban.command.info 默认：所有人：/deathban 命令。
• deathban.command.admin 默认：OP：/deathban 子命令。

⚙️ 配置

# options:
# date-format SHORT/MEDIUM/LONG/FULL SHORT/MEDIUM/LONG/FULL
# date/time formats are any of short/medium/long/full, twice, separated by a space
# the first is the length of the date format and the second, the time format.
# custom-date-format 
# these give you more control over your date formats
# documentation for custom date formats: https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html
# in  [months] [weeks] [days] [hours] [minutes] [seconds]
# this will show something like "5 hours, 2 minutes" for "in 2 days hours minutes seconds"
# you can include a ? like "minutes?" so that it only shows if the next greatest time period is zero
# for example,  "in minutes seconds?" can show "2 minutes" or "59 seconds" but not "1 minute 4 seconds"
# The types affect the formatting, these are what they look like
# Type 1: "5 hours, 3 minutes and 20 seconds"
# Type 2: "5 hours, 2 minutes, 1 second"
# Type 3: "1 hour 5 minutes"
# Type 4: "1h, 5m and 3s"
# Type 5: "4h, 2m, 2s"
# Type 6: "3h 7m 6s"
# Type 7: "8h2m4s"
#
# you will want different formats depending on how long you want your deathbans to be
# if you don't quite understand, there are many examples
time-format: 'date-format long long'
# time-format: 'date-format full medium' # Sunday, 20 January 2019, 22:50:00
# time-format: 'custom-date-format dd-MM-yyyy HH:mm:ss' # 2001-1-7 15:42:28
# time-format: 'custom-date-format EEE, d MMM yyyy HH:mm:ss' # Wed, 4 Jul 2001 12:08:56
# time-format: 'date-format long short' # 20 January 2019, 22:47
# time-format: 'in 0 months weeks days hours minutes' # 5 hours and 1 minute
# time-format: 'in 5 weeks days hours? minutes?' # 1w, 4h

messages:
  ban: |-
    You were banned because of your death.
    You will be unbanned at %time%.
  kick: |-
    You died and have been banned.
    You will be unbanned at %time%.
  lives:
    # you can use any of the following placeholders:
    # %player% player name
    # %lives% number of deaths until ban
    # %maxlives% maximum number of lives
    # %deaths% number of deaths since the last ban
    # %bans% amount of times banned
    self: |-
      &eYou have %lives%/%maxlives% lives remaining.
      &eYou have been banned %bans% time(s).
    other: |-
      &6Player %player%
      &e%lives%/%maxlives% lives remaining.
      &eBanned %bans% time(s).
    invalid-player: '&cInvalid player'
  revive:
    invalid-player: '&cInvalid player'
    max-lives: '&cThat player is at their maximum amount of lives'
    revived: '&a%player% has been unbanned. You now have %lives% live(s).'
    transferred: '&aYou have transferred a life to %player%. You now have %lives% lives'
    confirm: '&eYou will be death banned if you do this! If you are sure, type the command again.'
    self: '&cYou cannot transfer a life to yourself!'

# if a player will be death banned by /reviving a player, give them this amount of seconds to confirm
# set to 0 to disable confirming
revive-confirm: 10

# how many lives people should have when they are banned and then revived
# all - they have their maximum amount of lives
# 1, 2, 3 (any positive number) - they will have exactly this amount of lives
# -1, -2, -3 (any negative number) - they will have this fewer lives than the maximum (if the max lives is 10, and you set this to -4, they will have 6 lives when revived).
revive-lives: all

# if true, players with the permission deathban.notify will receive notifications when they join
# to update if the server is on an older version of DeathBan.
notify-update: true

database:
  # interval to save changes to the database file
  flush-interval: 30s

default:
  # how many deaths they can have until they die
  lives: 10
  # how long their death ban is
  # alternatively you can use a list for different death bans as a player is banned more times
  # if the player has more bans than the list, they will be banned permanently (for 100 years)
  time: 10h
  # time:
  # - 10m
  # - 1h
  # optionally you can include a list of commands to run on deathban
  # commands:
  # - 'say %player% has been death banned!'

# if a player has permission for multiple groups,
# the one with the highest priority will be used.
# groups also support commands
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%：玩家在被死亡封禁之前还可以死亡的次数。

源代码：https://github.com/okx-code/DeathBan