插件下载

Blender

1. 下载 zip（4.2+ 选 Extensions 版，旧版选 legacy）。
2. Blender → 编辑 → 偏好设置 → 插件 → 从磁盘安装，选择 zip。
3. 启用「CityEngine 生成」，3D 视图按 N 打开侧栏。
4. 填入插件 Key（未注册可点「注册账户」现场注册），输入一句话 → 生成。

60 秒上手：输入「三层临街商铺」→ 约 20 秒模型自动导入场景原点。

Unity

1. 下载 tgz，Package Manager → Add package from tarball。
2. 按提示安装依赖 com.unity.cloud.gltfast 与 com.unity.nuget.newtonsoft-json。
3. 菜单 Window → CityEngine Gen 打开面板。
4. 填入插件 Key（未注册可点「注册账户」现场注册），输入一句话 → 生成。

60 秒上手：生成结果自动实例化到场景原点，支持撤销（Undo）。

SketchUp

1. 下载 .rbz。
2. SketchUp → 窗口 → 扩展程序管理器 → 安装扩展程序。
3. 菜单 扩展程序 → CityEngine Gen 打开面板。
4. 填入插件 Key（未注册可点「注册账户」现场注册），输入一句话 → 生成。

60 秒上手：模型以米制自动换算导入，坐标系已对齐 SketchUp Z-up。

Unreal Engine

1. 下载 tgz，解压到项目的 Plugins/CityEngineGen。
2. 重新生成工程文件并编译（需 C++ 工具链）。
3. 编辑器菜单 CityEngine Gen 打开面板。
4. 填入插件 Key（未注册可点「注册账户」现场注册），输入一句话 → 生成。

60 秒上手：生成结果经 Interchange 导入为资产。注意：本包为源码形式，需项目具备编译环境。

Web SDK（three.js）

1. 下载 zip 解压，npm install 安装 peer 依赖 three。
2. import { GatewayClient } from './src/client.js'。
3. generateToScene(scene, { apiKey, text }) 一句话直接进 three 场景（服务地址已内置，gateway 参数可选）；client.register(email, password) 可直接注册账户并取 Key。

60 秒上手：自带 viewer/index.html 示例，起任意静态服务器即可预览。

MCP 大模型直连

让大模型客户端直接调用 CityEngine 云端能力：一句话生成三维模型、NL→CGA 规则、CGA 解析出 glb、demo / 额度查询（6 个工具，只读计算端点，已全链实测）。

1. 下载 wheel，pip install cityengine_mcp-0.1.0-py3-none-any.whl（得到 cityengine-mcp 命令）。
2. 把对应客户端的配置示例填入你的插件 Key（cvk_ 前缀，用户中心可签发）。
3. 在大模型客户端里直接说「用 cityengine 生成一栋三层小楼」。

// kimi code：.kimi-code/mcp.json
{
  "mcpServers": {
    "cityengine": {
      "command": "cityengine-mcp",
      "env": { "CITYENGINE_API_KEY": "cvk_填入你的插件Key" }
    }
  }
}

配置示例下载：kimi code · codex · Claude Desktop

额度说明

免费版：一句话生成（NL）5 次/月，模型生成 100 次/日。
标准 / 高级 / 永久会员：NL 不限，模型生成 100 次/日。
所有档位统一 60 次/分钟请求限流（超出返回 429，插件自动重试）。
文件校验：所有下载包 SHA256 见 SHA256SUMS.txt。