MCP 工具
生成模型
- thrixel_create_model
- 根据文本描述或参考图像构建模型。每个部分,如轮子、门或帆,都是一个单独命名的部件,可以单独移动或设置动画。
- thrixel_sculpt_model
- 更适合人物、生物、植物和任何从照片开始的东西。生成单个详细的纹理网格。
- thrixel_generate_image
- 创建概念图像,以便智能体可以在生成任何 3D 之前确定外观。从同一图像构建多个模型可以保持它们的一致性。
检查和编辑
- thrixel_inspect_model
- 列出模型的零件和三角形数量,以及渲染的预览。
- thrixel_edit_model
- 根据文本指令更改模型的特定部分,并保持其他所有内容不变。
准备可用于游戏的模型
- thrixel_detail_model
- 添加高分辨率几何和 PBR 纹理。这是最后一步,因为无法进一步编辑详细模型。
- thrixel_retexture_model
- 应用新纹理而不改变模型的形状。
- thrixel_group_parts
- 将不需要移动到一个网格中的部件合并,从而减少引擎中的绘制调用。
- thrixel_reduce_triangles
- 将模型减少到目标三角形数量并保持其纹理。
项目与发布
- thrixel_start_project
- 将同一游戏的所有资源集中到 Thrixel 账户中的一个文件夹,并可通过网页应用查看和编辑。
- thrixel_add_project_source
- 保存适用于项目中生成的每个模型的规则,例如三角形预算或艺术风格。
- thrixel_publish_game
- 将完成的网页游戏发布到其自己的 Thrixel World 链接,并显示封面图像、预览剪辑和控件。也可用于更新以前发布的游戏。
示例工作流程
/thrixel:build-world 在沙漠峡谷赛道上用 Three.js 制作卡丁车赛车
用 Build World 构建游戏
Build World技能为智能体提供了制作游戏的完整过程。它规划项目,使用 Thrixel 生成资源,并在游戏运行过程中测试游戏。它支持Three.js、Unity、Roblox和Unreal Engine,并将Three.js和Unity游戏发布到thrixel.world。
用真实模型替换关卡中的占位立方体
将模型添加到现有项目
Thrixel的MCP还可以用于添加或修改现有项目中的资源。智能体可以生成缺失的模型,减少它们以适应三角形预算,并将它们添加到场景中。
市场摊位看起来比参考更糟糕,修复它们
改善gauntlet loop中的资源
在 gauntlet loop 中,评论家智能体将游戏与参考进行比较并发回反馈。由于 Thrixel 模型可以部分编辑,因此智能体可以解决特定领域的批评,而无需重新生成整个模型。
设置
1 从终端登录或注册 Thrixel。
uvx thrixel-mcp@latest login
没有安装uv?
macOS 和 Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows (PowerShell)
irm https://astral.sh/uv/install.ps1 | iex
然后打开一个新终端并运行登录命令。
2 将服务器添加到您的编程智能体。
claude mcp add --scope user thrixel -- uvx thrixel-mcp@latest
codex mcp add thrixel -- uvx thrixel-mcp@latest
将此添加到 ~/.cursor/mcp.json,如果该文件不存在则创建该文件:
{
"mcpServers": {
"thrixel": {
"type": "stdio",
"command": "uvx",
"args": ["thrixel-mcp@latest"]
}
}
}
gemini mcp add -s user --trust thrixel uvx -- thrixel-mcp@latest
Thrixel 的工具将在启动新的智能体会话后可用。
每个智能体的详细信息可以在完整的设置指南中找到。
用 Thrixel 制作
使用 AI 编程代理和 Thrixel 生成的 3D 资源制作的游戏。
-
描述您的目标
在已连接的 MCP 客户端(如 Claude Code、Codex 或 Cursor)中告诉代理要制作什么,并提供美术风格、参考图像和目标引擎。
-
生成 3D 资源
代理调用 Thrixel 来生成和优化项目的 3D 资源。 Build World 等技能提供了规划场景、选择工具和测试结果的工作流程。
-
构建并发布
代理将资源带入 Three.js、Unity、Roblox 或 Unreal Engine。通过引擎通常的工作流程进行发布;支持的Three.js和Unity页游也可以发布到Thrixel World。
常见问题
什么是 3D 模型 MCP 服务器?
Model Context Protocol 将 AI 代理连接到外部工具。 Thrixel 公开了用于生成、检查、编辑和导出 3D 模型的工具,以便 AI 编程代理可以在构建项目时使用它们。
生成模型的成本是多少?
生成模型会消耗 Thrixel Cubes。入门账户包含用于试用工作流程的 Cubes;较大的项目和多次迭代可能需要付费套餐。生成资源前,请让代理检查账户状态和各项操作的当前价格。请参阅使用指南。
我可以使用哪些格式和游戏引擎?
Thrixel 支持导出包括 GLB、FBX、OBJ、STL 和 USDZ。格式取决于目的地。请参阅 Roblox、Unity 和 Unreal Engine 的工作流程,或在 Three.js 项目中使用 GLB。
生成的资源保存在哪里?
资源显示在 Thrixel 工作区中。 MCP服务器还可以在本地保存模型以供代理在项目中使用。项目将相关资源和样式参考保存在一起。
MCP 服务器与 Build World 有什么不同?
MCP 服务器提供了用于处理资源的工具。 Build World 添加了用于规划、构建和测试游戏的工作流程。上面的设置安装了MCP服务器; Build World 指南还涵盖了安装该技能。
为什么 Thrixel 工具没有显示?
注册服务器后启动新的代理会话。检查uv是否已安装且Thrixel登录是否完成。服务器必须在正在使用的客户端中注册。按照MCP 设置指南检查配置。