mcpywrap Wiki

内容整理自 mcpywrap 仓库的 README、docs 与内置 Skill。命令和参数以本机 mcpy <命令> --help 为准；能力是否可用以 mcpy --local doctor --capabilities --json 为准。各版本变化见 更新记录。

入门

安装Python 3.9+，uv 或 pip 安装，确认 mcpy 可用。

第一个项目init、run、edit，从零跑起一个 Addon。

VS Code 插件管理补全、测试世界与原生日志，在编辑器中执行游戏内 Python。

Android 手机开发在手机上编辑源码、构建真实游戏、查看日志与管理测试作品。

AI 接入安装内置 Skill，让 Agent 自己搭环境、跑游戏、截图验收。

项目与依赖

构建与发布build、package、dev 与资源合并规则。

依赖与 QuMod本地 Addon、Git 依赖、QuMod 预设与 sync。

项目脚本before_build / before_package / before_run / before_archive。

依赖的资源准备框架依赖为消费项目处理素材。

本地测试

本地世界实例、会话、世界参数与受控部署。

macOS 平台Apple Silicon 原生运行包、能力边界与资源维护。

图形界面 · mcpy ui图解依赖管理、世界设置、日志、Python 控制台与自动热更。

运行时

运行时调试游戏内 Python、热更与监控。

统一输入observe → run 计划 → 查询结果。

截图与录屏后台截图、Windows 录屏与逐帧提取。

联机与远程

连接服务器connect 连接指定服务器，适合 Nukkit 等服务端开发。

双客户端两名玩家同一世界验证同步。

远程执行Mac 写代码，Windows 跑游戏。

参考

故障排查常见错误与处理方法。