DragonTimer - 龙族计时器

当巨龙苏醒的时刻来临……！DragonTimer 是一款用于管理末影龙定时重生的插件，可作为 DragonSlayer 的扩展，也可独立运行。巨龙只会在特定时间、当世界中有足够玩家时生成；若玩家不足，还可移除现有巨龙。

💡核心特性

• 双重模式：可作为 DragonSlayer 的扩展运行，也可完全独立使用。
• 定时重生：可配置末影龙的重生时间点（具体时刻）。
• 重生位置：可配置末影龙的重生坐标。
• 逐一生成：OneByOne 功能确保每次重生时间只生成一条龙。
• 人数要求：可配置触发重生所需的最低玩家数量。
• 战斗时限：可为龙战设置时间限制。
• 计时显示：提供重生倒计时显示。
• 击杀指令：可在击杀龙时执行服务器指令。
• 门户守护：可防止巨龙守卫 0/0 坐标的末地传送门。
• 多龙支持：支持同时生成多条龙。
• 多世界支持：支持多个世界，且可为每个世界单独配置。
• 变量支持：支持 PlaceholderAPI（需要 PAPI 2.10.7 或更高版本）。
• 动态移除：当玩家数量不足时，插件可移除现有巨龙。
• 水晶刷新：支持水晶刷新（需要 DragonSlayer！）。
• 可配置生命值：在独立模式下可调整巨龙的生命值。
• 可配置名称：在独立模式下可设置巨龙名称，支持多个名称。
• 血条支持：为 MC 1.9+ 提供血条支持（当存在多条龙时替换原版血条，仅限独立模式）。
• 更多功能：还有更多可配置选项……

🎮安装步骤

• 将 DragonTimer.jar 放入服务器的 plugins 文件夹。
• 启动服务器。
• 使用 /setspawn 命令将世界添加到插件管理中。
• 使用命令或编辑配置文件进行配置（见下文）。
• 重启服务器或使用 /reload 命令重载配置。

🎮配置说明

配置文件主要结构如下

dragon:
  _default: # 默认值
    name: '&5Smaug&r' # 巨龙名称
    maxdragons: 1 # 每个世界最多同时存在的龙数量
    minplayers: 1 # 触发重生所需的最低玩家数
    health: 200 # 巨龙生命值（仅独立模式有效）
    removedragons: false # 当玩家少于 minplayers 时是否移除龙
    timelimit: 0 # 龙战持续时间（分钟），0 为禁用
    removedelay: 3 # 移除龙之前的延迟时间（分钟），会先显示警告
    command: 'ping' # 击杀龙后执行的命令（仅独立模式），可使用 $player 和 $world 变量，多个命令用 ; 分隔
    noguarding: false # 设为 true 可阻止龙飞向 0/0 坐标
    spawntimes: '12:00,13:00,14:00,15:00' # 重生时间点列表（24小时制）
    onebyone: false # 是否每次只生成一条龙
    timerdisplay: true # 是否启用倒计时显示
    darkness: true # 是否在战斗时启用黑暗效果（仅独立模式，仅限 1.13+）
    dsl_refreshdelay: -1 # 水晶刷新延迟（分钟），-1 为关闭，需要 DragonSlayer！
global:
  keepchunks: true # 是否保持重生区块加载（需要更多 CPU/服务器资源）
messages: # 各类提示消息，可使用 $world, $minplayers 等变量
  notenoughplayers: 'There are not enough players on map $world to spawn dragons! There should be at least $minplayers players!'
  dragonstospawn: 'There is a dragonrespawn ongoing! It will spawn $amount new dragons in world $world! (with $delay minutes delay)'
  dragonsremwarn: 'Dragons in world $world may be removed in $removedelay minutes because of too few players!'
  dragonsremoved: 'Dragons in world $world have been removed because of too few players!'
  timelimitwarn: 'Hurry up! Dragons in world $world may be removed in $removedelay minutes! Battletime is almost over!'
  timelimit: 'Dragons in world $world have been removed! You did not finish the fight!'
  timertext: 'Respawn in:'
  timerline: '$hours : $minutes :'
spawnpoint: # 每个世界的重生坐标
  world_the_end:
    x: 0
    y: 96
    z: 0

配置须知

• 所有世界名称在配置中必须为小写。
• 若手动修改配置，请注意格式。
• 部分设置（如 health, name）在作为 DragonSlayer 扩展时无效。
• 与 DragonSlayer 联用时，需在 DragonSlayer 配置中将 respawndelay 设为 -1。
• 支持混合模式：部分世界使用 DragonSlayer 的重生机制，部分使用 DragonTimer。

🔧命令与权限

权限列表

• dragontimer.admin：管理插件设置。
• dragontimer.info：查看插件信息。
• dragontimer.forcerespawn：手动触发重生。

命令列表

所有命令均可以 /dragontimer、/dtimer 或 /dti 开头。

• getspawn [世界名]：显示指定世界的巨龙重生点。
• gettime [世界名]：显示指定世界的重生时间列表。
• setspawn [x y z [世界]]：设置重生点并启用该世界。
• remspawn [世界]：从列表中移除该世界。
• addtime hh:mm [世界]：为指定世界添加一个重生时间（24小时制）。
• remtime hh:mm [世界]：从指定世界的列表中移除一个时间。
• minplayers ['数量' [世界]]：设置或显示触发重生所需的最低玩家数。
• maxdragons ['数量' [世界]]：设置或显示指定世界将生成的龙的数量。
• health ['数量' [世界]]：设置或显示巨龙生命值（仅独立模式有效，与 DragonSlayer 联用时生命值由 DragonSlayer 控制）。
• removedragons ['false' 或 'true']：设置或显示玩家不足时是否移除现有龙。
• removedelay ['数量' [世界]]：设置或显示移除龙的延迟时间。
• timelimit ['数量' [世界]]：设置龙战的最大时长（分钟），0 为禁用。
• killdragons [世界]：杀死指定世界中所有现有的龙。
• reload：重载插件配置。
• forceallrespawn：立即触发所有世界的重生。

✨PlaceholderAPI 变量

若安装了 PlaceholderAPI，可使用以下变量：

• %dragontimer_nexttime%：显示所有世界的下一个重生时间。
• %dragontimer_nextmap%：显示下一个将重生的世界。
• %dragontimer_countdown%：显示所有世界下一个重生时间的倒计时。
• %dragontimer_playersnexttime%：显示玩家所在世界的下一个可用重生时间。
• %dragontimer_playerscountdown%：显示玩家所在世界下一个重生时间的倒计时。
• %dragontimer_countdown_[世界]%：显示指定世界下一个重生时间的倒计时。

❓重要信息与兼容性

版本支持

• 插件已在 1.9 至 1.21.4 版本中测试。
• 理论上支持 1.8，但未经过全面测试；作为 DragonSlayer 扩展时，1.8 应无问题。
• 不兼容 1.12，但兼容 1.12.2（因为 1.12 缺少部分必要代码）。
• 如果你确认某个版本是否兼容，请告知开发者。

使用须知

• 插件只会在通过 /setspawn 设置过的世界中生效。
• 与 DragonSlayer 联用时，请确保正确配置 DragonSlayer 的 respawndelay 选项。

⭐反馈与支持

• 欢迎在讨论区留下你的评价、评论和建议。
• 如果发现 Bug，请通过私信或讨论区反馈。
• 请勿在评论区域发布支持请求或问题报告，请使用讨论区。
• 如果你愿意为插件开发提供支持，欢迎捐赠。