VortexSo4/Weft

Weft 是一个用 Rust 编写的体素沙盒游戏引擎，适合想玩 Minecraft 式沙盒、或为其开发模组的人。自带的游戏 mods/base 只使用公开 SDK，没有任何私有引擎钩子，因此其他模组也能做同样的事或修改它。

功能与机制

世界由 16x16x16 的立方体区块组成，没有高度或深度限制；地形在 GPU 上生成，因此远景可以绘制到远超视距的位置。世界不再使用随机刻，而是划分为并行的区域进行 tick；定时方块会补上区块未加载期间的时间，所以作物和熔炉在玩家不在时也会继续生长和熔炼。方块支持彩色 RGB 光照、连接或随机纹理变体、动画或发光纹理；模型在 Blockbench 中制作并带有关键帧动画。玩法包括生存和创造模式、合成与熔炼、带寻路的生物、可用桶舀取的任意液体、以能量驱动的机器，以及玩家可以站立并建造的可移动结构。

模组是 C ABI 之后的原生库，打包成 zip 并并行加载。内容通过 builder 注册，行为通过事件、拦截器和值链挂钩，配方、战利品和世界生成由标签驱动。示例模组和模组速查表展示了各种注册方式；mods/base 是游戏本身，mods/testmod 演示了在不改引擎的情况下扩展和替换它。资源包、着色器包、纹理/翻译/着色器/UI 的运行时重载、调试覆盖层和配方查看器都有助于开发，崩溃报告会指出崩溃时正在运行的模组。

运行与环境要求

从 Releases 下载对应构建，解压后运行 weft。需要支持 Vulkan 的 GPU；在 macOS 上它随游戏提供，要求 Apple Silicon 且 macOS 12 或更新。Windows 是主要测试平台，Linux 和 macOS 据报告也能良好运行。如果通过官方启动器或 Prism 安装了 Minecraft，Weft 启动时会从该副本构建资源包；资源包留在本机，可在 Settings > Resource Packs 中关闭。从源码构建需要 Rust 1.90 或更新，并且必须在仓库根目录运行。

早期阶段注意事项

项目明确处于早期：模组接口和存档格式仍可能在不同版本间变化。针对其他引擎版本构建的模组会拒绝加载并要求重新构建，而不是崩溃，但现有存档和模组不保证跨版本兼容。Weft 与 Mojang 或 Microsoft 无关，不读取 Minecraft 世界，也不包含 Minecraft 的代码或素材。

代码采用 MPL-2.0；再分发或修改时请查看许可证条款。