Roblox 游戏适配

本教程的路径是读取 Roblox 项目的规则、资产和布局，在浏览器引擎中重实现为 H5。.rbxl 和 Lua 脚本不能直接作为 Combos 网页成品上传。不要把 Ball Game 的两段代码当成适用于所有 Roblox 游戏的转换脚本。

运行原项目，列出需要迁移的内容

操作位置： Roblox Studio。

操作： 打开自己的 .rbxl，Play 试玩主要流程，再停止测试。查看脚本、Workspace 场景、人物外观、UI，以及账号、存档、多人等平台依赖。

成功现象： 得到本项目的玩法规则、人物与场景清单，以及需要重实现的平台能力。

确定人物、场景和玩法的处理方式

原项目内容	浏览器端需要做什么
人物外观	可复用有权导出的模型和贴图，也可按原型重建；不要求每个项目都重新手绘
角色控制与镜头	实现浏览器的输入、移动、跳跃、动画驱动、碰撞和跟随镜头
场景与材质	复用或提取布局和资产，在 Web 引擎中加载或创建，重新配置材质与碰撞
Lua 玩法规则	理解原规则，用所选引擎的 API 实现；不能只替换语法
Roblox 服务端与平台能力	多人、存档、账号、Robux 等逐项设计替代方案；本案例只处理单机玩法

选择 Three.js、Cocos、PlayCanvas 等浏览器技术时，以团队经验和游戏需求为准。Ball Game 采用 Three.js + cannon-es + Vite，是这个案例的实现选择，不是 Combos 上传要求。不要把“重建角色运行能力”理解成“所有美术资产都必须重画”。

实现并核对自己的游戏

操作位置： 新的 H5 项目和浏览器预览。

操作： 先实现核心单局循环，再补人物、场景、镜头、UI 和必要的平台能力。对照原版检查外观、布局、操作和规则；物理引擎改变后重新调摩擦、质量和阻尼。

成功现象： 自己的原型、场景与玩法在浏览器中可辨认且能运行；每项省略或替换都已说清楚。


请先读取并试玩当前 Roblox 项目，列出原脚本、人物、场景、UI 和平台依赖。
按这个项目自己的资产与规则重实现为 H5，不逐行机械翻译 Lua。
说明哪些资产可复用、哪些运行能力需要重做，保留原版可辨认的人物和场景。
先完成单局核心玩法并在浏览器验证，再构建静态成品。
不要照抄 Ball Game 的关卡坐标或 WinPiece 判定来实现其他游戏。

构建、上传和线上复验

操作位置： 已经重实现好的 H5 工程。

操作： 按这个新工程自己的方式生成 dist，再按发布与更新验证和发布。Ball Game 的 npm 命令只适用于提供的案例工程。

成功现象： Combos 上运行的是自己的 H5 重实现版本；原 Roblox 客户端和服务端能力不会因上传自动迁移。

完整 Ball Game 案例和源码映射见Roblox 案例 · Ball Game。选择“跟做案例”时下载整份源码；选择“接入自己的游戏”时使用本章的方法，并按自己的项目实现。

来源：Combos 开发者接入指南。原文核对日期：2026-10-08，CLI v1.14.2；案例结果为原文记录的实测结果。