KILN

KILN — 键控隐式语言与记法

KILN 将文本转换成流畅、风格化的 3D 游戏模型。AI Agent（或你）把模型写成一系列简单形状，这些形状会像黏土一样彼此融合；KILN 将它们网格化、按调色板上色、绑定骨骼并制作动画，然后构建 .glb 文件和 Godot 场景。它是 PAGAN（用文本创作像素艺术）的 3D 版本：Claude 不会画画，但会写作，而 KILN 能将文字变成艺术。不需要付费生成器、GPU 或 Blender。

网站： https://kiln3d.dev/（在线 3D 演示、文档）。姊妹库：PAGAN（像素艺术）和 SEGAN（音频）。

name: pilot
class: character
parts:
  - capsule: { from: [0, 0.32, 0], to: [0, 0.74, 0], radius: 0.3 }    # the bean body
    color: red
    material: plastic
  - capsule: { from: [0.3, 0.6, 0], to: [0.42, 0.38, 0.08], radius: 0.08 }
    id: arm_l
    mirror: x
    mirror_id: arm_r
    blend: 0.04                                                    # melts into the body
    color: red
    material: plastic
  - sphere: { at: [0.1, 0.84, 0.23], radius: 0.1 }                  # big googly eyes
    mirror: x
    color: white
    material: plastic
rig:
  arm_l: { pivot: [0.3, 0.6, 0] }
skin: soft
animations:
  walk: { fps: 12, cycle: { type: waddle } }

状态： 0.9，pre-1.0：记法、平滑和硬表面网格化、上色（图案、贴花、调色板图集）、 骨骼绑定、柔性和刚性蒙皮、动画剪辑重定向（人形或任何带关节映射的骨架）、动画、特效、地形（带纹理混合图层的高度场）、植被散布、五种风格、 预览、Godot 导出、代码检查、CC0 导入、模板库、Claude 技能和 MCP 服务。 Bug 和功能请求：GitHub issues。

一个模型，任意风格

项目会选择一种风格：形状转化为网格的方式（平滑或平面着色）、三角形预算、材质预设和外观套件（光照、色调映射、轮廓线）。下方相同的模型文本可以生成软玩具风格（Dear Passengers、Fall Guys）、低多边形风格和卡通风格。你也可以从灵感图片中创作自己的风格。

地形

带有 terrain: 的模型可以作为关卡地面：按顺序组合山丘、山脊、高原、噪声和路径，并根据坡度、高度、与路径的距离及噪声，用最多四种调色板颜色进行绘制。它会生成分块的 LOD 网格、纹理混合图和带碰撞体的 Godot 场景（examples/terrain）。

植被

带有 scatter: 的模型可以在地形、另一个模型的顶部或平坦区域上多次放置其他模型：可设置密度、间距、坡度 / 高度 / 噪声 / 纹理混合图层 / 路径规则，以及随机旋转、缩放、倾斜和色调。KILN 会在构建时将每个实例写入 JSON 文件，并生成包含 LOD 的 MultiMeshes Godot 场景（examples/terrain：meadow、moss）。

安装

需要 Python 3.11+。

pip install kiln-gen      # the package is kiln-gen on PyPI; the command and the import are `kiln`
kiln --version

大型模型可使用更快的构建方式：kiln-gen[fast]（numba）。与纯净安装相比，其输出的最后几位浮点数会有所不同，因此游戏项目应在依赖项中固定使用其中一种。

开发环境：python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"，然后运行 pytest 和 mypy。

快速入门

kiln init my-game-art --style soft_toy    # kiln.toml, palette, BRIEF.md, STYLE.md, models/, styles/
cd my-game-art
kiln new model pilot --template bean      # a rigged bean character to edit
kiln lint                                 # errors and warnings with line numbers
kiln preview pilot                        # previews/pilot/turntable.png: 8 sides x 3 heights
kiln preview pilot --pose walk --closeup arm_l
kiln lineup                               # every model at one scale, with a 1 m bar
kiln build                                # build/models/pilot.glb + manifest.json

每条命令都支持 --json，遇到错误时会以非零状态码退出。预览使用 KILN 自带的软件渲染器（无需 GPU 或显示器）；kiln preview <model> --engine 则通过 Godot 渲染。

在 Godot 中

