命令、时间格式与权限
文档/timemanager/命令、时间格式与权限

命令、时间格式与权限

查阅 TimeManager 的玩家命令、时间别名、冻结与同步行为,以及管理员需要配置的权限节点。

命令规则

TimeManager 的主命令是 /ptime。所有子命令都只能由玩家执行;从控制台执行时,插件会提示该命令只能由玩家使用。没有参数时,/ptime 会显示帮助信息。

命令总览

命令所需权限作用
/ptime set <time>ptime.set设置自己的客户端时间。
/ptime reset无额外节点清除个人时间覆盖,完全恢复为服务器时间。
/ptime freezeptime.freeze冻结当前个人时间。若此前没有覆盖,会从当前服务器时间开始冻结。
/ptime unfreezeptime.freeze取消冻结,让个人时间继续按服务器节奏推进。
/ptime info无额外节点查看服务器时间、个人时间和同步/覆盖/冻结状态。
/ptime help无额外节点显示命令帮助和可用时间格式。

resetinfohelp 没有单独的 TimeManager 权限节点,但服务器的命令权限管理器仍可能影响它们的可见性。权限不足时,插件会在游戏内返回错误提示。

时间格式

/ptime set 接受时间名称或 024000(含边界)的游戏刻:

输入游戏刻含义
sunrise0日出附近。
day1000早晨,通常作为白天起点。
noon6000正午。
sunset12000日落附近。
night14000夜晚。
midnight18000午夜。
数字0–24000直接使用指定的游戏刻。

名称不区分大小写。超过范围、使用负数或输入无法解析的文本时,插件会拒绝命令并提示正确格式。

常用流程

临时切换到白天

/ptime set day

这只改变执行者看到的时间。拍摄完成后,可以用 /ptime reset 回到服务器的当前时间。

固定当前画面

/ptime freeze

冻结后,个人时间不会继续变化。需要恢复推进时执行:

/ptime unfreeze

如果希望完全清除个人覆盖状态,而不是只取消冻结,请使用 /ptime reset

查看状态

/ptime info

信息中会分别列出服务器时间和个人时间,并报告当前是 SYNCHRONIZEDOVERRIDDEN 还是 FROZEN

权限配置

plugin.yml 中两个功能权限的默认值都是 true

权限节点默认值控制内容
ptime.settrue/ptime set
ptime.freezetrue/ptime freeze/ptime unfreeze

如果服务器只允许摄影组或管理组使用个人时间,请在权限插件中关闭普通组继承,再向指定组授予上述两个节点。修改权限后,用没有 OP 的测试账号验证。OP 账号可能绕过权限插件的普通组规则。

TimeManager 不提供让管理员替其他玩家设置时间的命令。/ptime 的执行者始终是当前玩家。排查问题时,请记录玩家拥有的权限节点、具体命令、服务端核心和控制台日志。