首页 / 资讯中心 / 文章详情

OhMyGame 插件系统完整指南:从零开发你的第一个 Skill 插件与 MCP 服务

OhMyGame 插件系统完整指南:从零开发你的第一个 Skill 插件与 MCP 服务 ★ FEATURED ARTICLE
人工智能AI 应用AI Agent游戏开发代码智能体媒体生成【免费下载链接】ohmygameThe open-source studio for making games with AI. Your own one-person game studio. Everything you need to make games with AI, in one app. Game canvas. Bring your own key.项目地址https://gitcode.com/gh_mirrors/oh/ohmygame点击查看免费下载OhMyGame 是一款开源的 AI 游戏创作工作室而它的插件系统正是让 AI 能力无限扩展的核心。本指南带你从零开始理解 Skill 与 MCP 两种插件形态、写出第一个SKILL.md、接入 MCP 服务并用内置的 AI 助手一键构建、验证、安装你的专属 OhMyGame 插件。无需深厚工程背景跟着做即可上手。一、插件是什么Skill 与 MCP 双形态在 OhMyGame 中插件Plugin是安装能力的统一入口你可以在同一个地方安装 Skill 与 MCP 服务、修改配置、测试连接、完成授权。一个插件包可以同时包含Skill技能一份份写给 AI 的操作手册教会模型如何完成特定任务例如 Phaser 2D 游戏开发、精灵图资产管线、Godot 工程操作等。Skill 可以附带脚本、参考资料和资源文件。MCP 服务声明已存在的 STDIO 或 HTTP MCP 服务器让 AI 通过标准协议调用外部工具如 Godot MCP、第三方 API。仓库自带了丰富的原生插件是最好的学习样本内置插件形态路径Web Game Studio9 个 SkillPhaser、Three.js、UI、试玩等plugins/web-game-studio/skills/Game Studio3 个 Skill游戏基础、QA、流程plugins/game-studio/skills/Three.js WorldSkill 参考资料目录plugins/threejs-world/skills/GodotMCP 服务STDIOplugins/godot/mcp.json二、插件包结构速览3 个文件就够用一个最小插件包只需要.ohmygame-plugin/plugin.json清单文件再按需添加 Skill 目录和 MCP 声明my-service/ ├── .ohmygame-plugin/plugin.json # 清单名称、版本、能力声明 ├── skills/my-skill/SKILL.md # Skill 定义可选 └── mcp.json # MCP 服务器声明可选清单里最重要的字段namekebab-case 命名、version语义化版本、descriptionskills: ./skills/—— 声明 Skill 目录mcpServers: ./mcp.json—— 声明 MCP 配置文件configuration—— 用户可填写的配置项支持text、secret、path、boolean、select五种类型interface—— 显示名、图标预设图标或自定义 PNG/WebP不超过 1 MB、2048×2048 像素、适用项目类型如web-game、godot-game 清单校验逻辑位于 src/shared/plugins.ts版本兼容性判断formatVersion、minimumHostVersion在 src/daemon/plugin-contract.ts。所有路径都相对插件根目录、以./开头不用的字段直接省略即可。三、编写你的第一个 Skill 插件Skill 的本质是一个带 YAML frontmatter 的 Markdown 文件路径固定为skills/skill-name/SKILL.md--- name: web-game-studio description: Create complete browser games from short ideas, coordinating canvas design, visual mockups, art, implementation, and playtesting. --- # Web Game Studio Use this skill for new browser games...frontmatter 中name和description是必填项——AI 创作流程在安装前会强制校验缺失将导致安装失败。写法上遵循仓库内置的官方写作规则src/daemon/plugin-authoring.ts写小而专注描述它做什么、什么时候用写模型自己不知道的可复用指引按需添加支撑文件可重复/易错的操作放脚本条件性细节放references/资源放assets/并在正文中链接引用——参考 plugins/threejs-world/skills/threejs-world/ 的组织方式使用包内相对路径绝不引用构建器路径保证插件可移植不要重复造轮子Skill 运行在游戏项目中可直接使用宿主已启用的媒体工具与 Godot 连接。一个优秀的范例是 plugins/web-game-studio/skills/web-game-studio/SKILL.md它先让 AI 按create/feature/bugfix等模式分类任务再按领域路由到 8 个专家 Skill最后约定保持预览命令可运行、iframe 内响应式等宿主契约。四、声明 MCP 服务与用户配置在mcp.json中声明你要接入的 MCP 服务器STDIO 与 HTTP 两种传输都支持{ mcpServers: { godot: { command: npx, args: [-y, coding-solo/godot-mcp0.1.1] } } }这正是官方 Godot 插件 plugins/godot/mcp.json 的写法。要点STDIO 服务用commandargs可加env务必锁定包版本如npx -y pkg1.2.3HTTP 服务用urlheaders配置值用${config.字段ID}插值引用例如url: ${config.endpoint}、Authorization: Bearer ${config.api-key}密钥永远声明为secret类型用户填的值存入本地加密存储任何配置 API 都不会回显也绝不该写死在包文件里用户未填写的字段会让对应服务保持未配置但不影响其他已配置的服务和 Skill。配置项与服务器定义的完整字段模式定义在 src/shared/plugins.tsMCP 宿主运行时会话、OAuth、工具命名空间实现在 src/daemon/plugin-mcp-host.ts。五、三种创建与安装路径路径 1AI 助手一键构建推荐新手在 Plugins 页面点击Create with AI打开专属的 Plugin Builder 页面。它会包含一段对话和四个预览视图Overview概览、Files文件、Setup配置、Checks检查。助手会在独立工作区中编写 Skill 与支撑文件调用plugin_manage prepare校验草稿你审阅后点击Install plugin完成安装后续修改用Update plugin更新。每个工作区独立持久化可随时恢复或删除。路径 2在游戏项目对话中直接开发每个 Pi 智能体环境都会自动写入内置的plugin-creatorSkill见 src/daemon/pi-agent.ts。你只需在游戏项目对话中用自然语言描述需求助手会创建插件目录并调用install_plugin工具完成校验与安装——校验规则与 AI 构建器完全一致。路径 3手工编写 文件夹安装自己写好包结构后通过Add plugin菜单从本地文件夹或 Git 仓库安装。安装器src/daemon/plugin-installer.ts会同时识别多种格式原生.ohmygame-plugin/、Codex/Claude 插件清单甚至约定俗成的skills/目录发现逻辑见 src/daemon/plugin-discovery.ts。导入的插件统一进入Personal分组与官方Public分开展示但共享同一套开关与配置体系。六、检查、导出与常见注意事项✅依赖检查详情页的Check dependencies会读取 PATH、MCP 命令与工作目录报告缺失工具、未锁定的npx版本和机器相关路径——注意它不会实际执行插件命令连接测试使用隔离的临时 MCP 会话只列出能力、不调用业务工具用完即关导出与恢复个人插件可导出为 ZIP上限 50 MB通过Add plugin → Import plugin archive恢复导出会自动把敏感 MCP 字面量转成必填 secret 字段但不包含平台凭据、OAuth 会话与 AI 对话历史新环境需重新授权⚠️保持 ID 稳定跨版本更新请固定插件名、配置字段 ID 与类型——宿主按插件 ID 保存用户配置破坏性变更需要新的插件身份范围边界当前不支持在插件内生成全新 MCP 服务器、Pi 扩展、hooks 或自定义插件界面请只复用已有的 MCP 服务。七、延伸阅读 官方插件文档最全参考docs/plugins.md 端到端测试凭据隔离、重启持久化、真实 STDIO/HTTP 工具发现与执行、OAuth 模拟test/plugin-capabilities.test.ts 预装插件清单示例config/preinstalled-plugins.json 更多 AI 使用细节docs/README.md现在打开你的 OhMyGame用一句话描述你想象的插件——比如给 Godot 项目加一套自动命名规范 Skill——剩下的交给 AI 助手。你的第一个 Skill 插件与 MCP 服务几分钟就能跑起来 赞分享人工智能AI 应用AI Agent游戏开发代码智能体媒体生成【免费下载链接】ohmygameThe open-source studio for making games with AI. Your own one-person game studio. Everything you need to make games with AI, in one app. Game canvas. Bring your own key.项目地址https://gitcode.com/gh_mirrors/oh/ohmygame点击查看免费下载相关推荐OpenMOSS Skill插件系统开发指南从零打造你的第一个可插拔Agent能力包OpenMOSS Skill插件系统开发指南从零打造你的第一个可插拔Agent能力包 OpenMOSS 是一个可让多 Agent 自主运行的「AI 公司操作系VuePress 插件开发完全指南从零编写你的第一个插件VuePress 插件开发完全指南从零编写你的第一个插件 本指南以 VuePress 1.x 的插件机制为核心系统讲解插件的两种导出形态、 options前端文档SSR终极RuneLite插件开发指南从零开始创建你的第一个OSRS插件终极RuneLite插件开发指南从零开始创建你的第一个OSRS插件 RuneLite作为开源的Old School RuneScape客户端允许玩家通过插件游戏开发桌面应用上一篇3步实现低延迟游戏串流Moonlight TV客厅大屏终极解决方案下一篇Windows 11任务栏透明化终极指南用TranslucentTB打造个性化桌面体验创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
阅读完成 · 觉得有帮助?
咨询建站