Un petit script, un effet démesuré
Les barres de progression apparaissent partout dans FiveM — crochetage, réparation, blanchiment d'argent, minage, soins médicaux. Les implémentations par défaut sont fonctionnelles mais plates. Agency-ProgressBar, c'est notre vision de ce à quoi cet utilitaire devrait ressembler quand quelqu'un se soucie des détails.
L'anatomie d'une bonne barre de progression
Une bonne barre de progression communique quatre choses en même temps : quelle action est en cours, à quel point tu es avancé, combien de temps il reste et si tu peux annuler. La plupart des implémentations ne gèrent que les deux premières. Agency-ProgressBar affiche les quatre, avec des animations subtiles qui rendent la progression fluide au lieu de saccadée.
Une annulation qui fonctionne
Une annulation déclenchée par le joueur lance une brève animation de fondu qui ramène l'opacité de la barre à zéro en 300ms. Pas de disparition brutale. Les développeurs peuvent enregistrer un callback d'annulation pour que les scripts se nettoient proprement quand les joueurs s'éloignent d'une action en cours.
Positionnement contextuel
La barre apparaît près de l'élément pertinent à l'écran — au-dessus de ta tête pour les actions sur toi-même, au-dessus du PNJ ciblé pour les actions interactives. Plus besoin de lire le statut de l'action en bas de l'écran alors que quelque chose se passe en haut. Ce positionnement contextuel est une amélioration UX subtile que les joueurs ressentent sans savoir la nommer.
Le pattern d'exports
Comme tous nos scripts utilitaires, Agency-ProgressBar expose une API exports simple : exports['agency-progressbar']:Play({label, duration, canCancel, onCancel, onDone}). Intégré dans n'importe quel script en quelques minutes. Il se combine avec Agency-Notify, Agency-Hud et le reste de notre écosystème sans aucune configuration spéciale.