一个用于我的世界中国版模组开发的一站式 VSCode 工具插件
功能
- 官方调试器支持：通过官方调试器接口进行 Python 调试，启动并自动管理调试会话
- 支持多客户端调试，自动分配可用端口
- 一键启动
mcdk.exe 启动游戏开发测试
- 侧边栏可视化配置面板（皮肤编辑、昼夜更替、窗口样式等）
游戏启动测试
- 按
Ctrl+F5 自动启动ModPC并不带调试器附加的开发测试
- 插件会自动：
- 搜索系统环境中的ModPC包
- 启动
mcdk.exe 进行开发测试
调试器使用方法
方式一：官方调试器（推荐）
- 按
F5 选择 "Minecraft Python Debug" 调试配置
- 插件会自动：
- 通过 mcdk 启动游戏并附加 Python 调试器
- 通过 ptvsd 官方接口建立调试连接
- 支持多客户端同时调试，自动端口分配
launch.json 配置示例：
{
"type": "mcdev-tools",
"request": "launch",
"name": "Minecraft Python Debug",
"timeout": 60000,
"dapConfig": {
"justMyCode": false
}
}
方式二：注入调试（mcdbg）
- 按
F5 选择 "Minecraft Debug (Inject)" 调试配置
- 插件会自动：
- 查询运行中的 Minecraft 进程
- 使用 mcdbg 注入 debugpy 到目标进程
- 连接 Python 调试器
launch.json 配置示例：
{
"type": "mcdev-tools-inject",
"request": "launch",
"name": "Minecraft Debug (Inject)",
"port": 5678,
"dapConfig": {
"justMyCode": false
}
}
配置项
在 VS Code 设置中可以配置以下选项：
通用配置
| 配置项 |
默认值 |
说明 |
mcdev-tools.timeout |
60000 |
等待调试器就绪的超时时间（毫秒） |
mcdev-tools.mcdkPath |
(内置) |
mcdk.exe 路径（留空使用插件内置） |
mcdev-tools.enable |
false |
强制启用插件（默认 false 自动扫描 Addon 结构） |
官方调试器（ptvsd）配置
| 配置项 |
默认值 |
说明 |
mcdev-tools.ptvsd.enabled |
true |
是否启用 ptvsd 调试模式 |
mcdev-tools.ptvsd.ip |
localhost |
ptvsd 调试 IP 地址 |
mcdev-tools.ptvsd.port |
5678 |
ptvsd 调试端口（多客户端自动分配） |
mcdev-tools.ptvsd.justMyCode |
false |
是否仅调试用户代码 |
mcdev-tools.ptvsd.debugOptions.showPrivateMembers |
true |
显示私有成员（以 _ 开头） |
mcdev-tools.ptvsd.debugOptions.showSpecialMembers |
true |
显示特殊成员（以 __ 开头和结尾） |
mcdev-tools.ptvsd.debugOptions.showFunctionMembers |
true |
显示函数成员 |
mcdev-tools.ptvsd.debugOptions.showBuiltinMembers |
true |
显示内置成员 |
前置要求
相关项目
- mcpdb - Minecraft Python 调试器核心（为旧版本提供注入模式）
- mcdk - Modpc 开发测试启动器
贡献者
感谢所有为本项目做出贡献的开发者！
| |
