Un script pequeño, un efecto enorme
Las barras de progreso aparecen por todas partes en FiveM — ganzúas, reparaciones, blanqueo de dinero, minería, asistencia médica. Las implementaciones por defecto son funcionales, pero planas. Agency-ProgressBar es nuestra visión de cómo debería sentirse esta utilidad cuando a alguien le importan los detalles.
La anatomía de una buena barra de progreso
Una buena barra de progreso comunica cuatro cosas a la vez: qué acción está ocurriendo, cuánto has avanzado, cuánto tiempo queda y si puedes cancelar. La mayoría de implementaciones solo cubren las dos primeras. Agency-ProgressBar muestra las cuatro, con animaciones sutiles que hacen que el progreso se sienta fluido en lugar de a saltos.
Cancelación que funciona
La cancelación iniciada por el jugador dispara una breve animación de fade-out que devuelve la opacidad de la barra a cero en 300ms. Sin desaparición brusca. Los desarrolladores pueden registrar un callback de cancelación para que los scripts se limpien correctamente cuando los jugadores abandonan una acción a medias.
Posicionamiento contextual
La barra aparece cerca del elemento relevante en pantalla — sobre tu cabeza para acciones dirigidas a ti mismo, sobre el NPC objetivo para acciones interactivas. Se acabó leer el estado de la acción en la parte inferior de la pantalla mientras algo ocurre arriba. Este posicionamiento contextual es una mejora de UX sutil que los jugadores sienten sin poder nombrarla.
El patrón de exports
Como todos nuestros scripts de utilidad, Agency-ProgressBar expone una API de exports simple: exports['agency-progressbar']:Play({label, duration, canCancel, onCancel, onDone}). Lo integras en cualquier script en minutos. Se combina con Agency-Notify, Agency-Hud y el resto de nuestro ecosistema sin ninguna configuración especial.