PlayerTimer

模组

· 作者 BlackShadowHRD

该项目添加了一个计时器,可以由玩家或命令方块启动。计时器对每个玩家是独立的,每位玩家都可以拥有自己的计时器运行。这是一个仅服务器端的安装,用于运行小游戏和限时挑战。

0 本站下载 0 关注 更新于 4 个月前

最新 1.4.0 · 26.2 · Fabric

一键开服(送7天)

PlayerTimer Fabric

一个为 Minecraft 服务器和单人世界提供独立玩家计时器的 Fabric 模组。

当前 Fabric 构建版本:

  • Minecraft 26.2
  • Fabric Loader 0.19.3 或更高版本
  • Fabric API 0.153.0+26.2
  • Java 25 或更高版本

每位玩家拥有独立的计时器,支持以下功能:

  • 正数计数
  • 倒序计数
  • 暂停/恢复
  • 独立隐藏或显示
  • 通过命令或命令方块触发

适用场景:

  • 小游戏
  • 密室逃脱
  • 限时挑战
  • 跑酷
  • 速通
  • 多人活动
  • 冒险地图

功能特性

  • 每位玩家独立的计时器
  • 正数和倒数模式
  • Brigadier 命令支持
  • 暂停和恢复支持
  • 计时器可见性控制
  • 倒计时完成通知
  • 完成时音效反馈
  • 多种时长输入格式
  • 兼容使用 /execute as 的命令方块
  • 用于管理计时器的管理员命令
  • 重启和崩溃后计时器数据持久化
  • 专为 Fabric 打造
  • 支持 Java 25

命令

命令 描述
/playertimer startcountup 使用配置的默认颜色开始正数计时
/playertimer startcountup <color> 开始彩色正数计时
/playertimer startcountdown 使用配置的默认颜色开始 5 分钟倒计时
/playertimer startcountdown <duration> 使用配置的默认颜色开始自定义时长的倒计时
/playertimer startcountdown <duration> <color> 开始彩色倒计时
/playertimer pause 暂停计时器
/playertimer resume 恢复已暂停的计时器
/playertimer stop 停止计时器并将其重置为 00:00
/playertimer reset 将计时器重置为 00:00
/playertimer hide 隐藏计时器显示
/playertimer show 显示计时器显示
/playertimer admin clear <player> 清除玩家 <player> 的计时器(需要 op 等级 2+)
/playertimer admin clearall 清除所有玩家的计时器(需要 op 等级 2+)

时长格式

倒计时命令接受多种输入格式。

1. 秒数

/playertimer startcountdown 300

开始 300 秒倒计时。


2. 分:秒 (mm:ss)

/playertimer startcountdown 05:30

开始 5 分 30 秒倒计时。

规则:

  • mm 必须在 0 到 59 之间
  • ss 必须在 0 到 59 之间

示例:

05:30   ✓ 有效
59:59   ✓ 有效
60:00   ✗ 无效
05:60   ✗ 无效
99:99   ✗ 无效

3. 时:分:秒 (hh:mm:ss)

/playertimer startcountdown 01:40:05

开始 1 小时 40 分 5 秒倒计时。

规则:

  • mm 必须在 0 到 59 之间
  • ss 必须在 0 到 59 之间

示例:

01:40:05   ✓ 有效
10:59:59   ✓ 有效
01:60:05   ✗ 无效
01:40:60   ✗ 无效

4. 文本格式

/playertimer startcountdown 1h40m5s
/playertimer startcountdown 10m
/playertimer startcountdown 45s
/playertimer startcountdown 2h
/playertimer startcountdown 1h5s

支持:

  • 小时 (h)
  • 分钟 (m)
  • 秒 (s)

可以任意组合使用。

规则:

  • m 必须在 0 到 59 之间
  • s 必须在 0 到 59 之间

示例:

1h40m5s   ✓ 有效
10m30s    ✓ 有效
59m59s    ✓ 有效
1h60m     ✗ 无效
10m90s    ✗ 无效
10s49m    ✗ 无效

最大时长

允许的最大时长为:

2147483647 秒

约为:

68 年

此限制存在是因为计时器内部使用 Java int 值。


计时器颜色

计时器可以选择性地附带颜色参数启动。

支持的颜色

颜色
black (黑色)
dark_blue (深蓝色)
dark_green (深绿色)
dark_aqua (深青色)
dark_red (深红色)
dark_purple (深紫色)
gold (金色)
gray (灰色)
dark_gray (深灰色)
blue (蓝色)
green (绿色)
aqua (青色)
red (红色)
light_purple (浅紫色)
yellow (黄色)
white (白色)

示例:

/playertimer startcountup red
/playertimer startcountdown 5m gold
/playertimer startcountdown 01:30 dark_blue

计时器状态

模组内部使用有限状态机跟踪计时器状态。

