Retour aux projets

Plugin Unity · Overlay de performance

Bottleneck HUD

Cet overlay montre pourquoi une frame est lente : temps de frame réel CPU et GPU, 1 % low, mémoire et ping. FPS et ping reçoivent tout de suite un verdict en mot et en couleur, les graphiques montrent quand ça s’est dégradé, et les alertes pourquoi. Ni prefab ni composant — importez le paquet et lancez votre scène en mode Play

Ce qu’il affiche

  • FPS noté smooth, unstable ou low À côté : 1% low et min — les pires frames des 5 dernières secondes
  • Temps de frame CPU et GPU en millisecondes Travail seulement : l’attente vsync et la limite de frames ne comptent pas. CPU est le plus chargé entre le thread principal et le thread de rendu
  • Mémoire : Mem, GC et GFX Tout ce qu’Unity a alloué, le heap managé utilisé et l’estimation du pilote graphique
  • Ping noté good, fair ou poor Sur un client — son propre ping vers le serveur ; sur l’hôte — le pire client, marqué max
  • Des graphiques sous les chiffres Temps de frame face au budget avec les courbes CPU et GPU, GC et mémoire sur une fenêtre plus longue pour repérer une fuite, ping avec ses limites good et fair
  • Des alertes avec leur cause FPS bas, hitch, croissance du GC et ping élevé — une ligne à l’écran, un avertissement dans la console, une capture et l’événement Overlay.Alert. Un hitch nomme sa cause : scene load, GC collection, allocations ou unknown. L’alerte de hitch est désactivée par défaut — activez Hitch (Long Frame) dans Threshold Settings → Warnings
  • Rapport et enregistrement de session Shift+F11 — un rapport avec les chiffres actuels, un résumé des 30 dernières secondes et l’appareil. Ctrl+F11 — chaque frame en CSV avec vos repères

Limites

  • En build de release — pas de métriques de debug Temps CPU et GPU, mémoire, 1 % low, statistiques de rendu, causes des hitchs, alerte de croissance du GC, captures des alertes et enregistrement de session n’existent que dans l’éditeur et en Development Build. En release restent FPS, ping, leurs graphiques, les alertes de FPS bas, de hitch et de ping élevé et le rapport
  • La mémoire dans l’éditeur inclut l’éditeur lui-même Comparez les chiffres entre Development Builds, pas avec l’éditeur
  • GPU n/a sur certaines plateformes Certaines plateformes et API graphiques ne reportent pas le temps GPU

Comment utiliser le plugin

De l’import au build de release : réglages, raccourcis, rapport, votre menu, vos propres chiffres et multijoueur

Démarrage rapide

Importez le package et appuyez sur Play — l’overlay apparaît en bas à gauche. Il démarre tout seul et survit aux chargements de scènes

Si TextMesh Pro n’était pas encore dans le projet, Window → Bottleneck HUD propose d’importer TMP Essential Resources en un clic

  • OuiImporter le package et appuyer sur Play
  • NonChercher un prefab ou un composant — il n’y en a pas

Réglages

Six groupes : General, Position and Style, Displayed Data, Controls, Report and Recording, Threshold Settings. Reset to Defaults remet tout comme avant. Les réglages sont dans Assets/Resources, hors du dossier du paquet, donc une mise à jour ne les écrase pas

Window → Bottleneck HUD
  • OuiRégler coin et seuils directement en Play Mode
  • NonDéplacer l’asset de réglages dans le dossier du package

Raccourcis

F11 affiche et masque l’overlay, Shift+F11 copie le rapport, Ctrl+F11 lance un enregistrement. Tout chemin Input System convient, par ex. <Keyboard>/backquote, ou un accord de manette <Gamepad>/leftStickPress+<Gamepad>/rightStickPress

Sur téléphone, gardez un doigt immobile 2 secondes dans le coin de l’overlay. Un champ vide désactive la touche. Avec l’ancien Input Manager, Controls affiche les mêmes libellés avec des champs KeyCode

  • Oui<Keyboard>/backquotedans les builds Mac
  • NonF12 et Shift+Tab (pris par Steam), F11 sur macOS

Rapport et enregistrement

Le rapport va dans le presse-papiers et toujours dans un fichier — en texte ou en Markdown pour GitHub, Jira et Notion. L’enregistrement de session écrit chaque frame en CSV, et Overlay.Mark("boss") pose un repère dedans et sur les graphiques. Tout va dans le dossier Logs ; le plugin supprime ses anciens fichiers au lancement du jeu

persistentDataPath/Logs/
  report_<date>_<time>_<frame>.txt
  session_<date>_<time>.csv
  • OuiJoindre le rapport au ticket de bug au lieu d’une capture
  • NonAttendre l’enregistrement de session en build de release — Development Build seulement

Votre propre menu de réglages

La visibilité est stockée dans PlayerPrefs, facile à relier à un interrupteur du menu du jeu. Overlay.Toggle() bascule l’overlay en une ligne, et TargetFrameRateSource fixe la cible FPS depuis vos réglages graphiques. Avec Show HUD at Launch désactivé, l’overlay mesure mais reste caché jusqu’à ce qu’on l’affiche

