DOCUMENTACIÓN VIVA · COMPANION 4.0

Domina NosGM Companion.

Una guía clara para jugadores, colaboradores y equipo GM. Aprende qué puede ofrecerte el bot, qué permisos necesitas y cómo usar cada sistema sin poner en riesgo el servidor.

● Actualizado el 19 de julio de 2026Cubre Companion 4.0 · 12 sistemas comunitarios

NosGM Companion

/panel
World online
Music voice ready
Codex ready
Sentinel watching
Oracle local AI

// Elige tu camino

Puedes leer todo o saltar directamente a la parte que corresponde a tu función dentro de la comunidad.

Soy usuario

Música, comandos comunitarios, Codex, bugs, eventos, traducción y vinculación.

→02

Soy GM

World Bridge, permisos, operaciones auditadas, Sentinel y aprobación dual.

→03

Administro el bot

Requisitos, voz, canales, roles, IA local y seguridad del despliegue.

→

✓

Antes de empezar

El bot funciona con comandos de barra de Discord. Escribe / y selecciona NosGM Companion. Discord mostrará los nombres localizados cuando estén disponibles.

El bot debe aparecer como conectado en Discord.
Los comandos comunitarios no requieren que NosTale esté abierto.
Los comandos GM requieren que World Server y el puente estén activos.
Ollama solo es necesario para las funciones de IA; Codex, comunidad y GM siguen funcionando sin IA.

01 · PRIMEROS PASOS

Conoce el bot y abre tu panel

El panel reúne el estado de los principales sistemas y te dirige al lugar correcto.

Abre el centro de control

Muestra World, Codex, Bug Hunter, eventos, cuentas vinculadas y Oracle.

/panel

Consulta la ayuda

Obtén el resumen de comandos disponibles.

/ayuda

Selecciona tu idioma

Guarda tu preferencia personal. Admite español, inglés, alemán, francés, italiano, polaco, turco y checo.

/idioma valor:Español

Conoce el proyecto

Consulta enlaces, estado y roadmap.

/proyecto  ·  /estado  ·  /roadmap

02 · TODOS LOS USUARIOS

Busca información con NosTale Codex

Es una biblioteca de solo lectura. Busca por VNum/ID o nombre y deja que el autocompletado encuentre la entrada.

Objetos

Nombre, descripción, precio, tipo e icono.

/codex objeto busqueda:101

Monstruos

Nivel, elemento, raza, velocidad y experiencia.

/codex monstruo busqueda:Dander

Mapas

Dimensiones y minimapa cuando está disponible.

/codex mapa busqueda:NosVille

Skills

Clase, nivel, elemento, coste de MP y cooldown.

/codex skill busqueda:Fire

◆ Los datos e imágenes proceden de Itempicker y se guardan en una caché local. Consultar un VNum nunca entrega objetos al personaje.

03 · COMUNIDAD

Reporta bugs y participa

Los reportes reproducibles reciben puntos en la Liga Bug Hunter y ayudan al equipo a corregir la source.

Crea un reporte

Completa título, servicio/versión, pasos, resultado actual y esperado.

/bug nuevo

Investiga reportes

Lista, abre o marca que también pudiste reproducir un problema.

/bug lista  ·  /bug ver  ·  /bug reproducir

Consulta el ranking

Los reportes confirmados, corregidos y publicados otorgan más XP.

/bug ranking

Únete a eventos

Consulta los próximos eventos y usa los botones Unirse o Salir.

/evento lista

Revisa cambios

Lee las publicaciones manuales y releases detectadas desde GitHub.

/cronica ver

04 · CANALES DE VOZ

Escucha música con la comunidad

Companion reproduce audio de YouTube en el canal de voz, mantiene una cola independiente por servidor y se desconecta cuando queda inactivo.

Entra a un canal de voz

Debes estar en el mismo canal donde quieres que entre el bot. Necesita Conectar, Hablar y Usar actividad de voz.

Busca o pega un enlace

Acepta búsquedas, vídeos y playlists de YouTube; no descarga archivos ni admite enlaces arbitrarios.

/musica reproducir busqueda:NosTale soundtrack

Controla la reproducción

Pausa, continúa, salta, detén o consulta la canción actual.

/musica pausar  ·  /musica continuar  ·  /musica saltar
/musica detener  ·  /musica ahora

Administra la cola

Consulta la cola, ajusta el volumen o saca el bot. Un rol DJ y un canal de texto pueden limitar estos controles.

/musica cola  ·  /musica volumen valor:60  ·  /musica salir

◆ Usa contenido que tengas derecho a reproducir. Colas, playlists y duración tienen límites; los directos están bloqueados por defecto.

