安装与第一次启动
CaelCraft 是 Windows 桌面程序，没有安装向导之外的依赖。安装包按当前用户安装，默认不需要管理员权限；便携版就是同一个程序加一个文件夹。
安装之前
| 项目 | 要求 |
|---|---|
| 系统 | Windows 10 / 11 x64 |
| 显卡 | Vulkan 1.3，或带 VK_KHR_dynamic_rendering 扩展的 Vulkan 1.1 / 1.2 驱动。驱动太旧会在创建实例或交换链时失败。 |
| 运行库 | 安装包自带 VC++ 运行库；不需要 Java、.NET 或 Vulkan SDK。 |
| 磁盘 | 程序本体几 MB；安装后连同卸载器约 7 MB。存档、模组和资源包另算。 |
| 网络 | 单机不需要联网。联机需要 UDP 27632，只支持 IPv4。 |
如果显卡只支持 Vulkan 1.1 / 1.2，确认驱动暴露了 VK_KHR_dynamic_rendering；没有这个扩展时没有 render pass 回退，游戏会直接退出。
用安装包安装
- 从下载页下载
CaelCraft-<版本>-Setup.exe。 - 双击运行。Windows SmartScreen 可能提示未知发布者；先核对下载页的 SHA-256，再选择「更多信息 → 仍要运行」。
- 默认目录是
%LOCALAPPDATA%\Programs\CaelCraft，可以改到任意可写目录。 - 安装器会创建开始菜单项，桌面快捷方式可选。装完可以直接启动。
安装包没有写入系统目录，也没有注册文件关联；卸载时只删程序文件，saves\、mods\ 和 resourcepacks\ 会保留。
用便携版
下载 CaelCraft-<版本>-portable.zip，解压到一个你有写权限的目录，双击 CaelCraft.exe。不要直接在压缩包预览窗口里运行，也不要把程序放进 Program Files 或只读共享盘。
便携版的存档就在 exe 旁边；把整个文件夹复制到另一台电脑，世界、模组和资源包会一起过去。
目录结构
安装版和便携版的内部结构一样。游戏以 exe 所在目录为根，所有用户数据都放在它旁边：
CaelCraft\
CaelCraft.exe
shaders\ block_vs.spv / block_fs.spv
mods\ .mod.caelc / .zip 模组包
.cache\ 每次启动重新解压的临时目录
resourcepacks\ .rp.caelc / .zip 材质包
saves\
My World\
world.dat
player.dat
examples\ 安装包附带的示例模组和材质包
README.txt
主菜单和暂停菜单里都有「打开模组文件夹 / 打开材质包文件夹」按钮，会先创建目录再用资源管理器打开。资源包和模组都没有热重载，装完要重启游戏。
不要把这些目录指向 OneDrive 或其他云同步目录还在上传的位置。游戏写存档时先写 .tmp 再改名，云同步软件抢文件可能导致保存失败。
新建第一个世界
- 启动游戏，主菜单是一个多存档列表。点「新建世界」。
- 填世界名。只保留 ASCII 字母、数字、空格、
-和_，最长 40 个字符；其他字符会被过滤。 - 种子可以留空，游戏会随机生成；也可以填一段字符串，游戏会把它哈希成种子。同一个种子会得到同一片地形。
- 进世界后默认是创造模式。按 F3 + F4 循环三种模式，按 F4 单独切旁观。
- 按 Esc 暂停，可以保存并回主菜单；游戏退出时也会保存房主自己的世界和玩家状态。
主菜单的世界列表只显示世界名；进世界后 F3 面板和 /seed 会显示种子。删除世界需要二次确认，删除的是整个 saves\<世界名>\ 文件夹。
设置存在哪里
暂停菜单里的鼠标灵敏度、FOV、渲染距离只存在内存里，不写配置文件，重启后回到默认值：灵敏度 0.12、FOV 70、渲染距离 8（范围 4–16）。语言默认跟随 Windows 显示语言，在主菜单底部或暂停菜单里切换，重启后也会回到系统语言。
如果你希望设置持久化，目前只能每次启动后手动调，或者用 /fov、/render 命令临时改。
更新与卸载
更新
直接运行新版本的安装包，装到同一个目录即可。安装器会记住上次的安装位置，存档和模组不会被覆盖。更新前建议把 saves\ 整个复制一份：开发版改地形生成算法会让同种子的旧世界地形变样。
卸载
Windows 设置 → 应用 → CaelCraft → 卸载，或者运行安装目录里的 unins000.exe。卸载器只删程序文件；saves\、mods\ 和 resourcepacks\ 会留下。要彻底清掉就手动删整个安装目录。
换电脑
关掉游戏，复制 saves\ 里对应的世界文件夹到新电脑的同名目录。地形由种子重新生成，所以只需要 world.dat 和 player.dat；模组方块需要新电脑也装同一套模组，否则那些方块会变成空气。
权限和杀毒软件
游戏要在 exe 旁边写存档和模组缓存。装在 Program Files、只读共享盘或受控文件夹里时，保存会失败，模组包也无法解压。默认的 %LOCALAPPDATA%\Programs\CaelCraft 和便携版目录都有写权限。
杀毒软件可能把「程序在 exe 旁边创建 .cache 和 saves」当成可疑行为。如果文件被拦截，把安装目录加入信任；不要为了运行游戏关闭整个系统的防护。