SuperAPI AI 工具集

server-architecture

编程与开发

查看项目

更新于 10-16 22:43

技能介绍

Server Architecture(服务器架构)是一套面向 Godot 低层级服务器 API 的性能优化蓝图,核心是用 RID(资源 ID)直接访问渲染、物理与导航服务器,绕过场景树节点,以获得最大性能。资料说明这一模式由“基于 RID 的服务器 API、直接渲染/物理访问、对象池”共同构成。

【用途与定位】 该技能面向需要极致性能的场景,属于对 Godot 节点体系的底层替代方案,而非日常开发默认选择。资料明确指出:服务器不应用于原型开发,因为调试服务器代码很痛苦(没有 Inspector、print_tree 或可视化工具)。推荐先用节点实现,待剖析后再优化到服务器层。

【可用脚本】 资料列出两个脚本:

  1. headless_manager.gd:用于专用服务器生命周期管理、参数解析与无头模式优化。
  2. rid_performance_server.gd:专家级服务器封装,提供 RID 生命周期管理与批量操作。

【主要能力与代码示例】 直接访问渲染(不经过节点):创建 canvas item(等价于 2D 精灵)、设置父级、加载纹理的 RID 并绘制纹理矩形。示例代码: var canvas_item := RenderingServer.canvas_item_create() RenderingServer.canvas_item_set_parent(canvas_item, get_canvas_item()) var texture_rid := load("res://icon.png").get_rid() RenderingServer.canvas_item_add_texture_rect( canvas_item, Rect2(0, 0, 64, 64), texture_rid )

PhysicsServer2D(不经过节点创建物理体):创建 body、设置模式为 BODY_MODE_RIGID、创建圆形形状并设置半径、将形状赋给 body。示例代码: var body_rid := PhysicsServer2D.body_create() PhysicsServer2D.body_set_mode(body_rid, PhysicsServer2D.BODY_MODE_RIGID) var shape_rid := PhysicsServer2D.circle_shape_create() PhysicsServer2D.shape_set_data(shape_rid, 16.0) # radius PhysicsServer2D.body_add_shape(body_rid, shape_rid)

【适用场景】 资料给出服务器适用与节点适用的对照: 适合服务器:程序化生成(数千个对象)、粒子系统、体素引擎、自定义渲染。 适合节点:常规游戏对象、UI、原型开发。

【限制与“绝不要做”清单】 资料列出一系列硬性约束:

  1. 绝不要忘记释放 RID。RenderingServer.canvas_item_create() 若不释放会造成内存泄漏(GC 不追踪 RID),使用完毕必须调用 canvas_item_free(rid)。
  2. 绝不要对同一对象混用服务器 API 与节点。为同一实体同时创建 RID body 和 CharacterBody2D 会引发冲突并造成双倍模拟开销,只能选一种方案。
  3. 绝不要用服务器做原型开发。
  4. 绝不要跳过 RID 校验。对无效 RID 调用 body_set_state(invalid_rid, ...) 会崩溃,应使用 RID.is_valid(rid) 或在 Array/Dictionary 中跟踪 RID。
  5. 绝不要在未做性能剖析前使用服务器——这是过早优化;Godot 4 中节点能很好地处理 1 万以上对象。
  6. 绝不要忘记设置形状变换。PhysicsServer2D.body_add_shape(body, shape) 不带 transform 时形状位于 (0,0) 偏移,需通过 body_set_shape_transform() 设置。
  7. 绝不要用 RenderingServer 做 UI。通过 canvas_item_create() 创建 UI 元素不会有自动分层、输入或主题,UI 应使用 Control 节点。

【参考】 资料指明参考来源为 Godot 官方文档的 “Using Servers”,未提供其他官方文本、收费或价格信息。