05 · IDENTIDAD

Vincula tu personaje de forma demostrable

El bot verifica que controlas el personaje sin pedir tu contraseña ni consultar tus credenciales.

Conecta el personaje

Debe estar online para recibir un código privado de ocho caracteres.

/cuenta vincular personaje:TuNombre

Confirma en Discord

Introduce el código antes de 10 minutos. Solo se guarda su hash SHA-256.

/cuenta confirmar codigo:A1B2C3D4

Muestra el perfil

Consulta nivel, héroe, job y clase del perfil vinculado.

/cuenta perfil

Elimina el vínculo

Puedes desvincularlo cuando quieras.

/cuenta desvincular

◆ Nunca entregues al bot la contraseña de NosGM. El código se envía dentro del juego y se bloquea tras cinco intentos fallidos.

06 · IA LOCAL

Pregunta, traduce y diagnostica

Ollama permite usar IA local sin cuota. Si está apagada, el resto del bot continúa activo.

Pregunta sobre NosGM

El asistente usa una memoria breve por usuario y canal.

/preguntar pregunta:¿Cómo reporto un packet incorrecto?

Usa NosGM Oracle

Analiza preguntas, logs sanitizados o evidencia de paquetes y separa hechos de hipótesis.

/tecnico preguntar  ·  /tecnico diagnosticar  ·  /tecnico paquete

Traduce un mensaje

Haz clic derecho sobre el mensaje, abre Aplicaciones y selecciona Traducir con NosGM.

Comprueba Ollama

Muestra proveedor, disponibilidad y modelo activo.

/ia-estado

◆ Oracle no debe inventar estructuras, offsets ni fixes. Sus fuentes locales se muestran cuando encuentra documentación relacionada.

07 · EQUIPO GM

Administra World sin entrar al juego

Debes tener el rol correspondiente. El bot firma cada solicitud y World solo acepta la lista autorizada.

Consulta el servidor

Estado, conectados, perfiles, posiciones y diagnóstico de memoria/uptime.

/gm estado  ·  /gm jugadores  ·  /gm jugador  ·  /gm posicion  ·  /gm servidor

Ayuda a un jugador

Revisa inventario/historial, envía un susurro o rescata un personaje a coordenadas validadas.

/gm inventario  ·  /gm historial  ·  /gm susurrar  ·  /gm atasco

Modera y comunica

Anuncia, expulsa, teletransporta, silencia o retira un silencio.

/gm anunciar  ·  /gm expulsar  ·  /gm teletransportar  ·  /gm silenciar  ·  /gm quitar-silencio

Solicita una sanción crítica

Banear o desbanear envía una solicitud al canal de auditoría. Otro Admin/Owner debe aprobarla en menos de cinco minutos.

/gm banear  ·  /gm desbanear

⚠ El solicitante nunca puede aprobar su propia operación.

08 · OBSERVABILIDAD

Vigila World con Sentinel

Sentinel realiza comprobaciones firmadas y avisa solo cuando World cambia de estado o supera el umbral configurado.

Consulta la salud

Muestra disponibilidad, jugadores, canal y memoria del proceso.

/sentinel

Mira la web pública

La portada agrupa los canales normales y Act4, muestra jugadores y se refresca cada 20 segundos. Si el heartbeat deja de llegar, el estado cambia a offline automáticamente.

Recibe alertas

El canal configurado informa caídas, recuperaciones y memoria elevada.

Actúa con evidencia

Usa /gm servidor y Oracle con logs sanitizados antes de reiniciar o aplicar cambios.

09 · CONFIGURACIÓN

Pon el bot en producción correctamente

El administrador mantiene Discord, voz, World Bridge, datos persistentes y la IA local.

Inicia Companion

Instala, compila, prueba y arranca desde la carpeta del bot.

npm ci
npm run build
npm test
npm start

Inicia el puente

World y el bot deben compartir el mismo secreto; el listener permanece en loopback.

GM_BRIDGE_URL=http://127.0.0.1:8787
NOSGM_GM_BRIDGE_PREFIX=http://127.0.0.1:8787/

Publica el estado

El reporter consulta cada World Bridge local, agrupa canales normales y Act4 y envía solo disponibilidad y conteos mediante HMAC. Usa un secreto exclusivo; nunca reutilices GM_BRIDGE_SECRET.

NOSGM_STATUS_URL=https://tu-web/api/server-status
NOSGM_STATUS_REPORTER_SECRET=secreto-exclusivo

Configura música

Puedes limitarla a un canal de texto y a un rol DJ. FFmpeg y Opus se instalan con npm ci; deja la cookie vacía salvo que YouTube la exija.

