MC Dev Tools

一个用于我的世界中国版模组开发的一站式 VSCode 工具插件

功能

• 官方调试器支持：通过官方调试器接口进行 Python 调试，启动并自动管理调试会话
• 支持多客户端调试，自动分配可用端口
• 一键启动 mcdk.exe 启动游戏开发测试
• 侧边栏可视化配置面板（皮肤编辑、昼夜更替、窗口样式等）

游戏启动测试

1. 按 Ctrl+F5 自动启动ModPC并不带调试器附加的开发测试
2. 插件会自动：
   • 搜索系统环境中的ModPC包
   • 启动 mcdk.exe 进行开发测试

调试器使用方法

方式一：官方调试器（推荐）

1. 按 F5 选择 "Minecraft Python Debug" 调试配置
2. 插件会自动：
   • 通过 mcdk 启动游戏并附加 Python 调试器
   • 通过 ptvsd 官方接口建立调试连接
   • 支持多客户端同时调试，自动端口分配

launch.json 配置示例：

{
    "type": "mcdev-tools",
    "request": "launch",
    "name": "Minecraft Python Debug",
    "timeout": 60000,
    "dapConfig": {
        "justMyCode": false
    }
}

方式二：注入调试（mcdbg）

1. 按 F5 选择 "Minecraft Debug (Inject)" 调试配置
2. 插件会自动：
   • 查询运行中的 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	显示内置成员

前置要求

• 安装 Python 扩展
• mcdk.exe（插件内置或从 mcdk 获取）
• mcdbg.exe（注入模式需要，插件内置或从 mcpdb 获取）

相关项目

• mcpdb - Minecraft Python 调试器核心（为旧版本提供注入模式）
• mcdk - Modpc 开发测试启动器

贡献者

感谢所有为本项目做出贡献的开发者！

• Dofes
• Zero123