状态 含义
READY 计时器存在但尚未开始
RUNNING 计时器正在运行
PAUSED 计时器暂时中止
STOPPED 计时器被手动停止
FINISHED 倒计时归零

这防止了无效操作,例如:

  • 恢复已完成的计时器
  • 同时启动多个计时器
  • 恢复已被停止的计时器

可见性行为

计时器可见性与计时器状态无关。

操作 结果
启动计时器 计时器变为可见
暂停计时器 计时器保持可见
恢复计时器 计时器变为可见
停止计时器 计时器状态不变
重置计时器 计时器保持可见
隐藏命令 计时器变为隐藏
显示命令 计时器变为可见

倒计时完成

当倒计时归零时:

  • 计时器自动停止
  • 计时器进入 FINISHED 状态
  • 玩家收到通知
  • 播放钟声效果

命令方块支持

可以通过 Minecraft 的 execute 命令利用命令方块触发命令。

示例:

execute as @p run playertimer startcountdown 5m

这允许:

  • 按钮
  • 压力板
  • 红石系统
  • 区域触发器
  • 冒险地图集成

持久化

所有计时器都会保存到磁盘,并在服务器重启或崩溃恢复时还原。计时器数据存储于:

config/playertimer/timers.json

配置文件存储于:

config/playertimer/config.toml

当前配置支持:

defaultColor = "WHITE"

保存时机包括:

  • 每次计时器状态更改时(启动、暂停、恢复、停止、重置、隐藏、显示、完成)
  • 每 30 秒自动保存
  • 玩家断开连接时
  • 服务器关闭时

重启后恢复计时器时,无论其之前是否正在运行,状态都会设置为 PAUSED——因为服务器未进行 tick 更新,计时器不会推进。如果计时器由玩家直接启动,则由玩家负责恢复它。如果计时器由小游戏或冒险地图启动,则由游戏负责恢复它。

失败行为

加载时: 如果计时器条目包含损坏的 UUID,则跳过该条目并记录警告。如果文件完全无法读取,将抛出 RuntimeException,导致模组无法初始化。

保存时: 如果文件无法写入,将记录错误并抛出 RuntimeException。由于计时器被视为关键基础设施(例如用于小游戏),这将导致服务器崩溃,而不是以未保存的状态继续运行。


构建

要求

  • Java 25
  • Gradle
  • Fabric Loader 0.19.3 或更高版本
  • Fabric API 0.153.0+26.2

构建

./gradlew build

编译后的 jar 包将出现在以下目录:

build/libs/

版本控制

PlayerTimer 使用以下版本方案:

[mod-version]

示例:

1.4.0

Minecraft 兼容性在 fabric.mod.json、gradle.properties 以及每个版本的更新日志中跟踪。


计划变更

  • 配置选项:
    • 默认倒计时时长
    • 倒计时结束时 audible alarm(声音警报)的开关
    • 倒计时结束前每秒蜂鸣提示的开关
    • 倒计时结束前蜂鸣提示的持续时间
    • 保存时的失败行为(关键 → 服务器崩溃,非关键 → 记录日志并继续)
  • API —— 提供一个接口,允许游戏和冒险地图的开发者直接从代码中访问计时器功能

更新日志

1.4.0 - Minecraft 26.2

  • 更新 Fabric 目标至 Minecraft 26.2
  • 更新 Fabric Loader 要求至 0.19.3 或更高版本
  • 更新 Fabric API 依赖至 0.153.0+26.2
  • 确认 Fabric 模块可针对 Minecraft 26.2 依赖集成功构建

26.1.x-1.2

  • 计时器现在可在服务器重启和崩溃后保持持久化
  • 添加了需要 op 等级 2 权限的管理员命令(clear, clearall)
  • 将计时器逻辑移至 PlayerTimer 领域模型
  • 用领域操作(start, pause, resume, stop, reset)替换了贫血 setter
  • 引入 TimerOperationResult 枚举,替代基于异常的流程控制
  • 从 PlayerTimerMod 中提取出 PlayerTimerCommand 类
  • 添加通过 Gson 实现 JSON 持久化的 TimerStore
  • 添加定期自动保存和状态变更时保存
  • 通过 TimerCommandContext 统一命令来源的消息传递
  • 玩家断开连接时现在会从内存中移除计时器并触发保存

26.1.x-1.1

  • 添加彩色计时器支持
  • 为计时器启动命令添加可选的颜色参数

26.1.x-1.0

  • 首次 Fabric 发布
  • 将 PlayerTimer 从 Paper 移植到 Fabric
  • 添加独立于玩家的计时器
  • 添加倒计时和正计时模式
  • 添加计时器状态系统
  • 添加可见性系统
  • 添加 Brigadier 命令支持
  • 添加命令方块兼容性
  • 添加支持多种格式的持续时间解析
  • 添加动作栏计时器显示
  • 添加倒计时完成音效
  • 添加 Java 25 支持
  • 将计时器逻辑重构至 PlayerTimerService

许可证

MIT License

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源