CocosEditor01 / UI
UI 位置与尺寸调整
微调已开放的布局属性，直接观察运行中游戏的反馈。
Runtime Editor for Cocos2d-x
CocosEditor
为 Cocos2d-x 打造的运行时编辑器
检查、编辑、调试。
直接在正在运行的游戏中完成。
CocosEditor 是面向 Cocos2d-x 项目的运行时编辑与调试工具。无需反复修改代码、编译和重启游戏，即可实时调整 UI 并定位运行时问题。
Windows x86 / x64 编辑器 · 需要接入 Runtime SDK
连接正在运行的游戏后，可以查看实时节点树、选择节点、检查和修改组件属性、浏览资源、查看日志，并通过 MCP 将游戏运行时能力开放给 AI 工具。
Why CocosEditor / 为什么使用
减少重复操作，
更快确认每次调整。
一次小小的 UI 调整，不必重新走完整个开发流程。连接已经运行的游戏，直接检查当前场景和真实状态。
传统迭代流程
- 修改代码
- 编译
- 启动
- 进入场景
- 检查
- 重复
每次调整位置、尺寸或可见性，都需要重复准备和验证。
使用 CocosEditor
- 连接
- 检查
- 编辑
- 立即看到结果
在当前运行会话中修改受支持的属性，直接观察反馈。
01 / Live Hierarchy
查看实时场景节点树
浏览正在运行的游戏中实际存在的节点层级。
快速找到 UI 节点，查看父子关系，定位层级嵌套和绘制顺序问题。直接查看当前的 Cocos2d-x 节点树，不必仅凭代码推断运行状态。
在 Game 或 Hierarchy 中选择节点，即可在 Inspector 中检查同一个对象。
02 / Runtime Inspector
实时检查与修改属性
选中节点后，在游戏运行中查看或修改受支持的组件属性。
通过 Cocos2d-x Inspector 调整已开放的位置、尺寸、缩放、可见性、颜色和文字等属性。受支持的修改直接作用于实时节点，并反映在 Game 画面中。
无需重新编译。无需重启游戏。即时反馈。
Inspector → Game修改受支持的数值，在上方实时 Game 画面中观察所选节点的变化。
运行时修改作用于当前会话，不会自动保存到源码或 CSB/CSD 文件。
03 / Runtime Debugging
让运行时状态直接可见。
面向日常开发的 Cocos2d-x 调试工具。在游戏运行中调整 UI，将画面、节点、属性、资源和日志放在一起检查。
02 / HIERARCHY
节点层级检查
找到实时节点，追踪画面背后的父子关系。
03 / INSPECTOR
组件属性检查
查看选中节点，修改其运行时接入所开放的属性。
04 / STATE
运行时状态调试
检查实时可见性、变换与受支持的属性值，定位异常表现。
05 / ASSETS
资源浏览
在 Assets 面板中浏览和查找项目资源，与 Game 画面配合使用。
06 / LOGS
日志检查
集中查看编辑器与运行时输出，支持搜索、通道与等级筛选。
04 / MCP & AI Integration
将 AI 连接到运行中的游戏
CocosEditor 通过 MCP 开放运行时能力，让兼容的 AI 客户端和开发工具检查并操作正在运行的游戏。
通过 Cocos2d-x MCP 工具定位节点、检查受支持的属性，辅助开发与运行时调试。实际可用操作取决于已连接运行时所声明的能力。
- AI 客户端兼容的客户端与开发工具
- CocosEditor
- 运行中的 Cocos2d-x 游戏实时节点 · 受支持属性 · 运行时反馈
How It Works / 使用流程
三步连接实时场景。
接入 SDK 后，在 CocosEditor 中配置游戏路径并一键挂载，即可使用 Hierarchy、Inspector、Logs 与受支持的 MCP 能力。
接入 CocosEditor Runtime SDK
选择版本匹配的 SDK，按照目标平台指南接入。C++ 和 Lua 项目都需要完成原生 SDK 接入。
启动 CocosEditor，配置游戏路径
打开 CocosEditor，设置已接入 SDK 的游戏路径。
一键挂载游戏
在 CocosEditor 中挂载已配置的游戏，即可查看实时节点、修改受支持的属性并检查日志。
Supported Environment / 支持环境
确认你的项目环境。
桌面编辑器与游戏运行时有各自的要求。接入前请确认 SDK 兼容性。
- 桌面编辑器
- Windows x86 / x64Windows 10 1809（Build 17763）或更高版本，请按使用环境选择编辑器架构。
- 桌面运行环境
- .NET 10 Desktop Runtime x86 / x64请选择与编辑器架构匹配的运行时。从 Microsoft 获取。
- Windows 游戏运行时
- Windows x86 / x64当前引擎适配器为 Cocos2d-x 3.9，SDK 架构须与游戏架构匹配；其他引擎版本需要另行评估兼容性。
- 项目语言
- C++ / Lua检查原生 Cocos 节点与已开放的组件属性。Lua 项目同样需要接入原生 Runtime SDK。
- Android 游戏运行时
- Android ARM64 · 仅 Debug · API 23+需要版本匹配的 SDK 源码模块、Gradle / ndk-build、ADB 与 scrcpy。目前没有独立的 Android SDK 下载包。
- 接入要求
- 版本匹配的 Runtime SDKSDK 必须对应目标游戏平台和架构，并与编辑器版本完全一致。编辑器与游戏各自选择对应架构。
Get CocosEditor / 联系获取
让游戏状态，
一目了然。
目前尚无公开安装包。请通过邮箱联系作者，申请获取 Windows x86 或 x64 编辑器与版本匹配的 Runtime SDK。
Windows x86 / x64 · 邮箱联系获取来信请说明 Cocos2d-x 版本、项目使用 C++ 还是 Lua，以及游戏的目标平台与架构。
联系作者
可来信咨询安装包获取方式与项目的 SDK 兼容性。GitHub 继续用于技术文档、问题反馈与版本历史。
FAQ / 常见问题
连接前，先了解这些。
实时查看游戏，同时明确运行时修改与项目文件的边界。
CocosEditor 是什么？
CocosEditor 是面向 Cocos2d-x 的运行时编辑与调试工具。连接已接入 SDK 的游戏后，可以查看实时节点树、修改受支持的组件属性、浏览资源、查看日志，并通过 MCP 开放受支持的运行时能力。
CocosEditor 会修改我的 Cocos2d-x 项目吗？
首次接入 Runtime SDK 需要调整原生工程配置，并接入启动与退出生命周期。连接后，Hierarchy 与 Inspector 操作的是运行中的游戏状态；运行时属性修改不会自动重写项目源码或场景资源文件。
是否需要接入 SDK？
需要。游戏必须接入对应目标平台的 CocosEditor Runtime SDK，且版本与编辑器匹配。C++ 和 Lua 项目都需要完成这一步。
运行时修改可以保存回项目吗？
运行时修改不会自动回写 Cocos2d-x 项目源码、CSB、CSD 或其他场景资源。Inspector 中的修改应视为当前运行会话的状态调整。如果需要持久保存，请通过项目原有的代码或资源编辑流程应用最终数值。
支持 Lua 项目吗？
支持已接入原生 Runtime SDK 的兼容 Cocos2d-x 项目，可检查包括 Lua 创建的实时 Cocos 节点及受支持的组件属性。这不代表支持任意 Lua 变量检查或完整的 Lua 源码调试器。
MCP 集成是什么？
MCP 是 Model Context Protocol（模型上下文协议）。CocosEditor 提供工具，供兼容的 AI 客户端检查和操作已连接的游戏运行时，辅助开发与调试。实际可用工具取决于运行时支持的能力。配置与操作详情请参阅 MCP 接口文档。
如何获取 CocosEditor？
目前尚无公开安装包。请通过 email@tonychenn.cn 或 gogle.huiy@gmail.com 联系作者，申请获取编辑器与版本匹配的 Runtime SDK。来信请说明引擎版本、项目语言与目标平台。
CocosEditor 免费吗？
CocosEditor 与 SDK 的使用以各版本附带的许可条款或最终用户许可协议为准，请在使用前查看相应条款。GitHub 仓库用于分发版本和文档，不是编辑器的开源源码仓库。