白板

白板

用于在服务器运行期间替换专用服务器世界的Fabric库,通过规范维度键提升新世界。

Terra Rasa 是一个 Fabric 库,用于在服务器持续运行的情况下替换专用服务器或集成服务器世界。它会在后台准备全新的、带种子的维度,然后以它们的真实规范维度键将其提升为正式维度。玩家保持连接,原版游戏仍将 minecraft:overworld、minecraft:the_nether 和 minecraft:the_end 视为活动世界。

这种规范身份正是它与临时世界或维度别名方案的关键区别:原版本身继续负责传送门旅行、出生点选择、末地战斗与传送门、制作人员名单、/seed、进度以及针对这些维度的数据包。Terra Rasa 替换的是这些键背后的关卡;它不会围绕临时维度去模拟每一项功能。

该库提供的内容

工具 作用
DimensionPolicy 声明哪些维度会被替换、哪些服务维度会保留,并让其他所有维度保持原样。
PinnedSeed 让持久维度和外部维度保持世界原始种子,而可重置维度使用新的世界种子。
WorldPreparationService 在隔离的暂存身份下构建全新关卡,查找原版出生点,预加载它,可选地预生成配置区域,并发布持久的就绪清单。
实时预生成 在激活后对剩余区域进行节奏控制,记录进度,并在重启后恢复。宿主通过 WorldPreparationService 配置每个维度的半径。
CanonicalActivationService 排空旧关卡,提升暂存的世界数据,在规范键下构建新的原版关卡,并在失败时回滚。
启动恢复 使用激活日志在原版打开维度存储之前完成或撤销被中断的交换。
SessionReset 通过实时服务器对象重置原版服务器所有和每位玩家的运行状态。宿主选择是否以及何时调用它。
CanonicalLevelEvents 让缓存关卡对象的模组可以否决退役或重新绑定到替换关卡。包含一个 Chunky 适配器,仅在存在 Chunky 时加载。

宿主模组负责游戏规则、玩家流程以及重置会话状态的决策。生命周期参见 宿主集成,工具与存储模型参见 库参考。

要求

Terra Rasa 为每个受支持的 Minecraft 版本提供单独的构建:

Minecraft Java Fabric Loom Fabric API
1.21.11 21 1.17.21 0.141.6+1.21.11
26.1 25 1.18.4 0.145.1+26.1
26.1.1 25 1.18.4 0.145.4+26.1.1
26.1.2 25 1.18.4 0.155.3+26.1.2
26.2 25 1.18.4 0.161.0+26.2
26.3 25 1.18.4 0.165.0+26.3

每个构建均使用 Fabric Loader 0.19.5。完整目标列表维护在 gradle/minecraft-targets.json 中,CI 会构建每个目标。Terra Rasa 0.3.0 为所列目标引入了对专用服务器以及集成单人/LAN 宿主的支持。版本 0.3.1 修复了 Minecraft 1.21.11 上的旧版主世界激活问题。