MUSIC_ENABLED=true
MUSIC_TEXT_CHANNEL_ID=
MUSIC_DJ_ROLE_ID=
MUSIC_DEFAULT_VOLUME=60
YOUTUBE_COOKIE=

Configura canales

Define auditoría GM, bugs, eventos, Sentinel, Chronicle, moderación y bienvenida en .env.

Configura roles

Define Helper, Moderator, Admin, Owner, miembro, verificado y rangos Bug Hunter.

Mantén IA gratuita

Modelos ligeros recomendados para GT 730.

ollama pull qwen2.5:3b
ollama pull llama3.2:1b

10 · COMPANION 4.0

Los 12 sistemas de Companion 4.0

Todos comparten datos persistentes, permisos y auditoría. Activa primero las variables necesarias en .env.

Raid Center

/raid crea grupos, waitlist, perfiles de rol/SP y canales de voz temporales.

Live Map

/mapa-vivo exige consentimiento; el público nunca recibe coordenadas exactas.

Asistente de personajes

/personaje muestra, compara y recomienda sin modificar el juego.

Codex mejorado

/codex favorito, favoritos y comparar guardan herramientas personales.

Tickets

/ticket abre soporte privado, permite reclamarlo y lo archiva al cerrar.

Moderación

/moderacion muestra señales progresivas; el bot nunca banea automáticamente.

Operations

/operaciones combina World y servicios comunitarios en un canal privado.

Traducción

/traducir usa los ocho idiomas y Ollama local cuando está disponible.

Sugerencias

/sugerencia publica votos por botones y estados del roadmap.

Progreso

/comunidad premia contribuciones útiles con cooldown, misiones e insignias.

Radio NosGM

/radio reproduce estaciones usando la cola y límites seguros de música.

Panel web

OAuth2 exige Gestionar servidor; escucha en 127.0.0.1 y debe publicarse detrás de HTTPS.

// ACCESS CONTROL

Permisos GM

Los niveles son acumulativos. El propietario del servidor se considera Owner. Ningún rol permite ejecutar SQL o comandos libres.

ROLECOMMANDSPURPOSE

Helper/gm estado, jugadores, jugador, posicion y servidorConsultas seguras y diagnóstico básico.

Moderatorinventario, susurrar, atasco, historial, anunciar, expulsar, teletransportar, silenciar y quitar-silencioAsistencia y moderación operativa.

Adminbanear y desbanearRequiere aprobación de otro Admin u Owner.

OwnerTodos los niveles anterioresMáxima autoridad auditada; no elimina las protecciones.

11 · SECURITY

Reglas que nunca debes romper

01Nunca publiques DISCORD_TOKEN, GM_BRIDGE_SECRET, AuthKeys o contraseñas SQL.
02El puente debe escuchar en 127.0.0.1 o detrás de una red privada/VPN; nunca expongas el puerto 8787 directamente a Internet.
03La entrega de objetos, el apagado remoto, SQL libre y paquetes GM arbitrarios permanecen bloqueados.
04Todo ban o unban necesita dos personas distintas y queda registrado en el canal privado de auditoría.
05Sanitiza logs antes de compartirlos: elimina tokens, IP privadas, correos y credenciales.

12 · SUPPORT

Solución rápida de problemas

El bot aparece offline +

Abre la consola en la carpeta del bot y ejecuta npm start. Mantén esa ventana abierta.

fetch failed en un comando GM +

Comprueba que World Server está activo, que el puerto 8787 escucha y que GM_BRIDGE_URL no tiene http:// duplicado.

Faltan comandos nuevos +

Reinicia el bot. Con DISCORD_GUILD_ID los cambios aparecen casi inmediatamente; los comandos globales pueden tardar.

La IA no responde +

Inicia Ollama y comprueba /ia-estado. El resto del bot continuará funcionando.

No llega el código de cuenta +

El personaje debe estar conectado una vez. El código dura 10 minutos y solo permite cinco intentos.

El Codex todavía está vacío +

Espera la primera sincronización o pide a staff ejecutar /codex actualizar. Después usa la última caché válida.

El bot entra al canal pero no suena +

Concede Conectar, Hablar y Usar actividad de voz; después ejecuta npm ci y reinicia el bot.

YouTube no devuelve resultados +

Comprueba la conexión del equipo. Si YouTube exige sesión, configura YOUTUBE_COOKIE en privado y nunca la publiques.

// ALWAYS CURRENT

Esta guía crecerá con el bot

Cada función, reparación o cambio de seguridad de NosGM Companion se añadirá aquí en español e inglés. La versión indicada arriba te permite saber si estás leyendo la documentación correcta.

Volver al proyecto ↗