showStatsToggle.isOn = Overlay.Visible;
showStatsToggle.onValueChanged
  .AddListener(on => Overlay.Visible = on);

// rate FPS against your graphics-menu cap
Overlay.TargetFrameRateSource =
  () => myGraphicsSettings.FrameCap;

Vos lignes et graphiques

Ajoutez les chiffres de votre jeu en une ligne — ils se placent à côté de ceux de l’overlay et entrent dans le rapport. Les alertes peuvent partir vers votre propre analytics

Overlay.AddSection("Enemies",
  () => enemies.Count.ToString());
Overlay.AddGraph("Pool",
  () => pool.CountActive);

Overlay.Alert += alert =>
  Analytics.Send("perf_" + alert.Kind);

Multijoueur

Avec Netcode for GameObjects, le ping fonctionne d’emblée — rien à configurer. Pour un autre transport, implémentez une méthode IPingSource et assignez la source. Read() tourne deux fois par seconde sur le thread principal

Overlay.PingSource = new MyPingSource();
  • OuiGarder Read() rapide — pas de travail lourd
  • NonAttendre du ping sans NGO et sans votre propre IPingSource

Scène démo

Curseurs de charge CPU et GPU, boutons GC spike, Alloc spike, Hitch et Leak — chacun déclenche sa propre alerte ; les boutons de hitch activent l’alerte de hitch pour la session. Enregistrement, repère et rapport, limites 30/60/120 frames et réglages de l’overlay via la même API qu’en jeu

Le dossier Demo peut être supprimé

BottleneckHUD/Demo/Bottleneck HUD Demo.unity

Documentation complète dans le package : Documentation/Bottleneck HUD Documentation.md

Tous les seuils se changent dans les Réglages

FPS

Cible et note

  • ≥ 90 % de la ciblesmooth
  • ≥ 50 % de la cibleunstable
  • sous 50 %low

Ping

Latence et note

  • < 100 msgood
  • < 200 msfair
  • ≥ 200 mspoor

Hitch

Une frame longue · désactivé par défaut

  • frame de plus de 100 mshitch
  • plus de 1024 Ko alloués dedansallocations

Questions fréquentes

L’overlay n’est pas visible

TMP Essential Resources manquent — la console avertit [Bottleneck HUD] No font…. Cliquez Import TMP Essential Resources dans les réglages ou assignez une Font. Vérifiez aussi Enable Plugin / Show HUD at Launch et si vous avez masqué l’overlay avec le raccourci

GPU plus élevé que 1000 / FPS sur Apple Silicon

C’est normal. Sous Metal le GPU traite les frames voisines en parallèle, donc le temps GPU d’une frame peut dépasser l’intervalle entre frames — p. ex. 29 ms à 99 FPS. Quel côté est plus chargé reste correct, mais ne le comparez pas au budget de frame sur Apple

GPU affiche n/a

La plateforme ne reporte pas le temps GPU. Sur ces plateformes, Frame Timing Stats dans Player Settings peut aider

Dans l’éditeur le FPS est low alors que le jeu se sent bien

L’éditeur n’a souvent pas de limite de frames, et la cible est le taux de rafraîchissement de l’écran. Une vue Game en arrière-plan ralentit aussi l’éditeur. Définissez Target FPS dans les réglages ou testez une Development Build

Le raccourci ne fonctionne pas

Vérifiez le chemin dans Show / Hide, groupe Controls. Sur macOS, F11 est pris par le système. Si seul l’ancien Input Manager est actif, réglez-y le KeyCode

L’overlay couvre mon HUD

Changez Position ou Edge Margin, ou baissez Priority Over Game UI

En multijoueur le ping est toujours offline

Sans Netcode for GameObjects assignez votre propre IPingSource — voir l’étape 07 ci-dessus

Où sont les rapports, enregistrements et captures

Dans le dossier Logs de persistentDataPath — Open Folder, dans le groupe Report and Recording, l’ouvre. Le plugin supprime ses anciens fichiers au lancement du jeu : après une semaine par défaut, délai réglé dans Delete Reports

Que signifie ! hitch 164 ms — allocations 2.0 MB

Une frame a duré 164 ms — environ dix frames normales à 60 FPS — et y a alloué 2,0 Mo de mémoire managée, plus que Cause "Allocations" From, KB (1024 par défaut). C’est la cause probable : trouvez la frame dans le Profiler et triez par GC Alloc. L’alerte de hitch est désactivée par défaut — activez Hitch (Long Frame) dans Threshold Settings → Warnings et réglez la durée de frame dans Hitch: Frame Longer Than, ms

Un hitch avec la cause unknown

Cette frame n’a eu ni chargement de scène, ni ramasse-miettes, ni grosses allocations — regardez les courbes CPU et GPU du graphique des frames. Entourez votre propre chargement de Overlay.BeginLoading() / EndLoading(), et un hitch à l’intérieur indiquera scene load

Support

Pour les questions et les bugs help@makstorch.com
Indiquez la version du plugin, Unity, l’OS et joignez des captures