SuperAPI AI 工具集

genre-sandbox

编程与开发

查看项目

更新于 10-16 22:42

技能介绍

用途

本技能是一份面向沙盒类游戏开发者的专家蓝图。沙盒游戏由物理模拟、涌现式玩法和玩家创造力定义,可参考 Minecraft、Terraria、Garry's Mod 等作品。该蓝图围绕如何在 Godot 引擎中构建此类游戏的底层系统给出架构模式、代码参考与性能注意事项。

核心循环

资料将沙盒游戏的核心循环描述为:

  • 探索:玩家发现世界规则与材料
  • 实验:玩家测试交互(例如火燃烧木头)
  • 建造:玩家搭建结构或机器
  • 模拟:游戏运行物理/逻辑系统
  • 分享:玩家保存/分享创作
  • 涌现:简单规则产生非预期的复杂行为

主要能力与架构模式

1. 元素系统(基于属性的涌现)

该模式的要点是建模材料属性而非行为,交互从属性叠加中自然涌现。资料给出 element_data.gd 示例,定义了 ElementData 资源类,包含类型枚举(SOLID、LIQUID、GAS、POWDER),以及 id、type、density、flammable、ignition_temp、conductivity、hardness 等属性。其中 should_swap_with 方法处理了密度相同但类型不同的边缘情况,方案是使用次级排序(类型枚举优先级:SOLID > LIQUID > POWDER > GAS)。

2. 元胞自动机网格(下落沙模拟)

资料强调更新顺序很关键,自顶向下可防止粒子“瞬移”。示例代码 world_grid.gd 使用 Dictionary 存储 Vector2i -> ElementData,并维护 dirty_cells 数组。在 _physics_process 中对脏单元格按 y 排序后逐个模拟,模拟完成后清空。simulate_cell 对 LIQUID/POWDER 尝试向下、左下、右下移动,对 GAS 则向上移动。资料也给出边缘情况:若多个粒子想移入同一单元格,方案是只标记目标为脏,不进行双重交换,下一帧再解决冲突。

3. 工具系统(策略模式)

该模式将输入与世界修改解耦。示例 tool_base.gd 定义 Tool 资源类与 use 方法;tool_brush.gd 实现圆形笔刷,按半径遍历网格并依据圆形边界条件放置元素。资料还给出后备方案:若元素放置失败(如被不可破坏方块占据),在 set_cell() 前检查 world.can_place(target) 并给出视觉反馈。

4. 分块渲染(3D 体素)

资料附有 voxel_chunk_manager.gd 脚本,说明使用 MultiMeshInstance3D 对数千体素进行分块渲染,包含贪婪网格化模式与性能说明。给出的专家决策树为:

  • 小型世界(< 10 万方块):单 MeshInstance 配合 SurfaceTool
  • 中型世界(10 万至 100 万方块):分块 MultiMesh
  • 大型世界(> 100 万方块):分块 + 贪婪网格化 + LOD

存档系统

资料提供 chunk_save_data.gd,使用行程长度编码(RLE)压缩分块数据。示例 encode_chunk 将每行每列的方块类型打包为 [type_id, count, type_id, count...] 格式的 PackedInt32Array。资料给出的压缩示例为:空分块(16×16 = 256 个空气方块)不使用 RLE 需 256 个整数即 1024 字节,使用 RLE 则只需 [0, 256] 共 8 字节,实现 128 倍压缩。

玩家创作的物理关节

资料给出 joint_tool.gd,用于在两个 RigidBody2D 之间创建铰链(PinJoint2D),设置锚点与 softness。并处理边缘情况:若关节存在时刚体被删除,Godot 4.x 中关节会自动断裂,但孤立的 Node 会泄漏内存,方案是将 tree_exiting 信号连接到 joint.queue_free()。后备方案为:若玩家将关节附加到静态几何体,在创建关节前检查 body.freeze == false。

沙盒游戏中绝不应做的事

资料逐条列出禁用做法及替代方案:

  • 绝不每帧模拟整个世界:只更新最近有变化的“脏”分块,休眠分块会浪费 90% 以上 CPU,使用空间哈希追踪活动区域。
  • 绝不为体素使用独立 RigidBody 节点:1000 个以上物理体会立即崩溃;流体/沙使用元胞自动机,固体方块使用静态碰撞,仅对玩家放置的物体使用动态刚体。
  • 绝不保存每个方块的绝对变换:256×256 世界即 65,536 个方块,应使用基于分块的 RLE,如 {type:AIR, count:50000} 压缩大块空白区域。
  • 绝不每帧更新 MultiMesh 实例变换:这会强制更新 GPU 缓冲区,应批量修改,仅在变化时重建分块而非每 tick 都重建。
  • 绝不硬编码元素交互(如 if wood + fire: burn()):应使用基于属性的系统,如 if temperature > ignition_point and flammable > 0,从而让玩家发现涌现式组合。
  • 绝不为每个网格单元使用 Node:Node 有 200 字节以上开销,百万方块世界仅节点元数据就需 200MB 以上;应使用带类型的 Dictionary 或按 position.x + position.y * width 索引的 PackedInt32Array。
  • 绝不针对所有体素做射线检测来放置工具:应使用网格量化 floor(mouse_pos / block_size) 直接计算目标单元格,射线检测随体素数量呈 O(n)。

Godot 专属专家笔记

  • MultiMeshInstance3D.multimesh.instance_count 必须在缓冲区分配前设置,无法动态增长,需要重新创建。
  • RigidBody2D.sleeping:刚体在无运动 2 秒后自动休眠,可用 apply_central_impulse(Vector2.ZERO) 在不施力的情况下强制唤醒。
  • GridMap 与 MultiMesh 对比:GridMap 使用 MeshLibrary(适合多样性),MultiMesh 使用单一网格(适合速度);可结合使用——GridMap 用于结构,MultiMesh 用于地形。
  • 连续碰撞检测(Continuous CD):continuous_cd 需要凸形碰撞形状,投射物应使用 CapsuleShape2D,而非 RectangleShape2D。

适用场景与限制

本技能适用于使用 Godot 引擎开发体素或二维沙盒类游戏的场景,尤其是涉及下落沙模拟、流体、玩家建造与物理交互的项目。资料中的脚本参考为 GDScript,主要面向 Godot 4.x。其内容属于开发蓝图与模式参考,不涵盖完整游戏成品、美术资源、商业化或发布流程;其余平台、价格、效果等事实资料暂未提供。