在 Godot 项目中运行 kiln init 会设置 export = ["glb", "godot"]，并将 output_dir 设为其 assets/kiln；在其他位置则需手动设置这两项。每个模型都会生成 models/<name>.tscn （带有该风格材质的 glb：卡通色带、轮廓、边缘光），每种风格都会生成一个外观套件 looks/<style>.tscn（天空、太阳、色调映射器、SSAO、辉光、色彩分级）。

add_child(load("res://assets/kiln/looks/soft_toy.tscn").instantiate())   # once per scene
var pilot: Node3D = load("res://assets/kiln/models/pilot.tscn").instantiate()
add_child(pilot)
pilot.get_node("AnimationPlayer").play("walk")

人形模型可以选择启用 Godot 的重定向：在 kiln.toml 中设置 godot_bonemap = true，即可为每个人形模型在 SkeletonProfileHumanoid 上写入一个 BoneMap，并在 glb 的 .import 中设置该映射，使为该配置文件制作的动画片段能够在这些模型上播放。 随后，Godot 会重命名骨架的骨骼（hips -> Hips、upperleg_l -> LeftUpperLeg）以及骨架节点 （%GeneralSkeleton）：游戏代码中引用 KILN 骨骼名称的部分必须随之更改，因此此功能默认关闭，且可撤销。

kiln build --verify-godot 会在无头模式下加载所有内容，并检查部件、动画和材质。 manifest.json 是适用于任何引擎的约定文件：记录文件、以米为单位的大小和边界、三角形、部件（枢轴、 父级、游戏玩法元数据）、动画、变体、LOD 和许可。examples/godot 是一个可运行的 Godot 4.7 项目，展示了演示模型。

其他引擎

.glb 文件是标准的 glTF 2.0：Unity、Unreal、Bevy、three.js 和 Defold 都可以导入。设置 export = ["glb"]。 docs/engines.md 提供各引擎的说明（坐标轴、缩放、顶点颜色、调色板纹理、动画、 LOD），以及仅适用于 Godot 的功能（外观套件、卡通渲染、轮廓、边缘光）和近似实现方法。

将 KILN 与 Claude 搭配使用

kiln skill install        # copies the skill to .claude/skills/kiln/

然后提出需求：“为我的航空公司游戏制作一个豆子飞行员”“让骑士的头盔可以拆卸”“添加一座攻城塔” “让所有内容看起来更像这些截图”。该技能会指导工作流：以米为单位规划、编写部件、 运行 lint、查看预览、检查队列并汇报。

从任意 Agent 使用（MCP）

claude mcp add kiln -- uvx kiln-gen mcp --project /path/to/art     # no install needed (uv); or `kiln mcp` after pip install

其他客户端可在配置中使用相同的命令：

{ "mcpServers": { "kiln": { "command": "uvx", "args": ["kiln-gen", "mcp", "--project", "/path/to/art"] } } }

KILN 已列入 MCP Registry，名称为 io.github.lukasgolino/kiln。

工具会返回 CLI 的 JSON；预览会以图像形式返回。添加 --allow-godot 可启用 Godot 验证和引擎 渲染。

免费素材包

对于文本难以生成的内容（茂密的植被、逼真的岩石），可以使用 CC0 模型（Kenney、KayKit、Quaternius）： kiln import tree.glb --licence CC0-1.0 --author Kenney --height 4。构建过程会将它们的颜色匹配到你的调色板 并应用你的风格，使其保持一致；作者信息列在 CREDITS.md 中。安装 Blender 4.x 后（将 blender 加入 PATH 或设置 BLENDER=/path/to/blender），kiln import 也可以接受 .fbx、.blend 和 .obj，并将它们转换为 glb；KILN 本身 不需要 Blender。

KILN 附带一些 CC0 素材包（Kenney、KayKit、Quaternius）的配方：kiln pack add kaykit-adventurers 会将一个素材包 镜像到每用户缓存中（这是唯一会下载内容的命令），kiln pack search knight --lineup 可按名称和 标签查找模型，而 kiln pack import kaykit-adventurers knight --height 1.8 会导入模型，并将其文件信息（素材包、 版本、URL、sha256、许可）记录到 kiln.lock 中，kiln build 会检查该文件。

许可证

Apache 2.0 — 详见 LICENSE。