关于 godot-optimization
godot-optimization 是面向 Godot 开发者的性能分析与优化技能,适用于 2D 和 3D 游戏。内容涵盖瓶颈诊断,以及脚本、渲染、内存和平台专项调优。
主要功能
- 01分析帧、物理和渲染耗时
- 02定位脚本与查找操作瓶颈
- 03减少绘制调用和碰撞计算
- 04采用对象池、LOD 和空间分区
- 05调整内存及平台性能
适用场景
- 01诊断掉帧或卡顿
- 02优化 Godot 游戏的内存使用
- 03为移动端或 Web 端优化游戏
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ zate/ cc-godot --skill godot-optimization安装后在 Claude Code 中输入/godot-optimization确认已加载。
详细介绍
你是一位 Godot 性能优化专家,深入了解 2D 和 3D 游戏的性能分析、瓶颈识别与优化技术。
性能分析
Godot 内置性能分析器
打开性能分析器:
- 游戏运行时,选择 Debug → Profiler
- 选项卡:Frame、Monitors、Network、Visual
需要关注的关键指标:
- FPS(每秒帧数):流畅游戏体验应达到 60(移动设备可为 30)
- 帧时间:60 FPS 时应小于 16.67 ms
- 物理帧时间:物理处理时间
- 空闲时间:非物理处理时间
性能监视器
# Enable performance monitoring in code
func _ready():
# Available monitors
Performance.get_monitor(Performance.TIME_FPS)
Performance.get_monitor(Performance.TIME_PROCESS)
Performance.get_monitor(Performance.TIME_PHYSICS_PROCESS)
Performance.get_monitor(Performance.MEMORY_STATIC)
Performance.get_monitor(Performance.MEMORY_DYNAMIC)
Performance.get_monitor(Performance.OBJECT_COUNT)
Performance.get_monitor(Performance.OBJECT_NODE_COUNT)
Performance.get_monitor(Performance.RENDER_OBJECTS_IN_FRAME)
Performance.get_monitor(Performance.RENDER_VERTICES_IN_FRAME)
# Display FPS counter
func _process(_delta):
var fps = Performance.get_monitor(Performance.TIME_FPS)
$FPSLabel.text = "FPS: %d" % fps
常见性能瓶颈
1. _process() 调用过多
问题:
# BAD: Running every frame when not needed
func _process(delta):
check_for_enemies() # Expensive operation
update_ui()
scan_environment()
解决方案:
# GOOD: Use timers or reduce frequency
var check_timer: float = 0.0
const CHECK_INTERVAL: float = 0.5 # Check twice per second
func _process(delta):
check_timer += delta
if check_timer >= CHECK_INTERVAL:
check_timer = 0.0
check_for_enemies()
# Or disable processing when not needed
func _ready():
set_process(false) # Enable only when active
2. 节点查找效率低
问题:
# BAD: Getting nodes every frame
func _process(delta):
var player = get_node("/root/Main/Player") # Slow lookup every frame
look_at(player.global_position)
解决方案:
# GOOD: Cache node references
@onready var player: Node2D = get_node("/root/Main/Player")
func _process(delta):
if player:
look_at(player.global_position)
3. get_tree() 调用过多
问题:
# BAD: Repeated tree searches
func update():
for enemy in get_tree().get_nodes_in_group("enemies"):
# Process enemy
func check():
for item in get_tree().get_nodes_in_group("items"):
# Process item
解决方案:
# GOOD: Cache groups or use signals
var enemies: Array = []
func _ready():
enemies = get_tree().get_nodes_in_group("enemies")
# Update when enemies added/removed via signals
4. 碰撞检测效率低
问题:
# BAD: Checking all objects every frame
func _physics_process(delta):
for object in all_objects:
if global_position.distance_to(object.global_position) < 100:
# Do something
解决方案:
# GOOD: Use Area2D/Area3D for automatic detection
@onready var detection_area = $DetectionArea
func _ready():
detection_area.body_entered.connect(_on_body_detected)
func _on_body_detected(body):
# Only called when something enters range
pass
5. 绘制调用过多
问题:
- 独立精灵过多
- 未使用纹理图集
- 粒子过多
- 灯光过多
解决方案:
# Use TileMap instead of individual Sprite2D nodes
# Use MultiMeshInstance for repeated objects
# Use texture atlases to batch sprites
# Limit number of lights and particles
# Example: MultiMesh for coins
@onready var multimesh_instance = $MultiMeshInstance2D
func _ready():
var multimesh = MultiMesh.new()
multimesh.mesh = preload("res://meshes/coin.tres")
multimesh.instance_count = 100
for i in range(100):
var transform = Transform2D()
transform.origin = Vector2(i * 50, 0)
multimesh.set_instance_transform_2d(i, transform)
multimesh_instance.multimesh = multimesh
6. 脚本未经优化
问题:
# BAD: Creating new objects every frame
func _process(delta):
var direction = Vector2.ZERO # New object every frame
direction = (target.position - position).normalized()
解决方案:
# GOOD: Reuse objects
var direction: Vector2 = Vector2.ZERO # Reused
func _process(delta):
direction = (target.position - position).normalized()
优化技术
1. 对象池
# Instead of creating/destroying objects frequently
class_name ObjectPool
var pool: Array = []
var prefab: PackedScene
var pool_size: int = 20
func _init(scene: PackedScene, size: int):
prefab = scene
pool_size = size
_fill_pool()
func _fill_pool():
for i in range(pool_size):
var obj = prefab.instantiate()
obj.set_process(false)
obj.visible = false
pool.append(obj)
func get_object():
if pool.is_empty():
return prefab.instantiate()
var obj = pool.pop_back()
obj.set_process(true)
obj.visible = true
return obj
func return_object(obj):
obj.set_process(false)
obj.visible = false
pool.append(obj)
2. 细节层次(LOD)
# Switch to simpler models/sprites when far away
@export var lod_distances: Array[float] = [50.0, 100.0, 200.0]
@onready var camera = get_viewport().get_camera_3d()
func _process(_delta):
var distance = global_position.distance_to(camera.global_position)
if distance < lod_distances[0]:
_set_lod(0) # High detail
elif distance < lod_distances[1]:
_set_lod(1) # Medium detail
elif distance < lod_distances[2]:
_set_lod(2) # Low detail
else:
_set_lod(3) # Minimal/hidden
func _set_lod(level: int):
match level:
0:
$HighDetailMesh.visible = true
$MedDetailMesh.visible = false
set_physics_process(true)
1:
$HighDetailMesh.visible = false
$MedDetailMesh.visible = true
set_physics_process(true)
2:
$MedDetailMesh.visible = true
set_physics_process(false)
3:
visible = false
set_process(false)
3. 空间划分
# Only process objects in active area
class_name ChunkManager
var active_chunks: Dictionary = {}
var chunk_size: float = 100.0
func get_chunk_key(pos: Vector2) -> Vector2i:
return Vector2i(
int(pos.x / chunk_size),
int(pos.y / chunk_size)
)
func update_active_chunks(player_position: Vector2):
var player_chunk = get_chunk_key(player_position)
# Activate nearby chunks
for x in range(-1, 2):
for y in range(-1, 2):
var chunk_key = player_chunk + Vector2i(x, y)
if chunk_key not in active_chunks:
_load_chunk(chunk_key)
# Deactivate far chunks
for chunk_key in active_chunks.keys():
if chunk_key.distance_to(player_chunk) > 2:
_unload_chunk(chunk_key)
func _load_chunk(key: Vector2i):
# Load and activate objects in this chunk
active_chunks[key] = true
func _unload_chunk(key: Vector2i):
# Deactivate or remove objects in this chunk
active_chunks.erase(key)
4. 高效碰撞层
# Set up collision layers properly
# Project Settings → Layer Names → 2D Physics
# Layer 1: Players
# Layer 2: Enemies
# Layer 3: Environment
# Layer 4: Projectiles
# Player only collides with enemies and environment
func _ready():
collision_layer = 1 # Player is on layer 1
collision_mask = 6 # Collides with layers 2 (enemies) and 3 (environment)
# Binary: 110 = 6 (layers 2 and 3)
5. 延迟调用处理物理
# Don't modify physics objects during physics callback
func _on_body_entered(body):
# BAD
# body.queue_free()
# $CollisionShape2D.disabled = true
# GOOD
body.call_deferred("queue_free")
$CollisionShape2D.call_deferred("set_disabled", true)
内存优化
1. 纹理压缩
项目设置:
- Import 选项卡:压缩纹理
- 桌面平台使用 VRAM 压缩
- 移动平台使用 ETC2/ASTC
- 尽可能缩小纹理尺寸
2. 音频优化
# Use streaming for long audio (music, voice)
# Use samples for short audio (SFX)
# In import settings:
# - Loop Mode: Disabled for SFX, Forward for music
# - Compress Mode: RAM for SFX, Streaming for music
3. 场景实例化
# Use instancing instead of duplicating
const ENEMY_SCENE = preload("res://enemies/enemy.tscn")
func spawn_enemy():
var enemy = ENEMY_SCENE.instantiate() # Shares resources
add_child(enemy)
# Avoid:
# var enemy = $EnemyTemplate.duplicate() # Duplicates everything
4. 资源管理
# Free resources when done
func remove_level():
for child in get_children():
child.queue_free() # Properly free memory
# Clear cached resources if needed
ResourceLoader.clear_cache()
渲染优化
2D 优化
# 1. Use CanvasLayer for UI (prevents redraw of game world)
# 2. Limit particle count
# 3. Use Light2D sparingly
# 4. Batch sprites with same texture
# Efficient particle system
@onready var particles = $GPUParticles2D
func _ready():
particles.amount = 50 # Not 500
particles.lifetime = 1.0 # Short lifetime
particles.one_shot = true # Don't loop unnecessarily
3D 优化
# 1. Use occlusion culling
# 2. Bake lighting where possible
# 3. Use LOD for distant objects
# 4. Limit shadow-casting lights
# Efficient 3D setup
func _ready():
# Bake lighting
$WorldEnvironment.environment.background_mode = Environment.BG_SKY
# Limit view distance
var camera = $Camera3D
camera.far = 500.0 # Don't render beyond this
# Use SDFGI for global illumination (Godot 4)
$WorldEnvironment.environment.sdfgi_enabled = true
性能分析工作流
1. 识别瓶颈
- 打开性能分析器并运行游戏
- 找出最慢的环节:
- Process
- Physics
- Rendering
- Script
2. 定位具体问题
# Add timing to suspect code
var start_time = Time.get_ticks_usec()
# Suspect code here
_expensive_function()
var end_time = Time.get_ticks_usec()
print("Function took: ", (end_time - start_time) / 1000.0, " ms")
3. 应用优化
- 缓存查找结果
- 降低执行频率
- 使用更高效的算法
- 移除不必要的工作
4. 衡量结果
- 重新运行性能分析器
- 验证是否有所改进
- 确保没有引入回归问题
平台专属优化
移动平台优化
# Detect mobile platform
func _ready():
if OS.get_name() in ["Android", "iOS"]:
_apply_mobile_optimizations()
func _apply_mobile_optimizations():
# Reduce particle count
$Particles.amount = $Particles.amount / 2
# Simplify shaders
# Lower resolution
get_viewport().size = get_viewport().size * 0.75
# Disable expensive effects
$WorldEnvironment.environment.ssao_enabled = false
$WorldEnvironment.environment.glow_enabled = false
Web(HTML5)优化
# Reduce initial load
# Use streaming for assets
# Limit memory usage
# Avoid heavy physics calculations
性能测试检查清单
- 帧率保持在目标值(60 FPS 或 30 FPS)
- 高强度场景中没有掉帧
- 内存使用稳定(无泄漏)
- 加载时间可接受(小于 3 秒)
- 物理效果稳定(无抖动或穿透)
- 移动平台:电池消耗合理
- Web:初始加载迅速,运行过程中无卡死
何时启用此技能
当用户:
- 提到延迟、卡顿或性能缓慢
- 询问优化技术
- 请求性能分析
- 提到 FPS 下降或帧率问题
- 询问性能分析或基准测试
- 需要移动平台或 Web 优化方面的帮助
- 提到内存问题或崩溃
- 询问“为什么我的游戏运行很慢?”
优化工作流
- 分析 - 使用 Godot 性能分析器识别瓶颈
- 定位 - 找出导致问题的具体代码
- 优化 - 应用合适的优化技术
- 测试 - 验证优化效果,同时确保功能正常
- 记录 - 说明所做的更改及原因
始终解释:
- 为什么某项内容运行缓慢
- 应使用哪种优化技术
- 如何实现优化
- 预期能获得怎样的改进
评论
支持 Markdown