Configuración básica

Guía de instalación

Última actualización Hace alrededor de 7 horas

Aquí tienes una guía completa, profesional y formateada en Markdown, lista para copiar y pegar en tu base de conocimientos de FeatureBase:

markdown
# 🚀 Guía de Instalación y Configuración - DotChat

Bienvenido a la documentación oficial de DotChat. Esta guía te explicará paso a paso cómo instalar, configurar y personalizar el sistema de chat para tu servidor de FiveM.

---

## 📌 Requisitos Previos

- Servidor FiveM (FXServer) actualizado (Recomendado artifacts recientes).

- Soporte de Framework: Funciona automáticamente en ESX Legacy / ESX, QBCore o en modo Standalone (sin framework).

- Compatibilidad: Funciona con txAdmin y permisos ACE nativos.

---

## 📥 Paso 1: Instalación del Recurso

1. Extrae o copia la carpeta `DotChat` dentro del directorio resources/ de tu servidor FiveM:

 ```text

 resources/

 └── [scripts]/

 └── DotChat/

 ├── client/

 ├── server/

 ├── html/

 ├── config.lua

 └── fxmanifest.lua

⚙️ Paso 2: Configuración del server.cfg

Para garantizar que DotChat funcione correctamente y evitar conflictos de interfaz con chats antiguos:

  1. Abre el archivo server.cfg de tu servidor.

  2. Desactiva/Comenta los scripts de chat anteriores colocando un # al inicio:

    cfg
# ensure chat

# ensure esx_chat_theme

# ensure chat-theme-gtao

# ensure esx_rpchat

# ensure qb-chat

    💡 Si esx_chat_theme está dentro de la carpeta [core], también puedes renombrar dicha carpeta a .esx_chat_theme para que FiveM la ignore.

  3. Añade e inicia DotChat:

    cfg
ensure DotChat

🎨 Paso 3: Opciones Principales de Configuración (config.lua)

Abre el archivo config.lua para adaptar el chat al estilo de tu comunidad:

🔹 Estilo Visual (Config.Theme)

  • 'neon': Tema Cyberpunk Azul Neón fluorescente con bordes brillantes.

  • 'classic': Tema Azul Oscuro Elegante y Minimalista sin resplandor neón.

lua
Config.Theme = 'classic' -- Opciones: 'neon' o 'classic'

🔹 Modo Simplificado (Config.Simplify)

  • true (Recomendado para servidores de España/ESP): Oculta las pestañas superiores dejando una interfaz limpia y libre de distracciones.

  • false: Muestra las pestañas superiores para filtrar canales (IC, OOC, Facciones, Staff).

lua
Config.Simplify = true

🔹 Texto 3D Flotante sobre la Cabeza

Activa o desactiva la aparición de texto 3D sobre la cabeza de los jugadores cuando realizan /me o /do:

lua
Config.Draw3DText = {

 Enabled = true,

 DisplayDuration = 7000, -- Duración en ms

 Distance = 15.0, -- Distancia visible en metros

 Scale = 0.35

}

🔹 Webhooks de Discord (Logs de Moderación)

Para registrar todos los mensajes RP en un canal de Discord:

lua
Config.Webhooks = {

 Enabled = true,

 Url = "TU_DISCORD_WEBHOOK_URL_AQUI",

 BotName = "DotChat Logger"

}

💬 Comandos de Roleplay Incluidos

text
========================================================================================
                         📌 LISTA DE COMANDOS - DOTCHAT RP
========================================================================================
 🔹 COMANDOS DE ROLEPLAY LOCAL (PROXIMIDAD)
 --------------------------------------------------------------------------------------
  • /me <acción>
    └─ Descripción : Realiza una acción física del personaje (+ Texto 3D sobre la cabeza).
    └─ Ejemplo     : /me saca una libreta del bolsillo y anota rápidamente.
    └─ Alcance     : Local (15 metros)
  • /do <entorno>
    └─ Descripción : Describe el entorno, detalles o estado de una situación (+ Texto 3D).
    └─ Ejemplo     : /do ¿Se observaría alguna cámara de seguridad en la entrada?
    └─ Alcance     : Local (15 metros)
  • /looc <mensaje>  (Alias: /l)
    └─ Descripción : Mensaje fuera de personaje (OOC) solo para jugadores cercanos.
    └─ Ejemplo     : /looc Un segundo que se me ha congelado el juego.
    └─ Alcance     : Local (20 metros)
 🔹 COMANDOS DE ENTORNOS Y REDES SOCIALES (IC)
 --------------------------------------------------------------------------------------
  • /twt <mensaje>  (Alias: /twitter, /tweet)
    └─ Descripción : Publica un mensaje en la red social Twitter IC.
    └─ Alcance     : Global (Todo el servidor)
  • /dark <mensaje>  (Alias: /darkweb)
    └─ Descripción : Publica un mensaje anónimo en la Red Oscura IC.
    └─ Alcance     : Global (Identidad oculta)
  • /ano <mensaje>  (Alias: /anonimo)
    └─ Descripción : Envía un mensaje anónimo sin revelar el nombre de tu personaje.
    └─ Alcance     : Global (Identidad oculta)
  • /ad <anuncio>  (Alias: /anuncio)
    └─ Descripción : Anuncio comercial IC para compras, ventas o servicios.
    └─ Alcance     : Global (Costo configurable)
 🔹 COMANDOS DE FACCIONES Y EMERGENCIAS
 --------------------------------------------------------------------------------------
  • /pol <mensaje>  (Alias: /police, /lspd)
    └─ Descripción : Comunicado oficial del Departamento de Policía (Solo Policía).
    └─ Alcance     : Global
  • /ems <mensaje>  (Alias: /medico, /samu)
    └─ Descripción : Comunicado oficial de los Servicios Médicos (Solo EMS).
    └─ Alcance     : Global
  • /mech <mensaje>  (Alias: /mecanico)
    └─ Descripción : Anuncio oficial del Taller de Mecánicos (Solo Mecánicos).
    └─ Alcance     : Global
 🔹 COMANDOS PRIVADOS Y ADMINISTRACIÓN
 --------------------------------------------------------------------------------------
  • /pm <ID> <mensaje>  (Alias: /mp, /msg)
    └─ Descripción : Envía un mensaje privado directo a otro jugador por su ID.
    └─ Ejemplo     : /pm 12 ¿Necesitas ayuda con las teclas de control?
  • /staff <mensaje>  (Alias: /a, /admin)
    └─ Descripción : Anuncio oficial de la Administración (Exclusivo Staff / txAdmin).
    └─ Ejemplo     : /staff Reinicio programado del servidor en 15 minutos.
  • /clear
    └─ Descripción : Limpia todos los mensajes visibles de tu pantalla.
========================================================================================
                          DotChat System • DotComm Studios
========================================================================================

🛡️ Permisos de Administración (/staff)

El comando /staff cuenta con un sistema de verificación estricto para evitar que jugadores normales publiquen mensajes de administración. Reconoce automáticamente:

  • txAdmin: Administradores con acceso activo al menú de txAdmin.

  • Permisos ACE de FiveM: Grupos group.admin, group.superadmin o nodos command.admin / dotchat.admin.

  • ESX / QBCore: Usuarios con rango de administración asignado (admin, superadmin, god).

❓ Preguntas Frecuentes y Solución de Problemas

1. El chat no se abre con la tecla 'T' o '/'

  • Asegúrate de haber iniciado DotChat en tu server.cfg y desactivado el recurso de chat por defecto.

  • Puedes restablecer las vinculaciones de teclas en el juego desde Ajustes > Asignación de Teclas > FiveM.

2. El cursor se queda bloqueado al presionar ESC

  • Asegúrate de tener la última versión de DotChat. El script incluye una función de liberación incondicional del foco NUI para evitar cualquier bloqueo de pantalla.

3. ¿Cómo cambio entre el tema Neón y el Tema Clásico?

  • Cambia la variable Config.Theme = 'classic' o Config.Theme = 'neon' en config.lua y ejecuta restart DotChat en la consola del servidor.

📞 Soporte

Si necesitas ayuda adicional o deseas reportar un problema, abre un ticket en nuestro Discord de soporte o consulta la base de conocimientos de DotComm Studios.