Terraria（Rust rewrite）

用 Rust + Spark 运行时重写的 Terraria 客户端实验仓。

本仓库不是引擎。 Spark 是引擎，本仓是游戏。

运行前你必须拥有并安装 Terraria（Steam / GOG 等均可）。

• --path 必须指向 Terraria 安装根（该目录下要有 Content/、Content/Images/）。
• 本仓库 不附带、也 不重新分发任何商业素材或从安装中批量导出的内容数据包。
• 图片、音频、字体与着色器在运行时从用户的 Terraria 安装中只读加载。玩法内容通过跨平台注册 API 独立实现，vanilla 与 mod 使用同一套注册机制。
• 原版不支持的平台可导入由用户从自己安装生成的私有运行包。该运行包由用户自行保管和传输，本项目不上传、托管或分发。
• 没有 Terraria 安装根时，CLI 会直接失败，不会静默降级。

本机启动

pnpm install
pnpm launch

pnpm launch 会编译当前 Rust 与 TypeScript，再从本机 Steam 库找到 Terraria 安装根，并调用：

terraria emulate --path <安装根>

安装不在默认库时：

pnpm launch -- --path "<Terraria 安装根>"

发布构建：pnpm launch -- --release。

环境变量：

变量	含义
TR_CONTENT	由 emulate 自动写入，指向 --path
TR_NATIVE_NODE	可选，强制指定 .node 路径

素材命令

窗口以外还可以：

terraria unpack --path <Terraria 安装根> --out <仓库外目录>
terraria extract --path <Terraria 安装根> --out <仓库外目录> [--only Tiles_0.xnb]

extract 的 PNG 由 Spark 像素图写出。输出目录不能在本仓库或 Terraria 安装目录内。

开发构建

Spark 依赖根 Cargo.toml 的 git dev 分支。本机已有检出时，把 .cargo/config.toml.example 复制为 .cargo/config.toml（不入库），用 path 覆盖。不要改 Cargo.toml。

cargo check -p tr-napi