SuperAPI AI 工具集

roblox-performance

编程与开发

查看项目

更新于 10-16 09:41

技能介绍

用途

Roblox Performance 用于对 Roblox 游戏进行性能分析和性能预算管理,主要面向需要定位和修复性能问题的场景,包括帧率过低、卡顿、内存占用过高、网络负载过大、低端手机运行缓慢以及热路径优化等。该技能建议在需要剖析性能与设定性能预算时加载;涉及对象池与生命周期模式时,可参考 roblox-luau-patterns。

主要能力

性能分析工具

  • MicroProfiler(Ctrl+F6):提供脚本、物理、渲染的逐帧细分。
  • Developer Console(F9):查看内存、网络、渲染和服务器统计。
  • Script Profiler(Ctrl+Alt+F5):查看每个脚本的 CPU 与堆(heap)占用。
  • 标记手段:使用 debug.profilebegin/debug.profileend 标记区域,使用 debug.setmemorycategory 标记内存类别;插桩应置于开关(flag)之后。

性能目标

技能给出以下起始目标与需要调查的阈值:

指标 起始目标 需要调查的阈值
服务器心跳 < 16ms > 33ms
客户端 FPS(桌面) 60 < 30
客户端 FPS(移动端) 45 < 30
内存 视设备而定 持续增长

优化应针对测量出的热路径,而非传言;节流(Throttle)应基于测量;发布后需重新剖析。

并行 Luau

仅在剖析确认存在可隔离的 CPU 工作后,才使用 Actors。工作线程负责计算,在受限制的 DataModel 写入前需要同步。不要依赖跨 Actor 的共享模块状态。SendMessage 会复制数据;SharedTable 支持共享状态和原子更新。

热循环成本模型

Luau 会优化全局导入;避免传言的函数提升(hoisting)或展开(unrolling)。环境不纯(Environment impurity)可能导致优化被禁用。除 CPU 外,也要剖析内存分配;GC 成本可能稍后才出现。

对象池

预克隆并复用。规范的对象池代码(token-lease 所有权模型)见 roblox-luau-patterns。

StreamingEnabled 要点

  • 默认开启。作用范围为容器级:只有 Workspace 的后代会被流式加载。
  • ModelStreamingBehavior = Improved 会连同父 Model 流式加载非 BasePart 后代;Legacy 仅流式加载 BaseParts。
  • 流出(Streamed-out)意味着被设为 nil 的父级,而非被销毁。若重新流入,Luau 引用会保留。
  • Studio 中的配置:目标默认 1024,最小 64;设置 StreamingIntegrityMode;根据数据调优。
  • 注意事项:如果 DistantPart 被流出,FindFirstChild("DistantPart") 会返回 nil。应使用带超时的 WaitForChild。

移动端

在低端设备上剖析几何体、纹理、粒子、UI 和阴影。

使用方式

该技能以按需加载的形式提供,包含快速参考与完整参考文档。完整参考(含代码示例和 API 表)见 references/full.md。

适用场景

适用于 Roblox 游戏的性能剖析、性能预算设定、并行 Luau 评估、对象池设计、StreamingEnabled 行为理解,以及移动端低端设备性能排查。

限制

资料未提供该技能的收费、价格、平台支持范围或具体效果数据;相关事实暂未提供。以上内容均基于技能文档描述整理,未编造额外功能或步骤。