世界编辑器核心:场景、演员与触发器

世界编辑器是你 80% 时间待着的地方,但多数人对它的理解停留在"拖东西"。这一篇从数据结构层面把它拆开:场景由哪些属性构成、演员身上藏着六个脚本位、触发器为什么值得单独一节、换背景时碰撞网格发生了什么。理解了模型,很多"玄学行为"就有了官方解释。

场景的数据模型

场景在项目里是一个 .gbsres 资源(存放位置见 项目解剖篇),字段比界面上直观看到的多:

属性说明
名称与符号名称给人看,符号(symbol)供编译器引用
背景一张背景图,尺寸至少 20×18 图块
类型LOGO、平台、顶视角等,决定默认玩家精灵与移动规则
调色板场景级的调色板设置
碰撞数据扁平 number[] 网格,一个数字对应一个图块
世界坐标场景在全局大地图上的摆放位置
玩家精灵可按场景覆盖,不覆盖则按场景类型取默认精灵

场景之下挂着三张列表:演员列表、触发器列表、场景脚本。你在世界视图里摆的一切,最终都归进这三张表。

演员的六个脚本位

每个演员除了精灵表引用、位置与坐标系类型、朝向、移动与动画速度、调色板、固定/持久标志、碰撞组之外,还带六个脚本位——这是角色逻辑的全部挂点:

脚本位触发时机典型用途
交互脚本玩家按键与演员交互对话、买卖、开宝箱
启动脚本(startScript)场景启动时执行按存档进度摆放初始状态
每帧脚本(updateScript)每一帧执行巡逻、追踪、倒计时
三种命中事件(hit)碰撞发生时,按来源分别触发受伤、子弹命中、推动箱子

每帧脚本是唯一持续开销

六个脚本位里只有 updateScript 每帧都跑。掌机硬件不快,重计算尽量挪到启动和交互脚本里,每帧只留轻量逻辑——这是从入门到进阶都管用的纪律。

触发器:区域逻辑

触发器是带位置和尺寸的矩形区域,脚本位只有两个:进入与离开。"走过这片草丛遇敌""离开房间触发剧情""踩上机关地板"全是它。触发器在场景目录下也是独立资源文件,所以一段做好的触发逻辑可以像普通代码一样单独提交、单独回滚——这是 4.x 拆分格式带来的实打实的协作好处。

碰撞网格:换背景不会丢

碰撞数据是一个扁平的 number[] 数组:网格按行展开成一维,每个数字记录一个图块的碰撞类型。关键行为是换背景时碰撞会"遗传"——编辑器会尝试从使用同一背景的场景复用碰撞网格,或者至少保留与重叠区域对应的碰撞。所以给同一张地图做昼夜两个版本时,先做好的那份碰撞会被下一份继承,不用重画。

精灵是四层树

精灵资源的数据结构是 states → animations → frames → metasprite 图块四层:状态(如待机、行走、攻击)下挂动画,动画由多帧组成,每一帧是一个由图块拼成的元精灵。也就是说精灵天然支持多状态多帧。做多状态角色时按这棵树组织素材,把所有动作塞进一个状态里,后面配动画切换时会寸步难行。

玩家精灵的回退规则

玩家精灵可以按场景覆盖;没有覆盖时,按场景类型使用默认精灵。编译器对非 LOGO 场景缺玩家精灵的情况会给出警告并回退。看到这条警告别忽略——它说明该场景没配玩家精灵,游戏跑起来会"借"一个默认精灵顶上,多半不是你想要的观感。LOGO 场景例外,因为开场画面本来就不需要玩家。

下一步

想知道这些场景、演员最终存在哪些文件里,读 GB Studio 项目解剖;六个脚本位里具体写什么、变量和数组怎么用,读 脚本系统详解。

↑