无限地表
按种子生成平原、森林、沙漠和雪山。洞穴用三维噪声挖出来，深处有岩浆，海平面以下灌水。
01世界
每一条地平线，
都由种子长出来。
世界横向无限，纵向 64 格。海平面以下是水，地表分成平原、森林、沙漠和雪地；树、洞穴和地下岩浆都跟着地形走。
每一列地形都能从种子重新算出来，存档只记录你改过的方块。同一颗种子，换台电脑打开还是同一片地。
- World height
- 64格
- Biomes
- 4种地表
- Water flow
- 7格最远
- Day cycle
- 180秒
雨和雪是屏幕特效，不会真的落到地面；每 70–190 秒切一次天气。
02玩法
能走，能挖，
也能住下来。
现在能用的东西不算多，但都尽量做完整。没做的会写在文档的「已知限制」里。
方块与流体
草、土、石、沙、木、砖块和书架都能挖、能放。水最多流 7 格，岩浆 3 格；水碰到岩浆会凝成圆石。
村庄与村民
平地上会生成带水井、房屋、碎石路和岩浆灯柱的村庄。村民在附近闲逛，用 8 块木板可以换 1 个书架。
三种模式
创造可以飞、方块不限量；生存有生命、伤害和挖掘时间；旁观穿墙无重力，只看不改。
生物与掉落物
史莱姆会追人，猪会乱跑，村民被打会逃。挖掉的方块先掉在地上，走近自动捡起；生存模式还能看到生物血条。
主机权威联机
房主开服，其他人填 IP 或域名加入。方块、生物、掉落物、流体、时间和天气都由房主同步。
03画面
没有贴图文件，
纹理是一块块画出来的。
16×16 的程序化纹理、面剔除、顶点 AO，以及按距离排序的半透明水面。下面都是游戏里直接截的图。
全部截图来自当前开发版；界面、方块外观和地形细节还会继续变。
04模式
想怎么玩，
自己挑。
三种模式随时切，F3+F4 循环，F4 单独切旁观。
创造 CREATIVE
可以飞，方块不限量，挖掉就消失。适合先看看世界长什么样，或者搭点东西。
F · 飞行双击空格
生存 SURVIVAL
20 点生命，挖方块要按硬度花时间，掉落的方块要自己捡；摔落、岩浆和生物都会伤人。
E · 背包按住左键
旁观 SPECTATOR
穿墙、无重力，只看不改。从天上看看村庄和地形，不会打扰世界。
F4 · 切换F3+F4 · 循环
05联机
一个人建，
几个人一起住。
房主就是服务器；默认走 UDP 27632。
世界、生物、掉落物、流体、时间和天气都在房主那边计算，其他人只负责自己的移动和背包。
- 局域网直接填房主的内网地址。
- 公网把 UDP 27632 转发到房主电脑。
- 域名不写端口时默认 27632；只写域名会先查
_caelcraft._udp的 SRV 记录。
现在还没有密码、认证、NAT 穿透和 PvP，只支持 IPv4；远端玩家不参与碰撞，房主也要一直开着游戏。装模组时两端要装同一套，签名对不上会被拒绝。
主机权威 / HOSTUDP 27632
HOST
房主
世界 · 生物 · 掉落物 · 天气
同步
朋友 01CLIENT
朋友 02CLIENT
朋友 03CLIENT
<房主 IP 或域名>:27632
06定制
模组写 Lua，
材质包直接放进去。
没有启动器、没有依赖文件：一个 zip 放进 mods\ 或 resourcepacks\，重启就好。
模组包是 .mod.caelc（本质就是 zip），里面放一段 main.lua 和几张纹理。脚本能读写方块、给物品、注册新方块和命令，也能监听挖放、玩家进出和每 0.05 秒一次的 tick。
每个模组跑在独立的 Lua 状态里，只开基础库；有 64 MB 内存上限和每次回调的指令预算，死循环会被中断并写日志，不会把主机卡死。
资源包支持原生布局和 Minecraft 材质包：包里有什么换什么，缺的自动回退。还能用 visual.json 调雾、曝光、饱和度和水面颜色。
- 单机 / 房主脚本在单机和主机上执行，客户端只加载方块注册表和纹理。
- 联机Hello 会带模组签名；两端装的不一致会直接拒绝连接。
- 数据
cael.data_dir()给每个模组一个自己的目录，读写不参与联机同步。
ruby/main.luaLua 5.4
cael.register_block {
id = "ruby:ore",
name = "Ruby Ore",
texture = "textures/ruby_ore.png",
hardness = 2.2,
drop = "ruby:block",
}
on_block_break(function(e)
if e.block == "caelcraft:stone" then
cael.give("ruby:block", 1)
end
end)目录结构
CaelCraft\
CaelCraft.exe
mods\
ruby.mod.caelc
resourcepacks\
clean_stone.rp.caelc
saves\
My World\07下载
装一个，
直接进世界。
安装包按当前用户安装，不需要管理员权限；便携版解压到任意可写目录就能跑。
Windows 10 / 11 x64 · 构建于 2026-10-19
开发版 0.1.1792372227
包含游戏本体、着色器、VC++ 运行库和示例模组 / 材质包。存档、模组和资源包都放在 exe 旁边，卸载时不会删你的世界。
安装包没有代码签名，Windows 可能提示「未知发布者」；下载页提供 SHA-256，可以先核对再运行。
- 安装包
- CaelCraft-0.1.1792372227-Setup.exe
- 便携版
- CaelCraft-0.1.1792372227-portable.zip
- 存档位置
saves\（exe 旁边）- 系统要求
- Vulkan 1.3 · 联机走 UDP 27632
已经能用
- 单机多存档，每个世界一个文件夹
- 主机权威的局域网 / 直连联机
- 创造、生存、旁观三种模式
- 程序化村庄、村民、生物和掉落物
- 资源包（原生 / Minecraft 格式）与 Lua 模组
- 中英文界面，跟随系统语言
还在做
- 方块光源传播
- 专用服务器与认证
- 饥饿、合成和工具耐久
- PvP
- 模组热重载和客户端 UI
08文档
遇到问题，
先从这里找。
安装、操作、联机、命令、存档、资源包和模组都有单独页面；命令和 API 按当前代码写，不用去翻源码。