Terra Rasa
Fabric library for replacing a dedicated server's worlds while the server is running, promoting new worlds with canonical dimension keys.
介绍
Terra Rasa is a Fabric library for replacing dedicated or integrated server worlds while the server keeps running. It prepares fresh, seeded dimensions in the background, then promotes them under their **real canonical dimension keys**. Players stay connected, and vanilla continues to see `minecraft:overworld`, `minecraft:the_nether`, and `minecraft:the_end` as the active worlds.
That canonical identity is the key difference from temporary-world or dimension-alias approaches: vanilla itself continues to own portal travel, spawn selection, the End fight and gateways, credits, `/seed`, advancements, and data packs that target those dimensions. Terra Rasa replaces the levels behind the keys; it does not emulate each feature around a temporary dimension.
## What the library provides
| Utility | What it does |
|---|---|
| `DimensionPolicy` | Declares which dimensions are replaced, which service dimensions persist, and leaves every other dimension untouched. |
| `PinnedSeed` | Keeps persistent and external dimensions on the world’s original seed while resettable dimensions use the new world seed. |
| `WorldPreparationService` | Builds fresh levels under isolated staging identities, finds the vanilla spawn, preloads it, optionally pregenerates configured areas, and publishes a durable ready manifest. |
| Live pregeneration | Paces the remaining area after activation, records progress, and resumes it after a restart. The host configures per-dimension radii through `WorldPreparationService`. |
| `CanonicalActivationService` | Drains old levels, promotes staged world data, constructs new vanilla levels under canonical keys, and rolls back on failure. |
| Startup recovery | Uses the activation journal to finish or undo an interrupted swap before vanilla opens dimension storage. |
| `SessionReset` | Resets vanilla’s server-owned and per-player run state through live server objects. Hosts choose whether and when to call it. |
| `CanonicalLevelEvents` | Lets mods that cache level objects veto retirement or rebind to replacement levels. A Chunky adapter is included and loaded only when Chunky is present. |
The host mod owns the game rules, player flow, and the decision to reset session state. See [Host integration](docs/host-integration.md) for the lifecycle and [Library reference](docs/reference.md) for the utilities and storage model.
## Requirements
Terra Rasa provides a separate build for each supported Minecraft version:
| 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 |
Each build uses Fabric Loader 0.19.5. The full target list is maintained in [`gradle/minecraft-targets.json`](gradle/minecraft-targets.json), and CI builds every target. Terra Rasa 0.3.0 introduced support for dedicated servers and integrated single-player/LAN hosts across the listed targets. Version 0.3.1 fixes legacy Overworld activation on Minecraft 1.21.11.
常见问题
Terra Rasa 支持哪些 Minecraft 版本？
Terra Rasa 支持 Minecraft Java 版 1.21.11–26.3，共 6 个版本，可用的加载器：Fabric。下载时注意选择和你游戏版本一致的文件。
Terra Rasa 怎么安装？
先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric，再把下载的 .jar 文件放进游戏目录的 mods 文件夹，重新启动游戏即可。开启了版本隔离的，mods 文件夹在 versions/版本名 下面。
qwasdf 的其他作品
查看全部 →
Expanded Armory
全面重做盔甲和盾牌：新增锁链甲与羊毛盔甲的合成配方，重做锁链、铁甲和金甲的配方。还新增 9 种盾牌，取代原版盾牌，让战斗更加多样。
Spears, Staves, and Swords: Weapon Expansion
一款焕新战斗玩法的数据包，新增 3 种武器类型和一系列附魔。
Drinks and Draughts
A datapack that adds 44 new drink recipes to the game, each with special effects and uses, as well as an extra recipe for sugar.
Soul Link Challenge Runs
Cooperative challenge runs for a Fabric dedicated server, inspired by the Soul Link format and similar co-op challenges. Players share health, hunger, and saturation; any participant's death ends the run, and defeating the Ender Dragon wins.
评论
登录后评论和评分