mcpdb

KO | EN

gitlite — search

#hacktoberfest #llm #go #machine-learning #rust #linux #docker #macos #nodejs #cli #kubernetes #awesome-list #ios #open-source

(★ 26)

一个我的世界中国版基岩版 Python 调试器后端，简单实现了 DAP 协议。

mcpdb Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MCPDB

一个我的世界中国版基岩版 Python 调试器后端，简单实现了 [DAP](https://microsoft.github.io/debug-adapter-protocol/) 协议。

由于中国版未导出 Python API，本项目通过内存技术实现对游戏内嵌 Python 2.7 解释器的访问和控制。

```
┌─────────────────────────────────────┐
│           VS Code / IDE             │
│        (DAP Client - debugpy)       │
└──────────────────┬──────────────────┘
                   │ TCP (DAP/JSON)
                   ▼
┌─────────────────────────────────────┐
│        MCPDB (mcpdb.dll)            │
│   DAP Core / Python Wrapper / Hook  │
└──────────────────┬──────────────────┘
                   │ Hook
                   ▼
┌─────────────────────────────────────┐
│  Minecraft China Bedrock (Py 2.7)   │
└─────────────────────────────────────┘
```

## Build

需要 Windows x64, MSVC 2022+, [xmake](https://xmake.io/), C++20。

```bash
xmake
```

产物：`mcpdb.dll` 和 `mcdbg.exe`

## Usage

> 如果使用其他前端启动器（如 [mcdk](https://github.com/GitHub-Zero123/MCDevTool)），请参考对方的配置文档而不是此处的启动说明。

1. 启动 `Modpc`
2. 运行 `mcdbg.exe`
3. VS Code 配置 `launch.json`：

```jsonc
{
  "configurations": [
    {
      "name": "Minecraft Modpc Debug",
      "type": "debugpy",
      "request": "attach",
      "connect": {
        "host": "localhost",
        "port": 5678 //由 mcdbg 控制, -p 参数可修改端口
      },
      "pathMappings": [
        {
          "localRoot": "${workspaceFolder}",
          "remoteRoot": "${workspaceFolder}"
        }
      ],
      "justMyCode": false
    }
  ]
}
```

4. 设置断点，F5 附加调试

## Dependencies

[nlohmann_json](https://github.com/nlohmann/json),
[fmt](https://github.com/fmtlib/fmt),
[detours](https://github.com/microsoft/Detours),
[expected-lite](https://github.com/martinmoene/expected-lite)

## Notice

- 仅供学习研究
- 特征码可能随游戏更新失效

## License

MIT License

本项目 `src/py/` 目录下的 Python 头文件来自 [Python 2.7](https://www.python.org/)，采用 [PSF License](https://docs.python.org/2/license.html)。

mcpdb

mcpdb Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

mcpdb

mcpdb Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README