Text UI reemplaza el DrawText3D blanco simple y los avisos por defecto del framework por avisos de interacción limpios y animados para tu servidor FiveM. Cada aviso es una insignia de tecla y una línea de texto, fijada al borde de la pantalla o flotando en el mundo sobre una puerta, el mostrador de una tienda, un NPC u otro jugador. Cuando varios avisos comparten un sitio se convierten en una lista, y el jugador elige uno con las flechas.
Está pensado para integrarse en un servidor que ya existe. El ESX.TextUI de ESX y el DrawText de QBCore apuntan a él con unas pocas líneas, los scripts antiguos que dibujan DrawText3D en cada frame siguen funcionando mediante un pequeño wrapper, y los códigos de color de GTA como ~g~ se muestran como colores reales. No hay ninguna base de datos ni SQL que importar, ni nada más que instalar.
Por dónde empezar#
Página | Qué cubre |
|---|---|
Requisitos, descarga, orden de carga, el archivo de config y cómo comprobar que funciona. | |
Convertir cada llamada a DrawText3D de tus scripts antiguos en avisos de Text UI sin reescribirlos. | |
Los tres tipos de aviso, las distancias, las opciones apiladas, los avisos colocados desde la config, la posición en pantalla, los colores, el formato del texto y el estilo Cyberpunk. | |
ESX TextUI, DrawText de QBCore y Qbox, filtros por trabajo y cómo añadir otro framework. | |
Cada export y evento de cliente, con sus parámetros y un ejemplo. | |
Qué significa cada problema y cómo solucionarlo. |
Qué hace#
Área | Detalles |
|---|---|
Avisos en pantalla | Una insignia de tecla y una línea de texto que entran deslizándose en cualquiera de nueve posiciones de la pantalla. El texto puede cambiar en su sitio sin volver a animarse. |
Texto 3D | Avisos fijados a una coordenada del mundo: un pequeño marcador a distancia, la etiqueta completa cuando el jugador está lo bastante cerca para usarla, y un evento tuyo que se lanza al pulsar la tecla. |
Avisos sobre jugadores | Una etiqueta que sigue a otro jugador, con hasta dos teclas y un evento por tecla: cachear, escoltar, dar. |
Opciones apiladas | Varios avisos en un mismo sitio se convierten en una lista. Las flechas eligen, y la propia tecla de la opción confirma. |
Zonas de la config | Avisos colocados en la config con una función que se ejecuta al pulsar la tecla, mostrados a un trabajo o tras una condición propia. |
Reemplazo de DrawText3D | Los scripts antiguos siguen llamando a DrawText3D. Un wrapper directo pasa las llamadas a Text UI y quita la etiqueta cuando el script deja de dibujarla. |
TextUI del framework | ESX.TextUI, ESX.HideUI y DrawText, HideText y ChangeText de QBCore redirigidos a Text UI, para que todos los scripts del framework compartan un mismo aspecto. |
Estilos | Tus propios colores para el aspecto por defecto, o un estilo de diálogo de Cyberpunk 2077 con placa de interlocutor. |
Formato | Códigos de GTA — |
Rendimiento | Sin nada cerca, comprueba cuatro veces por segundo. La interfaz solo recibe aviso cuando algo en pantalla cambia de verdad, y las etiquetas siguen al mundo sin redibujarse. |
Frameworks | ESX, QBCore y Qbox detectados por sí solos. Los servidores standalone también funcionan. |
¿Lo controlas desde tus propios scripts? Un export muestra un aviso en pantalla; otro fija uno a una coordenada y lanza tu evento cuando se pulsa la tecla. Consulta Comandos y exports.