Bottleneck HUD
🛠️ Pour les développeursUnity 6.0+, uGUI + TextMeshPro, n’importe quel pipeline de rendu. Optionnel : Input System et Netcode for GameObjects
Terminal
Plugin Unity · Overlay de performance
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
Bottleneck HUD
🛠️ Pour les développeursUnity 6.0+, uGUI + TextMeshPro, n’importe quel pipeline de rendu. Optionnel : Input System et Netcode for GameObjects
De l’import au build de release : réglages, raccourcis, rapport, votre menu, vos propres chiffres et multijoueur
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
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
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
<Keyboard>/backquotedans les builds MacLe 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
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;
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);
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();
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
FPS
Cible et note
Ping
Latence et note
Hitch
Une frame longue · désactivé par défaut
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
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
n/aLa plateforme ne reporte pas le temps GPU. Sur ces plateformes, Frame Timing Stats dans Player Settings peut aider
low alors que le jeu se sent bienL’é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
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
Changez Position ou Edge Margin, ou baissez Priority Over Game UI
offlineSans Netcode for GameObjects assignez votre propre IPingSource — voir l’étape 07 ci-dessus
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
! hitch 164 ms — allocations 2.0 MBUne 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
unknownCette 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
Pour les questions et les bugs
help@makstorch.com
Indiquez la version du plugin, Unity, l’OS et joignez des captures