安装与快速开始
系统要求
- Windows x86_64、Linux x86_64 或 Linux aarch64
- 使用预编译二进制时不需要 Rust 工具链
- 从源码构建时需要 Rust stable（支持 edition 2024；建议 Rust 1.85 或更新）
- 可选：Minecraft 客户端 jar、已解压的
assets/目录或资源包 - 可选：Docker（用于容器部署）
- 常规 1024x1024 预览建议至少 1 GiB 内存；开启超采样、提高尺寸或渲染超大 结构时需要更多内存
下载预编译二进制（推荐）
在 Releases 下载对应平台的 安装包或压缩包：
文件名形如
blockscope-v0.2.0-x86_64-unknown-linux-musl.tar.gz，旁边有去掉扩展名
的 .sha256 校验文件（如 blockscope-v0.2.0-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
target/release 加入 PATH，也可以在命令中直接使用完整路径。