Century-Ula/dsh-roblox-Blender ↗★ 2

dsh-roblox-blender

Drive Roblox Studio and Blender / 3ds Max from the DeepSeek Harness agent: the ZeroScript-Free bridge as a DSH plugin, with 30+ Studio tools, headless DCC builds, a web console, and no terminal window.

包名
dsh-roblox-blender
兼容性
待验证
版本
1.3.0
许可证
MIT
最近更新
2026年11月16日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Century-Ula/dsh-roblox-Blender

使用

让 Agent 直接干活(主用法)

重启 DSH 后,直接对 Agent 说需求即可,例如:

在 Workspace 里放一个 10×1×10 的 Part,用红色塑料材质

读一下 ServerScriptService 里的主脚本,把玩家跳跃高度改成 60

打开 Play 模式,帮我看看控制台有没有报错

给这个模型截个图,看看光照是否合适

Agent 会自己选择 roblox_execute_luau、roblox_script_read、roblox_screen_capture 等工具, 链路是 Agent → 插件 → bridge.py → StudioMCP → 你的 Studio,全程不经过任何聊天网页。

Studio 侧一次性设置

  1. 打开 Roblox Studio 并加载一个 place;
  2. 顶部 Assistant AI → 右上 … → Manage MCP Servers → Enable Studio as MCP Server。

只做一次;之后 Studio 每次启动、插件会自动连上。

独立控制台网页

浏览器打开 ****:

  • 顶部状态灯:Bridge / Studio / MCP,右侧显示工具数量;
  • 左侧 30+ 个工具(带中文说明)+ 搜索;
  • 中间按 schema 自动生成参数表单,或切 JSON 手写参数,Ctrl/⌘+Enter 执行;
  • 右侧调用记录;截图会直接内联显示;
  • 顶部还有 检测 Studio、刷新工具、启动 Bridge、重连 等诊断按钮。

DSH 侧栏面板

刷新 DSH 页面后,左侧栏底部出现 Roblox+Blender 图标,点开是同一套状态灯、工具列表和执行台。 两条 UI 走同一套 HTTP API,结果永远一致。


配置

配置写在 profile patch 条目的 config: 下(见 cordis.patch.example.yml),也可以直接用默认值。

字段默认值说明
port17613Bridge 端口,对应 ZeroScript 的 ZS_BRIDGE_PORT
bridgeDir""含 bridge.py 的目录;留空按版本号自动挑选最新安装
autoLaunchtrueBridge 没在跑时自动以隐藏窗口拉起
exposeToolsallall = 每个 Studio 工具一个 DSH 工具;generic = 只留 3 个常驻工具(省 token)
toolPrefixroblox_工具名前缀
toolCallTimeoutMs120000单次工具调用超时
statusPollMs5000状态轮询间隔
blender / max / zbrush""显式指定建模软件路径;留空自动探测
openCloudKey""Roblox Open Cloud API key(上传资产用)。建议改用环境变量
creatorUserId / creatorGroupId""上传资产归属的用户 / 小组

环境变量(更安全,避免密钥进配置文件):

setx ROBLOX_OPEN_CLOUD_KEY "你的 key"
setx ROBLOX_CREATOR_USER_ID  "你的用户 ID"

Open Cloud key 需要 assets 权限的 Read + Write;上传的是 package(含 MeshPart), 单次 ≤ 20 MB,且会经过审核。