发布到 Cadeplay

Cadeplay 是个什么地方

Cadeplay 是一个网页游戏平台，无需安装，在浏览器里点一下就能玩。把游戏打成一个 zip 文件上传，任何人点开链接就能马上玩。

只要能导出为网页版的游戏都能上传。各引擎的导出方法在 Cadeplay 文档里都有整理，和 AI 一起做的 HTML、JavaScript 游戏也能原样上传。

• Unity WebGL
• Godot
• Construct
• Phaser
• PixiJS
• HTML + JavaScript

Cadeplay 技能——把发布流程装进 AI 工具

技能是一组说明文件，AI 编程工具在需要时会加载它。Cadeplay 技能里写着：zip 里该放什么、游戏代码要调用的 SDK、用代码发布的步骤顺序，以及提交通不过审核的原因。

所以你不用背流程。用平常的话提出请求，AI 工具就会加载技能，按其中的步骤执行。不只 Claude Code，遵循同一开放格式的其他工具也能用。技能文件放在你自己的电脑上，所以使用技能并不会向 Cadeplay 发送任何东西。

安装——在 Claude Code 里输入两行

在 Claude Code 里依次输入下面两行，技能就会从插件市场安装好。这是 Cadeplay 推荐的方法，以后更新也只要一条命令。

/plugin marketplace add https://cadeplay.com/dev/skills/marketplace.json/plugin install cadeplay@cadeplay

如果用的是别的 AI 工具，请按 Cadeplay 技能文档的说明操作。文档里既有下载 zip、放进工具读取技能的文件夹的方法，也有复制安装说明、交给 AI 工具执行的方法。

连接项目——令牌放进 .env

如果是以插件方式安装的，就在游戏文件夹里输入下面的命令；否则对 AI 工具说“运行 cadeplay init”。它会创建存放令牌的 .env，并把它加入 .gitignore，让令牌不会被提交到仓库。第一个令牌只需在 Cadeplay 控制台的令牌页面创建一次。

/cadeplay:init

这样提请求

• 把这个游戏部署到 Cadeplay
• 给这个游戏加上云存档和排行榜
• 配置 GitHub Actions，推送标签时自动部署
• 注册十二个成就，并让游戏代码能解锁它们
• 构建一直失败，帮我查出原因

发布共六步——第三步就已经能玩了

在 Cadeplay 上发布按下面的顺序进行。完成前三步你就能亲自玩，剩下的步骤是为了把游戏公开给所有人。

1. 1
   创建游戏条目 在控制台或通过 API 注册游戏。
2. 2
   上传 zip 并通过检查 上传的文件会被自动检查。缺少入口文件或混入可执行文件，都会被拒绝。
3. 3
   把构建切换为正式版本 把通过检查的构建指定为对外提供服务的版本。 到这里就能亲自玩了
4. 4
   商店介绍与图片 撰写游戏介绍文案，准备图片。
5. 5
   提交审核 为了上架公开列表而申请审核。
6. 6
   在游戏目录中公开 审核通过后，游戏会出现在 Cadeplay 的游戏列表里。

装了技能，这六步都可以用一句话交给 AI 工具。介绍文案的初稿也可以让它写，但提交前一定要由人读过、改过。

上传前请确认

game.zip
├── index.html
├── game.js
└── assets/

game.zip
└── dist/
    └── build/
        └── index.html

• 打开 zip 时，index.html 是在最顶层或往下一层吗？直接压缩整个文件夹、多出一层目录，是最常见的失败原因。
• 构建工具的基础路径（base）设成相对路径了吗？这样在你的电脑上和在 Cadeplay 上才会表现一致。
• .php、.sh、.exe 这类可执行文件有没有混进去？构建工具遗留的一个文件，就足以被拒绝。
• 没有自己加入 Web 应用清单或 Service Worker 吧？Cadeplay 会替你加上。
• 所有素材——包括用 AI 生成的图像和声音——你都有使用权吗？
• 游戏地址名称（主机标签）要慎重决定，在第一次公开的那一刻就永久固定了。