通用 Python DCC 开发工具,支持 Maya、3ds Max、Substance Painter、Substance Designer、Houdini、Blender 等具备 Python 脚本能力的 DCC 软件。
依赖
本插件要求安装 dcc-bridge Python 包:
pip install dcc-bridge
插件首次激活时会检测该包是否已安装,并提示安装命令。
功能
执行代码
在 VS Code 中按 Ctrl + Enter 将选中代码发送到 DCC 执行;未选中时执行整个文件。
附加调试器
DCC Python ToolKit: Attach Debugger 在 DCC 中启动 debugpy 调试服务,并将 VS Code 附加到该服务。首次使用前需运行 dcc setup <dcc> 完成 debugpy 安装。
注意:debugpy 在首次 attach 时绑定端口,DCC 运行期间端口不可更改。若修改了 debug.port 配置,需重启 DCC 才能生效。
重载模块
DCC Python ToolKit: Reload Modules 无需重启 DCC 即可重载工作区中的 Python 模块。
Dashboard
侧边栏 DCC Python ToolKit 面板列出所有运行中的 DCC 实例,点击即可选择连接。
DCC Setup Manager
点击 Dashboard 标题栏的 ⚙ 图标(或通过 Ctrl+Shift+P → DCC Setup Manager)打开 DCC 工具管理面板:
- 每个 DCC(Maya / 3ds Max / Substance Painter / Substance Designer / Houdini / Blender)有独立的 Setup / Unsetup 按钮
- 状态指示灯:绿色 ● 表示该 DCC 正在运行,灰色 ○ 表示未检测到
- 支持一键 全部 Setup 和 全部 Unsetup
- 执行 setup 时输出日志会实时写入
DCC Python ToolKit Log 输出频道
配置
| 配置项 |
说明 |
默认值 |
dcc-python-toolkit.pythonPath |
指定 Python 解释器路径,用于检测 dcc-bridge 包;留空则自动检测 |
"" |
dcc-python-toolkit.server.host |
DCC 服务地址 |
127.0.0.1 |
dcc-python-toolkit.server.port |
DCC 服务端口 |
7002 |
dcc-python-toolkit.execute.name |
执行代码时 __name__ 变量的值 |
__main__ |
dcc-python-toolkit.execute.entryPoint |
入口点脚本路径 |
"" |
dcc-python-toolkit.execute.entryPointReload |
执行入口点前是否重载模块 |
true |
dcc-python-toolkit.execute.showOutput |
执行代码时是否显示输出日志 |
true |
dcc-python-toolkit.execute.clearOutput |
每次执行新内容时是否清空输出日志 |
true |
dcc-python-toolkit.debug.port |
debugpy 端口,首次 attach 后绑定,修改需重启 DCC |
7012 |
dcc-python-toolkit.debug.justMyCode |
是否只调试用户编写的代码 |
true |
dcc-python-toolkit.pip.indexUrl |
pip 镜像源地址,用于 DCC Setup 时加速 debugpy 安装 |
"" |
开发
cd packages/vscode-extension
npm install
npm run compile
许可证
本项目采用 PolyForm Noncommercial License 1.0.0 授权,仅供非商业用途使用。详见根目录 LICENSE 文件。