企业官网建设流程全解析

ROYGBIV游戏逻辑深潜：掌握场景、状态机与自定义脚本的实战指南

【免费下载链接】ROYGBIVA 3D engine for the Web项目地址: https://gitcode.com/gh_mirrors/ro/ROYGBIV

ROYGBIV 是一款免费开源的 WebGL 3D 引擎，基于 THREE.js 图形与 CANNON.js 物理构建，专为没有大预算却想做 60 FPS 网页游戏的开发者打造。本文用通俗语言拆解它的三大游戏逻辑核心——场景管理、AI 状态机、自定义脚本，并附本地部署三步教程，帮助你快速上手。

🎮 为什么选 ROYGBIV 3D 引擎：低成本也能做 60 FPS 网页游戏

ROYGBIV 的定位很清晰：面向"有动力但没预算"的程序员——不用买昂贵的 3D 模型、不用买商业引擎授权，就能在浏览器里跑流畅的桌面 + 移动端 3D 应用。

项目自带多个完整 Demo，可以直接打开 demo/ 目录阅读学习：

🗺️ 如何搭建 3D 场景：ROYGBIV 场景管理全解析

在 ROYGBIV 中，场景（Scene）是游戏世界的容器：每把椅子、每面墙、每束灯光、每个粒子系统都要"注册"到某个场景名下。

核心类 Scene.js 里可以看到，一个场景持有这些内容：

• 3D 内容：网格系统、墙体集合、对象、对象组、模型实例
• 视觉特效：粒子系统、粒子池、枪口火焰、闪电、准星
• 2D 界面：文本、精灵、容器、虚拟键盘
• 环境与全局：背景色、天空盒、雾效、灯光、后处理配置

而真正指挥切换的是 SceneHandler.js，调用changeScene时会走一条严谨的流水线：

1. 未就绪则排队：场景还没加载完就切换？请求会被缓存，加载完成后自动补切，不会丢操作
2. 触发退出回调：旧场景执行onBeforeExit，并保存灯光与后处理状态
3. 全面隐藏旧内容（hideAll）：停止动画与拖尾、隐藏所有对象，防止"穿帮"
4. 装载新内容：恢复新场景的背景色、天空盒、雾效、灯光与各类对象
5. 通知 AI 系统：decisionHandler.onAfterSceneChange()，让状态机感知场景变化

💡实战技巧：每个项目都有一个entrySceneName（入口场景）。点击预览时引擎会自动跳回入口场景，就像真正的"开始游戏"按钮。

🧠 AI 状态机：让敌人"活起来"的秘诀

ROYGBIV 把 AI 拆成三层：知识（Knowledge）→ 决策（Decision）→ 状态机（StateMachine），其中状态机由 PreconfiguredStateMachine.js 定义，结构非常直观：

转移的具体结构见 PreconfiguredTransition.js：一条转移就是"源状态 + 目标状态 + 决策名"三要素。

运行时，DecisionHandler.js 会根据这些"预配置"构建真正的Ego.StateMachine实例（Ego 是内置的轻量状态机库），状态一变化就会触发onStateChanged回调——你可以在回调里播放动画、发射武器、切换贴图，把 AI 行为"接"进游戏逻辑。

新手建议：先从 2 个状态（巡逻/逃跑）+ 1 条转移开始，跑通后再往知识里加变量，状态机越复杂越难调试。

📝 自定义脚本：把游戏逻辑写进你的 JS

场景负责"长什么样"，状态机负责"NPC 怎么想"，而自定义脚本负责"游戏规则"。

脚本统一存放在 scripts/ 目录（⚠️ 该目录不可删除）。引擎通过 Script.js 管理每个脚本的生命周期：

• 加载：从./scripts/路径拉取文件内容，用new Function编译成可执行函数
• 启动 / 停止：script.start()把脚本加入每帧执行队列，script.stop()移出队列
• 自动运行：每个脚本可设置runAutomatically，切换设计/预览模式时自动启停
• 性能记录：开启 CPU 统计后，引擎会测量每个脚本每帧的执行耗时，方便定位"卡顿元凶"

几个实用细节：

1. 脚本执行报错时，状态会变为SCRIPT_STATUS_ERROR并打印到终端，不会让整局游戏崩溃
2. 部署模式下脚本运行状态写入SCRIPT_EXECUTION_STATUS_脚本名变量，部署页面可以据此开关脚本
3. 脚本名来自文件路径（下划线拼接），重命名文件等于重命名脚本，引用处记得同步

🚀 本地部署 ROYGBIV 网页游戏：三步上手教程

跟着下面三步，5 分钟内就能在本地跑起来：

第 1 步：克隆仓库

git clone https://gitcode.com/gh_mirrors/ro/ROYGBIV

第 2 步：安装依赖

npm install

第 3 步：启动服务

node server

然后用 Chrome 或 Firefox 访问localhost:8085，进入设计模式后用内置命令行界面创建场景、添加对象、编写脚本，最后一键导出为独立部署文件夹（参考 demo/villeneuvedascq2/README：导出的目录直接serve application.html即可上线）。

⚠️ 常见坑与高频问答

Q：切换场景后旧对象还残留在屏幕上？A：确认旧内容已注册进场景。只有注册过的对象才会被hideAll统一隐藏，游离对象不会被清理。

Q：状态机加了状态却不生效？A：入口状态不能删除（removeState会直接拒绝）；转移必须挂在该状态机名下，且决策条件要能返回"真"才会触发。

Q：scripts 目录可以改名吗？A：不建议。加载路径硬编码为./scripts/，改名后所有脚本都会加载失败。

Q：手机浏览器能玩吗？A：可以。引擎专为移动端优化，demo/jumpPads/ 中的虚拟键盘就是为触屏操作设计的。

写在最后

ROYGBIV 用"场景做容器、状态机做大脑、脚本做规则"的三板斧，把一套完整的 3D 游戏逻辑装进了纯浏览器环境。建议的学习路线：先读 README.md 跑通 Demo → 用 CLI 搭一个多场景小关卡 → 给 NPC 加两状态状态机 → 最后用脚本写出胜负规则。掌握这条主线，你就能在这个开源引擎上做出属于自己的 60 FPS 网页游戏了。

【免费下载链接】ROYGBIVA 3D engine for the Web项目地址: https://gitcode.com/gh_mirrors/ro/ROYGBIV