Trail Timer

插件

· 作者 itsLarss_

将试炼刷怪笼的冷却时间从原版 30 分钟缩短为可配置时长——完全在服务器端运行,无需客户端模组。

0 本站下载 0 关注 更新于 3 周前

最新 1.2.0 · 26.3 · Bukkit / Folia

一键开服(送7天)

⏱ TrialTimer

可配置的试炼刷怪笼冷却时间 —— 因为 30 分钟实在太太太长了。


? 功能简介

原版 Trial Spawner(试炼刷怪笼)在波次完成后具有硬编码的 30 分钟冷却时间。 TrialTimer 允许你将其设置为任意时长——如果需要,甚至可以缩短至几秒钟。

无需客户端模组。完全在服务器端运行。

当刷怪笼完成冷却后,附近玩家会收到一条广播消息,告知他们刷怪笼已准备好再次战斗。


⚙️ 工作原理

30 分钟的规则是 Minecraft 源代码中硬编码的,因此数据包无法修改它。 TrialTimer 通过更改刷怪笼的 cooldownEndsAt 值来绕过这一限制: 当刷怪笼进入冷却状态时,插件会用你配置的时间覆盖该值。 Minecraft 随后读取该值并判定冷却结束 —— 简单且高效。

  • Paper / Purpur / Folia: 使用 Bukkit API (TrialSpawner#setCooldownEnd)
  • Spigot: API 没有提供设置冷却结束的方法,因此插件会自动回退到反射机制
  • Folia: 扫描任务在区域调度器上运行

? 安装指南

  1. 确保你的服务器运行的是 Minecraft 26.x 和 Java 25
  2. 将 TrialTimer-x.x.x.jar 放入 plugins/ 文件夹
  3. 重启服务器
  4. 编辑 plugins/TrialTimer/config.yml
  5. 运行 /trialtimer reload

? config.yml

# 冷却持续时间(单位:分钟)。支持小数(例如 0.5 = 30 秒)。
# 原版默认值:30 分钟
cooldown-minutes: 5.0

# 插件消息的语言。
# 可用选项:en, de
language: en

# 当试炼刷怪笼完成冷却时,向附近玩家发送广播消息。
broadcast:
  enabled: true
  radius: 64  # 以方块为单位

# 调试模式 —— 在控制台中记录每次冷却时间的修改。
debug: false

快速参考 —— 分钟 → 刻

Minutes Seconds Ticks
0.5 30s 600
1 60s 1,200
5 300s 6,000
10 600s 12,000
30 1800s 36,000 (原版)

? 命令

Command Description Permission
/trialtimer help 显示命令概览 trialtimer.use
/trialtimer info 显示当前冷却时间 trialtimer.use
/trialtimer reload 重载配置 + 语言文件 trialtimer.reload

别名: /tt


? 广播

当试炼刷怪笼完成冷却时,配置半径内的所有玩家都会收到一条消息:

[TrialTimer] A Trial Spawner at 42, 63, -128 is ready to fight again!

该消息可在语言文件中完全自定义(lang/messages_en.yml / lang/messages_de.yml)。


? PlaceholderAPI

TrialTimer 支持 PlaceholderAPI(可选 —— 即使不使用也能正常工作)。

Placeholder Description
%trialtimer_cooldown_minutes% 配置的冷却时间(分钟)
%trialtimer_cooldown_seconds% 配置的冷却时间(秒)
%trialtimer_cooldown_ticks% 配置的冷却时间(刻)

可在记分板、全息图或任何支持 PlaceholderAPI 的插件中使用这些占位符。


? 语言支持

TrialTimer 内置了英语和德语。 通过在 config.yml 中设置 language: de 进行切换。

语言文件保存在 plugins/TrialTimer/lang/ 目录下,可以自由编辑。


? 兼容性

Software Supported
Paper 1.21.x - 26.x ✅
Purpur 1.21.x - 26.x ✅
Bukkit 26.x ✅
Spigot 26.x ✅
Folia 26.x ✅
PlaceholderAPI ✅ (可选)

注意: 版本 1.2.0 需要 Minecraft 26.x 和 Java 25。 对于 Minecraft 1.21.x(仅限 Paper/Purpur),请使用 TrialTimer 1.1.0。 如果遇到任何问题,请启用 debug: true —— 它会记录每次冷却时间的更改。


? 许可证

MIT —— 免费使用、分支及再分发。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源