v0.2.2

请注意，本项目仍处于早期开发阶段，因此仍有可能存在许多未知的 bug，请在使用前注意备份！

ATTENTION: This project is still under EARLY development stage. Therefore, many unknown bugs may still exist. BACK UP your world!

详细更新信息见此。

新内容 New

架构 Architecture

• 正式将自行研发的命令构建 API Nickel API 以内置模组的方式内嵌到天圆地方中，版本号为 v0.0.1，版本代码为 -1024。v0.0.x 和负数的版本代码均表示 Nickel API 处于内嵌未作为独立模组发布的阶段；
• 加入 GeoCompatLoader，用于统一处理大部分与第三方模组的兼容逻辑；
• 模组构建系统迁移到 Cleanroom 的 ForgeDevEnv 模板，构建所需 Java 版本升级到 Java 25；
• 单元测试所需的 JUnit 版本从 4.x.x 升级到 5.x.x。

Nickel API

• 正式从天圆地方的 API 分离，命名为镍 API（Nickel API）；

• 加入了如下命令节点：

  • 实体类型参数节点（Entity Entry Selector Node）；
  • 流体参数节点（Fluid Selector Node）；
  • 矿物词典参数节点（Ore Dictionary Selector Node）；
  • 双精度浮点数三维向量参数节点（Vec3d Node）；
  • For-Each 节点（For-Each Node）；
  • 物品堆参数节点（Item Stack Node）；
  • 维度参数节点（Dimension Node）；
  • 方块状态参数节点（Block State Node）；
  • 命令运行节点（Run Command Node）；
  • 重定向运行命令节点（Redirect Command Node）；

• 加入了工具类 Matchers，提供了一些基本的智能匹配逻辑；

• 为 ValidChecker 加入了一些内置的参数验证逻辑；

• 字符串节点（String Node）允许白名单、黑名单和正则过滤；

• 为参数节点加入了装饰器（Decoration）功能，允许在参数完成解析后进一步处理参数；

• 加入了文档生成功能，支持命令文档生成、基本错误提示、参数名称和注释及国际化等。

命令 Commands

• 加入了 /fluidphysics 命令，支持查询当前的流体物理模式（/fluidphysics query mode）和查询指定位置的蒸发状态（/fluidphysics operation evaporate）。在 VANILLA/ VANILLA LIKE 模式下，查询结果为预计蒸发量。在 MORE REALITY 模式下，查询结果为蒸发概率。通过运行 /fluidphysics operation evaporate <坐标> do 可以真正的在指定位置执行一次蒸发操作；

  Added /fluidphysics.

• 为 /fluidphysics 命令和 /atmosphere 命令加入了对 Brigo 模组的兼容。

变更 Change

API

• 天圆地方 GeoCraft API 版本号升级到 v0.3.0，版本代码升级到 2；

  GeoCraft API version is upgraded to v0.3.0, and the version number is upgraded to 2.

• API 内包 top.qiguaiaaaa.geocraft.api.fluid_physics 重命名为 top.qiguaiaaaa.geocraft.api.fluidphysics。

命令 Commands

• /atmosphere 命令用 Nickel API 彻底重写；

  /atmosphere is completely rewritten via Nickel API.

  • /atmosphere stop 子命令加入了可选的维度参数，可以指定操作的维度；
  • /atmosphere util block_info 命令加入了可选的方块状态参数，可以指定要查询的方块状态；
  • 为部分参数加入了中英双语注释，并国际化了全部参数名称；
  • /atmosphere track 子命令的文件名参数现在要求输入必须满足正则表达式 [^\s\\/:\*\?\"<>\|](\x20|[^\s\\/:\*\?\"<>\|])*[^\s\\/:\*\?\"<>\|\.]$；

• 为 /atmosphere 和 /fluidphysics 更新了运行权限要求：

  • /atmosphere 命令现在需要权限等级为 2，若为玩家运行还要求需要在 Forge 权限系统中拥有权限节点 geocraft.command.atmosphere；

    • /atmosphere set 子命令对于玩家，现在需要 Forge 权限节点 geocraft.command.atmosphere.set；
    • /atmosphere add 子命令对于玩家，现在需要 Forge 权限节点 geocraft.command.atmosphere.add；
    • /atmosphere stop 子命令对于玩家，现在需要 Forge 权限节点 geocraft.command.atmosphere.stop；
    • /atmosphere reset 子命令对于玩家，现在需要 Forge 权限节点 geocraft.command.atmosphere.reset；
    • /atmosphere query 子命令对于玩家，现在需要 Forge 权限节点 geocraft.command.atmosphere.query；
    • /atmosphere util 子命令对于玩家，现在需要 Forge 权限节点 geocraft.command.atmosphere.util；
    • /atmosphere track 子命令现在明确要求需要玩家运行，并要求至少有权限等级 4 和 Forge 权限节点 geocraft.command.atmosphere.track；

  • /fluidphysics 命令需要权限等级 2，若为玩家运行还要求需要在 Forge 权限系统中拥有权限节点 geocraft.command.fluidphysics；

• 在单人游戏模式下，若本地游戏语言为简体中文（zh_cn），则/atmosphere 指令现在会加载其别名/大气。

流体物理 Fluid Physics

• 模组内部对于 VANILLA LIKE 和 MORE REALITY 流体物理模式的称呼改为“经典”（CLASSIC）和“有限”（FINITE），外部配置和接口暂时保持不变；
• 略微优化了 MORE REALITY 流体物理模式下，原版流体方块和模组流体方块流动时的性能。

修复 Fix

API

• 修正了流体地理状态（Fluid State）在被调用 fill 方法补充流体时未检测 doFill 条件的问题；
• 修正了基本大气访问器在添加和抽取流体的行为，在之前其未能正确检测发布的 Forge 事件的结果，导致这段逻辑未能工作。该项修正解决了水无法蒸发的问题。

模组内部

• 修正在 MORE REALITY 流体物理模式下，岩浆流动到水上未能正确与水反应的问题；

  Fix the problem that under MORE REALITY, lava which flows over the water won't interact with water.

• 修正 MORE REALITY 流体物理模式下，水蒸发逻辑未遵循配置中的 canWaterEvaporate 配置的问题；

  Fix the problem that under MORE REALITY, the logic of evaporation didn't follow canWaterEvaporate configuration.

• 现在封闭大气系统（Close Atmosphere System）的大气访问器在被询问是否能够访问到大气时总是返回 true，以解决水方块在地狱未能正常蒸发的问题；

  Now the Atmosphere Accessor of Close Atmosphere System always return true when being asking whether the atmosphere is accessible or not, in order to solve the problem that water blocks didn't evaporate as usual.

• 当土壤作为载流方块被设置流体层数的时候，现在会检查新的层数是否合法，避免了边界条件下的游戏崩溃。

  Now it checkes the validation of new number of layers when the dirt is set layers as Layered Fluid Host Block, avoiding unusal crash by strange bugs.