JavaScript 工具类

NTE 提供了一些工具类，以便获取一些信息或更简单地实现功能。

调用这个函数会在 Minecraft 日志里打出信息（在游戏内没有信息显示）。可以传入任意多个任意类型的参数。

提供了一些能用来获得版本号的函数，以便让作者能兼容不同版本的不同（如果有）。

函数	说明
`static Resources.getMTRVersion(): String`	MTR 的版本字符串，形如 `1.19.2-3.1.0-hotfix-1`
`static Resources.getNTEVersion(): String`	NTE 的版本字符串，形如 `0.4.0+1.19.2`
`static Resources.getNTEVersionInt(): int`	NTE 的版本的数字形式，以便比较；例如 0.4.0 的是 4000，1.9.1 的会是 19100
`static Resources.getNTEProtoVersion(): int`	NTE 的存档格式版本数字。

TextUtil

MTR 采用了一个 中文部分|English Part||EXTRA 的车站命名方法，所以 NTE 提供了一些函数来把各个部分拆出来。

成员	说明
`static TextUtil.getCjkParts(src: String): String`	获取里面的中文部分。
`static TextUtil.getNonCjkParts(src: String): String`	获取里面的英文部分。
`static TextUtil.getExtraParts(src: String): String`	获取里面的隐藏部分。
`static TextUtil.getNonExtraParts(src: String): String`	获取里面的中文和英文部分。
`static TextUtil.getNonCjkAndExtraParts(src: String): String`	获取里面的英文和隐藏部分。
`static TextUtil.isCjk(src: String): String`	检查一个字符串是否包含中文字。

游戏的运行时间。单位是秒，是递增的，游戏暂停时会停止增长。

本次调用 render 和上次之间的时间差。可以用来计算例如轮子这段时间里应该转过的角度等。

有时候需要计测状态的转换。例如，只在通过某个位置时播放一次广播（因为如果 if (...distance < 300) ctx.play... 的话就会在通过之后每帧都满足条件然后每帧都播放一次，造成几百个广播百花齐放的效果），或者在切换页面后前一秒钟里显示动画。

因为每列车都该有独立的逻辑，您大概会想把它存进列车的 state 里。

new StateTracker() 创建一个 StateTracker。
StateTracker.setState(value: String): void 告诉它目前的状态是这个状态。不调用的时候则是继续保持状态。
StateTracker.stateNow(): String 获取目前的状态。
StateTracker.stateLast(): String 获取上一个状态。没有的话，返回 null。
StateTracker.stateNowDuration(): double 获取目前的状态已经持续了的时间。
StateTracker.stateNowFirst(): boolean 是否是刚刚通过 setState 换进了这个状态。

CycleTracker

这是一个按时间自动循环切换的 StateTracker。

因为每列车都该有独立的逻辑，您大概会想把它存进列车的 state 里。

new CycleTracker(params: Object[]) 创建一个 CycleTracker。params 是它会循环切换的各个状态和每个状态应该持续的时间，单位是秒。例如 new CycleTracker(["route", 5, "nextStation", 5])
CycleTracker.tick(): void 根据现在的时间来更新状态。
CycleTracker.stateNow(): String 获取目前的状态。
CycleTracker.stateLast(): String 获取上一个状态。没有的话，返回 null。
CycleTracker.stateNowDuration(): double 获取目前的状态已经持续了的时间。
CycleTracker.stateNowFirst(): boolean 是否是刚刚通过 tick 换进了这个状态。

RateLimit

有些工作不需要太频繁地进行，例如显示屏可能只需要每秒更新 10 次而不是每帧都更新。所以可以限制它们的频率来提升性能。

因为每列车都该有独立的逻辑，您大概会想把它存进列车的 state 里。

new RateLimit(interval: double) 创建一个 RateLimit。interval 是两次直接应该有的间隔，单位是秒，例如 interval 为 0.1 就代表应该一秒十次。
RateLimit.shouldUpdate(): boolean 距离上次运行之间是否已经经过了足够的时间。将所需的代码用 if (state.rateLimitXXX.shouldUpdate()) { ... } 包起来即可限制它的频率。
RateLimit.resetCoolDown(): void 重置时间，让它马上就可以再次运行。

MTRClientData

MTR 的客户端数据，可以用来读取换乘线路等。参见 MTR 源码 ClientData.java。

由于混淆表原因，没办法直接把客户端的类搬出来让您使用。所以这里有一些辅助方法。

static MinecraftClient.worldIsRaining(): boolean 世界是否在下雨。
static MinecraftClient.worldIsRainingAt(pos: Vector3f): boolean 世界的某个方块处是否正在下雨而且被淋到。
static MinecraftClient.worldDayTime(): int 世界的一天内时间，单位是 Tick。
static MinecraftClient.narrate(text: String): void 调用系统“讲述人”读出一段文本。
static MinecraftClient.displayMessage(message: String,actionBar :boolean): void 在聊天框或在操作栏（物品栏上方）显示一段文本。当 actionBar 为 true 时，显示在操作栏，否则显示在聊天框。