mcpField
G
godot-optimization

godot-optimization

github.com/zate开发20719 次安装50 周前更新
代码仓库

关于 godot-optimization

godot-optimization 是面向 Godot 开发者的性能分析与优化技能,适用于 2D 和 3D 游戏。内容涵盖瓶颈诊断,以及脚本、渲染、内存和平台专项调优。

主要功能

  1. 01分析帧、物理和渲染耗时
  2. 02定位脚本与查找操作瓶颈
  3. 03减少绘制调用和碰撞计算
  4. 04采用对象池、LOD 和空间分区
  5. 05调整内存及平台性能

适用场景

  1. 01诊断掉帧或卡顿
  2. 02优化 Godot 游戏的内存使用
  3. 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. 识别瓶颈

  1. 打开性能分析器并运行游戏
  2. 找出最慢的环节:
    • 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 优化方面的帮助
  • 提到内存问题或崩溃
  • 询问“为什么我的游戏运行很慢?”

优化工作流

  1. 分析 - 使用 Godot 性能分析器识别瓶颈
  2. 定位 - 找出导致问题的具体代码
  3. 优化 - 应用合适的优化技术
  4. 测试 - 验证优化效果,同时确保功能正常
  5. 记录 - 说明所做的更改及原因

始终解释:

  • 为什么某项内容运行缓慢
  • 应使用哪种优化技术
  • 如何实现优化
  • 预期能获得怎样的改进

评论

支持 Markdown