Performance (4.7)
Zuerst messen. Niemals blind optimieren. Ein Budget von 16,6 ms pro Frame (60 FPS) oder 8,3 ms (120 FPS) deckt Skript, Physik, Rendering auf CPU und GPU ab.
Werkzeuge
- Editor-Debugger: Profiler (Skriptfunktionen; starten, abspielen, dann nach Eigenzeit sortieren), Visual Profiler (CPU vs. GPU pro Renderdurchlauf), Monitore (FPS, Prozess-/Physikzeit, Objekte, Nodes, Orphan-Nodes, Draw Calls, Videospeicher), Netzwerk-Profiler und ObjectDB-Snapshots (4.6+: zwei Snapshots diffs, um Lecks zu finden).
- Code:
Performance.get_monitor(Performance.TIME_PROCESS),RENDER_TOTAL_DRAW_CALLS_IN_FRAME,OBJECT_NODE_COUNT,OBJECT_ORPHAN_NODE_COUNT. Eigene hinzufügen mitPerformance.add_custom_monitor(&"game/enemies", callable). - Native Profiler (4.6+): Tracy, Perfetto (Android-Standard) und Apple Instruments können GDScript-, C#- und GDExtension-Frames sehen. Verwende sie für Frame-Zeit-Spitzen.
- CLI:
--profiling,--gpu-profile,--print-fps,--benchmark. Verwende--fixed-fps 60 --quit-after Nfür wiederholbare Läufe. - Lecks: Orphan-Nodes sind Nodes, die aus dem Baum entfernt, aber nie freigegeben wurden.
Node.print_orphan_nodes(),get_orphan_node_ids()(4.5+).
CPU: Weniger Arbeit machen
- Nicht benötigte Verarbeitung deaktivieren:
set_process(false)/set_physics_process(false)im Leerlauf.VisibleOnScreenEnabler2D/3Dpausiert außerschirmige Akteure. Timer sind besser als Pro-Frame-Abfragen. - Code pro Frame ist der Hotpath. Nodes in
@onready/_Readycachen.StringName-Literale (&"jump") für Aktionen, Gruppen und Methodennamen verwenden. Nicht jeden Frameget_tree().get_nodes_in_group()aufrufen. Typisiertes GDScript verwenden (typisierte Opcodes sind schneller). - Signale und
call_groupsind billig für Ereignisse, aber sie nicht pro Entität pro Frame für tausende Entitäten senden. - Tausende von Dingen: Nicht einen Node pro Ding verwenden.
- Visuelles:
MultiMeshInstance3D/2D(ein Draw Call;multimesh.bufferin Bulk schreiben) oder GPU-Partikel. - Logik: Einfache Arrays und Structs in einem Manager-Skript (datenorientiert), nicht ein Skript pro Entität.
- Physik:
PhysicsServer2D/3D-Bodies und Areas ohne Nodes, oder ein Raycast-Batch pro Frame. - Rendering ohne Nodes:
RenderingServer-Instanzen und Canvas-Items.
- Visuelles:
- Physik:
physics_ticks_per_secondbei 60 belassen, es sei denn, das Spiel braucht mehr. Einfache Primitive-Formen verwenden undConcavePolygonShape3Dbei bewegten Bodies vermeiden. Layer und Masken reduzieren Paarprüfungen. Bodies schlafen lassen (can_sleep).
Threads
WorkerThreadPool.add_task(callable)/add_group_task(callable, count)(Parallel-für), dannwait_for_task_completion(id). Das ist besser als roheThreadfür die meisten Jobs.- Szenenbaum-Regel: Nodes innerhalb des Baums dürfen nur vom Haupt-Thread berührt werden, es sei denn, sie befinden sich in einer Thread-Gruppe (
process_thread_group = PROCESS_THREAD_GROUP_SUB_THREAD, die diesen Teilbaum parallel verarbeitet undcall_deferred_thread_groupfür gruppenübergreifende Aufrufe verwendet). Von Arbeits-Threads aus Ergebnisse mitcall_deferred/Callable.call_deferred()zurückgeben. Überprüfung mitThread.is_main_thread()(4.7). - Gemeinsame Daten: mit
Mutexschützen oder jedem Arbeiter sein eigenes Slice geben und im Haupt-Thread zusammenführen. - Hintergrundladen:
ResourceLoader.load_threaded_request(path, "", true)verwendet Sub-Threads für Abhängigkeiten.
GPU und Rendering
- Draw Calls: Statische Meshes zusammenführen und Materialien teilen, da jedes eindeutige Material auf einer Mesh-Oberfläche Aufrufe hinzufügt. MultiMesh für Wiederholungen und Textur-Atlanten in 2D verwenden.
- Lichter und Schatten sind die üblichen GPU-Fresser. Wenige beschattete Omni- und Spot-Lichter verwenden,
directional_shadow_max_distanceklein halten und statische Beleuchtung baken (LightmapGI). - Überzeichnung: Große transparente Partikel und Vollbild-Alpha. Alpha-Scissor oder Hash für Laub und kleinere Partikel-Quadrate verwenden.
- Detailstaffelung: LOD (
mesh_lod_threshold),visibility_range_*, Occlusion Culling und Auflösungsskalierung (FSR, MetalFX) auf schwachen GPUs. Den richtigen Renderer wählen: Mobile oder Compatibility für schwache Hardware (siehegodot-3d-rendering). - Shader-Ruckler: Shader-Baker (Export-Option), weniger Materialvarianten.
Laden und Speicher
preloadlädt beim Skript-Laden und blockiert. Nur für kleine Dinge verwenden, die man immer braucht.loadist faul. Thread-gesteuertes Laden eignet sich für Level.ResourceLoadercached Ressourcen. Wiederverwenden undduplicate()von gemeinsam genutzten Ressourcen vermeiden, es sei denn, du benötigst pro-Instanz-Zustand.- Texturen: VRAM-komprimiert importieren (Standard für 3D; für große 2D aktivieren). Mipmaps für 3D. Maximale Größe pro Plattform begrenzen. Audio: Ogg-Streams für lange Tracks.
- Freigeben, was du spawnst:
queue_free()und Pools für Kugeln. Beobachte, dass die Orphan-Zahl flach bleibt.
GDScript vs. C#
- GDScript ist gut für Gameplay. Enge Mathe-Schleifen (Pfadfindung, Procgen, Simulationen) nach C# oder GDExtension verschieben und trotzdem API-Aufrufe bündeln.
- C#: Pro-Frame-Allokationen vermeiden (LINQ, Closures, String-Formatierung,
new Godot.Collections.Array). Jeder Godot-API-Aufruf überquert eine Interop-Grenze, also bündeln. Gepackte Arrays kopieren beim Überqueren dieser Grenze.
Plattform-Budgets (Faustregel)
Mobilgeräte: < 100–150 Draw Calls, 1 beschattetes Licht, Mobile oder Compatibility-Renderer, 30–60 FPS-Ziel. Web: Compatibility-Renderer, single-threaded, es sei denn, der Export verwendet Threads (benötigt Cross-Origin-Isolation-Header), und Downloads klein halten. Desktop oder Konsole: Forward+, auf der Minimum-Spec-Hardware profilieren.
Perf HUD + benutzerdefinierte Monitore, MultiMesh-Menge, parallele Gruppenaufgabe, serverseitige Kugeln (von den Tests kompiliert): references/patterns.md