TJ Utils es una interfaz cliente independiente de TJ Scripts. La versión 1.0.0 ofrece notificaciones, barra de progreso y TextUI mediante exports y eventos clientes. Instalarla no sustituye automáticamente las notificaciones del framework ni añade interacciones de juego; otros scripts deben llamar a su API.
Instalación del recurso y API
Extrae el repositorio en tj_utils con fxmanifest.lua, client y web en la raíz. Conserva web/sounds/notification.mp3 con los archivos de interfaz. Añade ensure tj_utils antes de los scripts que llaman a sus exports. El manifiesto no declara dependencia de ESX, QBCore ni ox_lib; el HTML carga hojas de estilo externas de Font Awesome y Cascadia Code.
Los exports clientes son ShowNotification, ShowProgress, HideProgress, ShowTextUI y HideTextUI. ShowNotification acepta una tabla con type, title, description, duration y position; los tipos documentados son info, success, error y warning. Los scripts del servidor envían los eventos clientes correspondientes, como tj_utils:notify, al jugador elegido en vez de llamar a un export servidor.
El final del progreso es solo un temporizador
ShowProgress acepta una cadena o tabla de opciones y un callback opcional. Los valores Lua por defecto son 5000 milisegundos y posición bottom. Tras ese tiempo, el callback recibe true. HideProgress solo oculta la interfaz: no cancela el temporizador Lua ni comunica una cancelación. No concedas objetos o pagos únicamente porque se ejecute ese callback.
La interfaz tiene un único contenedor de progreso. Una barra nueva sustituye el temporizador visual mientras los callbacks Lua anteriores pueden seguir activos. Coordina los scripts que la llaman y prueba solapamientos, ocultación anticipada y paradas del recurso. Valida las duraciones antes de pasarlas a la biblioteca.
Textos, notificaciones y pruebas de integración
ShowTextUI acepta una cadena o tabla y permanece visible hasta HideTextUI. Mostrar un aviso no vincula la tecla anunciada a una acción. Las notificaciones comparten contenedor, por lo que una posición nueva puede mover mensajes existentes. Prueba las posiciones y acumulaciones que utilices.
El título y la descripción de las notificaciones se insertan por innerHTML sin escape; los textos de progreso y TextUI usan textContent. Usa marcado fiable o escapa texto no fiable antes de enviarlo. Los comandos de demostración son /info, /success, /error, /warning, /progress, /textui y /hidetextui; comprueba posibles conflictos.
Vista previa existente del creador
Fuente revisada el 10 de septiembre de 2026 en la revisión 23b4796896d01a73a61c570d44a6a564d88ad78a. Se inspeccionaron el manifiesto, todo el Lua cliente y el JavaScript del navegador. No se realizaron pruebas FiveM, benchmarks ni integración de frameworks.