Lt Chat
Recurso: lt-chat. Gratis.
Changelog: novedades de cada versión →
Idiomas: inglés (predeterminado), español y francés. Se elige en Config.Locale; con 'auto' sigue el idioma de tu base (qs:locale, ox:locale, esx:locale…).
Requisitos
Ninguno: sin base de datos y sin dependencias. Opcional:
| Función | Compatible con |
|---|---|
| Nombres de personaje, trabajos y admins | qs-core, qbx_core, qb-core, es_extended (se detectan solos) o standalone |
| Registro en Discord de reportes y anónimos | Un webhook en Config.Webhooks |
Instalación
- Copia la carpeta
lt-chatenresources/, sin cambiarle el nombre. - Quita cualquier otro chat: el
chatpor defecto,qs-corechato similares. Para también los scripts que registran/me,/dou/ooc(por ejemploqs-rp), o los comandos se pisarán. - En el
server.cfg, arráncalo pronto, antes de los scripts que añaden sugerencias de comandos:
set resources_useSystemChat false ensure lt-chat add_ace group.admin ltchat.admin allow
Reinicia el servidor y pulsa T en el juego. lt-chat declara provide 'chat', así que los recursos que dependen de chat arrancan con él.
Comandos
| Comando | Quién | Qué hace |
|---|---|---|
T | Todos | Abre el chat (cada jugador puede cambiar la tecla en los ajustes de FiveM) |
/say | Todos | Chat local. El texto sin comando también va aquí |
/me · /do | Todos | Acción del personaje · Entorno o resultado de una acción |
/ooc · /looc | Todos | Fuera de personaje, para todos · para los cercanos |
/try · /dice [caras] | Todos | Éxito o fallo al azar · Tira un dado (6 caras por defecto, de 2 a 100) |
/pm [id] | Todos | Mensaje privado |
/report | Todos | Petición de ayuda al staff |
/twt · /anon · /ad | Todos | Twitter · Mensaje anónimo · Anuncio |
/911 | Todos | Llega a los jugadores de ciertos trabajos. Desactivado por defecto |
/announce | Staff y consola | Anuncio del servidor |
/staff | Staff | Chat de staff |
/clear · /clearall | Todos · Staff | Limpia tu chat · Limpia el chat de todos |
/chatadmin | Staff | Abre el menú de administración |
Los comandos de los canales se renombran en /chatadmin (por ejemplo, /report a /ayuda). /chatadmin, /clear y /clearall se cambian en config.lua.
Quién es staff
El staff puede abrir /chatadmin, leer /report, usar /announce, /staff y /clearall, y ver el autor de los mensajes anónimos.
| Framework | Staff |
|---|---|
| Cualquiera | ACE ltchat.admin |
| qs-core | Permiso admin de qs-core |
| Qbox / QBCore | ACE admin |
| ESX | Grupo admin o superadmin |
| Standalone | ACE command (el que tiene group.admin en un server.cfg por defecto) |
Menú /chatadmin
Pestaña Canales
Una tarjeta por canal, con vista previa en directo de su línea:
- Activado: si está apagado, el comando responde que está desactivado.
- Comando: letras, números y
_. No puede repetir el de otro canal ni el de otro recurso. - Texto y color de la etiqueta: vacío, muestra el comando (como
/me). Colores deConfig.TagPaletteo cualquiera. - Quién lo lee: jugadores cercanos (con distancia) o todos.
- Mostrar como (
/me,/do,/tryy dados): en el chat, sobre la cabeza o ambos.
Pestaña General
- Texto sin comando: a qué canal va, o solo comandos.
- Longitud máxima, tiempo entre mensajes y códigos de color (
^1,^2…). - Color y posición del menú, cuándo se desvanece el chat cerrado, líneas guardadas y hora.
- Nombre en OOC, privados y reportes (de FiveM o del personaje), IDs en OOC y si el staff ve a los autores anónimos.
Guardar se aplica al momento a todos los jugadores; Restablecer vuelve a config.lua. Los ajustes se guardan en el KVP del servidor: sin base de datos, y se conservan al actualizar el recurso.
Configuración
config.lua está comentado por secciones. Sus valores son los iniciales: en cuanto guardas en /chatadmin, mandan los guardados.
| Para cambiar | Dónde |
|---|---|
| Tecla para abrir | Config.OpenKey |
| Canales y sus valores iniciales | Config.Channels |
Trabajos que reciben /911 | jobs del canal emergency |
| Colores de la paleta | Config.TagPalette |
| Sonido de los mensajes | Config.MessageSound |
| Texto sobre la cabeza | Config.Overhead |
| Comandos ocultos en las sugerencias | Config.HiddenCommands |
| Registro en consola y webhooks de Discord | Config.ConsoleLog, Config.Webhooks |
| Límites del menú | Config.Limits |
En servidores standalone no hay trabajos: da el ACE ltchat.job.<nombre>, por ejemplo add_ace group.police ltchat.job.police allow.
Para desarrolladores
Todo lo hecho para el chat por defecto sigue funcionando:
TriggerClientEvent('chat:addMessage', source, { color = { 255, 0, 0 }, args = { 'SYSTEM', 'Hello' } })
TriggerClientEvent('chat:addSuggestion', source, '/mycommand', 'Help', { { name = 'id', help = 'Player ID' } })
TriggerClientEvent('chatMessage', source, 'SYSTEM', { 255, 0, 0 }, 'Hello') -- old style
exports.chat:addMessage(source, { args = { 'Hello' } })
El evento de servidor chatMessage se sigue lanzando para el texto sin comando, y se puede cancelar con CancelEvent().
Exports propios (servidor):
exports['lt-chat']:sendChannel('me', source, 'opens the door') -- as if the player typed /me
exports['lt-chat']:isStaff(source)
Las plantillas (chat:addTemplate, template) se muestran como texto: nunca se pinta HTML de otros recursos, así que nadie puede inyectar nada en el chat.
Problemas comunes
La tecla T no hace nada
Sigue arrancado otro chat, o el jugador ha puesto otra tecla en los ajustes de FiveM.
/me sale dos veces o con otro estilo
Otro script registra /me: páralo.
"Otro recurso ya usa ese comando" al renombrar
Elige otro nombre o para ese recurso.
/chatadmin dice que no tienes permiso
Añade add_ace group.admin ltchat.admin allow y comprueba que tu usuario está en ese grupo. Mira también Quién es staff.
Nadie recibe /911
Actívalo en /chatadmin y revisa los nombres de los trabajos en Config.Channels.
No suena nada
Cada jugador lo activa en los ajustes del chat (el botón junto al campo de texto).
Soporte
¿No lo resuelves? Abre un ticket en nuestro Discord con la versión del script, tu framework y el error completo de la consola.