系统要求
- Windows x86_64、Linux x86_64 / aarch64、macOS aarch64 / x86_64
- 使用预编译二进制时不需要 Rust 工具链
- 从源码构建时需要 Rust stable（支持 edition 2024；建议 Rust 1.85 或更新）
- 可选：Minecraft 客户端 jar、已解压的
assets/目录或资源包 - 可选：Docker（用于容器部署）
- 常规 1024x1024 预览建议至少 1 GiB 内存；开启超采样、提高尺寸或渲染超大结构时需要更多内存
下载预编译二进制（推荐）
在 Releases 下载对应平台的安装包或压缩包：
文件名形如
blockscope-v0.4.1-x86_64-unknown-linux-musl.tar.gz，旁边有去掉扩展名的 .sha256 校验文件（如 blockscope-v0.4.1-x86_64-unknown-linux-musl.sha256）。 Linux 产物静态链接 musl，Windows 产物静态链接 CRT，目标机器不需要额外安装运行时库。
Linux
macOS
Apple Silicon（M 系列）选择aarch64-apple-darwin，Intel Mac 选择 x86_64-apple-darwin：
Windows：MSI 安装（推荐）
按用户安装，不需要管理员权限：%LOCALAPPDATA%\Programs\Blockscope，并把该目录追加到当前用户的 PATH；重新打开终端后 blockscope --version 即可用。卸载在“设置 → 应用”里，卸载会同时移除 PATH 条目。静默安装用 msiexec /i "$name.msi" /qn。
Windows：便携 zip
不想安装时直接解压：Get-FileHash 输出的哈希应与 .sha256 文件中的值一致。把解压目录加入 PATH，下文命令中的 blockscope 均指该可执行文件。
从源码构建
需要 Rust stable。用于开发、审查或自行修改引擎：- Linux：
target/release/blockscope - Windows：
target/release/blockscope.exe - macOS：
target/release/blockscope
target/release 加入 PATH，也可以在命令中直接使用完整路径。
默认构建仅包含 CPU 后端。需要可选的离屏 GPU 光栅器时（要求硬件适配器和平台
GPU 驱动）：
--backend cpu；传入 --backend gpu 或 --backend auto
才会启用。Linux musl 静态发布包不包含此特性，因为静态二进制无法在运行时加载
Vulkan loader。