Performance (4.7)
Mesurez d'abord. N'optimisez jamais à l'aveugle. Un budget de 16,6 ms par trame (60 FPS) ou 8,3 ms (120 FPS) couvre le script, la physique, le rendu sur le CPU et le GPU.
Outils
- Débogueur de l'éditeur : Profileur (fonctions de script ; démarrez-le, jouez, puis triez par temps propre), Profileur visuel (CPU vs GPU par passe de rendu), Moniteurs (FPS, temps de processus/physique, objets, nœuds, nœuds orphelins, appels de dessin, mémoire vidéo), Profileur réseau et instantanés ObjectDB (4.6+ : différenciez deux instantanés pour trouver les fuites).
- Code :
Performance.get_monitor(Performance.TIME_PROCESS),RENDER_TOTAL_DRAW_CALLS_IN_FRAME,OBJECT_NODE_COUNT,OBJECT_ORPHAN_NODE_COUNT. Ajoutez les vôtres avecPerformance.add_custom_monitor(&"game/enemies", callable). - Profileurs natifs (4.6+) : Tracy, Perfetto (Android par défaut) et Apple Instruments peuvent voir les trames GDScript, C# et GDExtension. Utilisez-les pour les pics de temps de trame.
- CLI :
--profiling,--gpu-profile,--print-fps,--benchmark. Utilisez--fixed-fps 60 --quit-after Npour des exécutions reproductibles. - Fuites : les nœuds orphelins sont des nœuds retirés de l'arbre mais jamais libérés.
Node.print_orphan_nodes(),get_orphan_node_ids()(4.5+).
CPU : faire moins de travail
- Désactivez les traitements inutiles :
set_process(false)/set_physics_process(false)quand inactif.VisibleOnScreenEnabler2D/3Dmet en pause les acteurs hors écran. Les minuteries sont meilleures que le sondage par trame. - Le code par trame est le goulot d'étranglement. Mettez en cache les nœuds dans
@onready/_Ready. Utilisez les littérauxStringName(&"jump") pour les actions, groupes et noms de méthodes. N'appelez pasget_tree().get_nodes_in_group()à chaque trame. Utilisez du GDScript typé (les opcodes typés sont plus rapides). - Les signaux et
call_groupsont bon marché pour les événements, mais ne les émettez pas par entité par trame pour des milliers d'entités. - Des milliers de choses : arrêtez d'utiliser un nœud par chose.
- Visuels :
MultiMeshInstance3D/2D(un appel de dessin ; écrivezmultimesh.bufferen masse), ou particules GPU. - Logique : tableaux simples et structures dans un script gestionnaire unique (orienté données), pas un script par entité.
- Physique : corps et zones
PhysicsServer2D/3Dsans nœuds, ou un lot de raycasts par trame. - Rendu sans nœuds : instances
RenderingServeret éléments de canevas.
- Visuels :
- Physique : gardez
physics_ticks_per_secondà 60 sauf si le jeu en a besoin de plus. Utilisez des formes primitives simples et évitezConcavePolygonShape3Dsur les corps en mouvement. Les couches et masques réduisent les vérifications de paires. Laissez les corps dormir (can_sleep).
Threads
WorkerThreadPool.add_task(callable)/add_group_task(callable, count)(parallèle pour), puiswait_for_task_completion(id). C'est mieux queThreadbrut pour la plupart des tâches.- Règle de l'arbre de scène : les nœuds dans l'arbre ne peuvent être touchés que depuis le thread principal, sauf s'ils sont dans un groupe de threads (
process_thread_group = PROCESS_THREAD_GROUP_SUB_THREAD, qui traite ce sous-arbre en parallèle et utilisecall_deferred_thread_grouppour les appels inter-groupes). Depuis les threads de travail, renvoyez les résultats aveccall_deferred/Callable.call_deferred(). Vérifiez avecThread.is_main_thread()(4.7). - Données partagées : protégez-les avec
Mutex, ou donnez à chaque travailleur sa propre tranche et fusionnez sur le thread principal. - Chargement en arrière-plan :
ResourceLoader.load_threaded_request(path, "", true)utilise des sous-threads pour les dépendances.
GPU et rendu
- Appels de dessin : fusionnez les maillages statiques et partagez les matériaux, car chaque matériau unique sur une surface de maillage ajoute des appels. Utilisez MultiMesh pour les répétitions et les atlas de textures en 2D.
- Les lumières et les ombres sont les habituels consommateurs de GPU. Utilisez peu de lumières omnidirectionnelles et projecteurs avec ombres, gardez
directional_shadow_max_distancepetit, et cuisez l'éclairage statique (LightmapGI). - Sur-dessin : grosses particules transparentes et alpha plein écran. Utilisez alpha scissor ou hash pour le feuillage et des quads de particules plus petits.
- Détail adaptatif : LOD (
mesh_lod_threshold),visibility_range_*, occlusion culling, et mise à l'échelle de résolution (FSR, MetalFX) sur les GPU faibles. Choisissez le bon moteur de rendu : Mobile ou Compatibility pour les appareils bas de gamme (voirgodot-3d-rendering). - Saccades de shader : cuiseur de shader (option d'exportation), moins de variantes de matériaux.
Chargement et mémoire
preloadcharge au chargement du script et bloque. Utilisez-le uniquement pour les petites choses dont vous avez toujours besoin.loadest paresseux. Le chargement par threads convient aux niveaux.ResourceLoadermet en cache les ressources. Réutilisez-les, et ne faites pasduplicate()de ressources partagées sauf si vous avez besoin d'un état par instance.- Textures : importation compressée VRAM (par défaut pour la 3D ; activez pour les grandes textures 2D). Mipmaps pour la 3D. Limitez la taille maximale par plateforme. Audio : flux Ogg pour les longues pistes.
- Libérez ce que vous créez :
queue_free()et pools pour les balles. Surveillez que le nombre d'orphelins reste stable.
GDScript vs C#
- GDScript est suffisant pour le gameplay. Déplacez les boucles mathématiques serrées (pathfinding, génération procédurale, simulations) vers C# ou GDExtension, et regroupez les appels API.
- C# : évitez les allocations par trame (LINQ, closures, formatage de chaînes,
new Godot.Collections.Array). Chaque appel API Godot traverse une limite d'interopérabilité, donc regroupez-les. Les tableaux packagés sont copiés lorsqu'ils traversent cette limite.
Budgets par plateforme (règle empirique)
Mobile : < 100–150 appels de dessin, 1 lumière avec ombre, moteur de rendu Mobile ou Compatibility, cible 30–60 FPS. Web : moteur de rendu Compatibility, mono-thread sauf si l'exportation utilise des threads (nécessite des en-têtes cross-origin isolation), et gardez les téléchargements petits. Bureau ou console : Forward+, profilez sur le matériel minimum spécifié.
HUD de performance + moniteurs personnalisés, foule MultiMesh, tâche de groupe parallèle, balles côté serveur (compilées par les tests) : references/patterns.md