IGK Host, StartUp y Connect

IGK Host es la plataforma para manejar un servidor de MU sin tocar el escritorio del VPS. Tiene tres partes:

#IGK StartUp (MuServer\IGKStartUp\IGKStartUp.exe)

#Qué es

IGK StartUp es el administrador de servidores de IGK Emulator. Reemplaza al StartUp anterior (MuServer\StartUp\ServerStartUp.exe): usa solo uno de los dos. Si los servidores ya estaban abiertos con el StartUp viejo, IGK StartUp los encuentra al abrirse y los retoma sin reiniciarlos.

Qué hace:

• Inicia los servidores en orden y espera a que cada uno abra su puerto antes de arrancar el siguiente.
• Los vigila: si uno se cae, lo reinicia solo; si se cuelga (no responde), guarda un dump y lo reinicia.
• Freno anti-bucle: si un servidor se cae varias veces seguidas en poco tiempo, queda parado y avisa (no se reinicia sin fin).
• Cierre limpio: los jugadores salen guardando sus personajes. También hay cierre con aviso en el juego (1, 3 o 5 minutos) y cierre forzado (al momento).
• Servidores ocultos: los servidores corren sin ventana; con un botón se muestran u ocultan.
• Reinicio diario a la hora que elijas, con aviso en el juego.
• Bandeja del sistema: al minimizar se esconde junto al reloj y sigue vigilando.
• La X pregunta antes de cerrar (nunca se cierra por accidente).
• Abrirlo dos veces muestra la ventana que ya estaba abierta (no abre una segunda copia).
• Reglas del firewall de Windows para los puertos de los jugadores, automáticas.
• Subservidores, chequeo de IP y puertos con botón Corregir, backups y Encoder, todo pedido desde el panel IGK Host.
• Conexión con el panel IGK Host mediante un código de enlace.

Necesita Windows con .NET Framework 4.8 y se abre como administrador (Windows lo pide solo).

#La ventana del StartUp

Barra de arriba:

Botones de la derecha (lista de servidores): + Agregar servidor, ✎ Editar, ▲ / ▼ cambiar el orden de arranque, ✕ Quitar de la lista (no borra nada del disco) y ❖ abrir la carpeta de dumps.

La lista de servidores muestra: Estado, Servidor, PID, Puerto, CPU, RAM, tiempo Encendido, Reinicios y "Último" (la última salida o el motivo de un problema). Cada línea tiene un botón ▶ Iniciar o ■ Apagar (este botón apaga forzado; para una parada limpia usa Apagar ▾ o el clic derecho).

Estados posibles: Arrancando, En línea, No responde, Cerrando, Reiniciando, Detenido (error).

Clic derecho sobre un servidor: Iniciar, Apagar, Reiniciar, los comandos del menú del servidor (recargas, eventos, invasiones...), Editar, mover en la lista, Mostrar u ocultar su ventana, Abrir su carpeta y Abrir su log de hoy. Doble clic muestra u oculta su ventana.

Abajo: la lista de Eventos (arranques, caídas, recargas, backups...) y una línea de estado con CPU, RAM, memoria usada por los servidores, el estado de la conexión con el panel y cuántos servidores están en línea.

#Cerrar el StartUp (la X)

La X siempre pregunta:

• Sí: se cierra el StartUp y los servidores siguen corriendo. Al abrirlo de nuevo los retoma.
• No: parada limpia de todos los servidores y después se cierra.
• Cancelar: no hace nada.

Mientras el StartUp está cerrado el panel IGK Host no puede llegar al VPS y nadie vigila los servidores.

#Bandeja del sistema

Con MinimizeToTray = 1, minimizar esconde el StartUp junto al reloj. Desde el icono: Mostrar, Iniciar todo, Apagado normal de todo, Apagado forzado de todo y Salir. Si un servidor se cae mientras está escondido, aparece un aviso junto al reloj.

#Arrancar con Windows

En Ajustes > General > Arrancar el StartUp con Windows se crea una tarea de Windows que abre el StartUp al iniciar sesión (escondido en la bandeja). Para que además arranque los servidores, marca "Arrancar los servidores al abrir el StartUp". Para que todo vuelva solo después de un reinicio del VPS sin que nadie entre, activa el inicio de sesión automático de Windows.

#Qué pasa cuando un servidor se cae o se cuelga

1. Se cae: el StartUp lo anota en Eventos, guarda un dump si Windows lo generó y lo reinicia a los pocos segundos (RestartDelaySeconds).
2. Se cuelga (no responde varias veces seguidas): guarda un dump, lo cierra y lo reinicia.
3. Se cae varias veces en poco tiempo (en los archivos que vienen con IGK: 3 veces en 10 minutos): queda Detenido (error) y no se reinicia más. Revisa su log y arráncalo a mano.

Los dumps quedan en MuServer\Dumps\<Servidor>\ (sirven para que soporte encuentre el fallo).

#Archivos de la carpeta MuServer\IGKStartUp

#IGKStartUp.ini, explicado

Formato: Clave = Valor ; comentario. Valores 1 = sí, 0 = no.

#[General]

#[Panel]

#[DailyRestart]

#[Database]

#[Firewall]

Las reglas se llaman "IGK StartUp - <servidor>" y "IGK StartUp - SQL Server" en el firewall de Windows. Si tu proveedor de VPS tiene su propio firewall (fuera de Windows), esos puertos también se abren allí.

#[Encoder]

#[ServerN] (un bloque por servidor, en orden de arranque)

Los servidores arrancan en el orden de los bloques y se apagan al revés (el DataServer al final).

En los archivos que vienen con IGK la lista es: DataServer, JoinServer, ConnectServer, GameServer, GameServerCS y WebBridge (este último con Enabled = 0; actívalo si usas el cliente web).

#[Advanced] (normalmente no se toca)

Este bloque no viene en el archivo: se escribe solo cuando cambias algo en Ajustes > Avanzado.

#Commands.ini

Lista los comandos del menú de cada servidor que el StartUp y el panel pueden mandar (recargas, eventos, invasiones, arenas, sacar a los jugadores...). Le llegan al servidor como si alguien hiciera clic en su menú.

Formato: clave = Grupo | Texto | Id | Pregunta antes de mandarlo (opcional)

• clave: el nombre que usan el panel y Reloads.ini. No la cambies.
• Grupo: la categoría (Recargar, Eventos, Invasiones, Custom Arena, Jugadores).
• Texto: lo que se ve en el menú.
• Id: el número del menú del servidor. No lo cambies salvo que cambie el menú del servidor.
• Pregunta: si existe, se pide confirmación (por ejemplo en "All User LogOut" y "All User Disconnect").

Secciones: [GameServer], [ConnectServer] (Reload ServerList, Reload Server Launcher) y [GameServerStop] (los que usa el StartUp para cerrar un GameServer con aviso; no se tocan).

#Reloads.ini

Dice qué recarga necesita cada archivo que guardas desde el panel o desde IGK Connect. El panel la ofrece en "Aplicar recargas".

Formato: parte de la ruta = Tipo de servidor | Comando de Commands.ini | Texto

• La ruta va en minúsculas y con /. Se usa la primera línea que coincide, de arriba abajo (las más concretas van primero).
• Sin comando = reiniciar ese servidor.

Ejemplos de los archivos que vienen con IGK:

#Cómo se vincula con el panel IGK Host

Si alquilas tu servidor en IGK Host, este paso lo hace IGK. Si te lo piden:

1. Abre el StartUp como administrador y pulsa 🔗 Enlazar con el panel.
2. En "1. IPs desde las que entra el panel" escribe la IP pública del panel y pulsa Guardar IPs. Si no la sabes, déjalo vacío y pide que pulsen "Probar y enlazar" en el panel: aparece una barra amarilla "El panel intentó entrar desde X y no está permitida" con el botón Permitir esta IP. Un clic la agrega.
3. En "2. Código de enlace" pulsa Copiar código y entrégaselo a IGK (se pega en el panel).

El código de enlace es privado: no lo compartas. No cambia aunque cierres o reinicies el StartUp; solo cambia si se reinstala sin su carpeta Data.

#Problemas comunes del StartUp

#Panel web IGK Host (área de clientes)

#Entrar

Entras con el correo y la contraseña de tu cuenta de la tienda (los mismos con los que compraste). Si olvidaste la contraseña, usa "¿Olvidaste tu contraseña?" en la pantalla de entrada. Tus datos (nombre, correo, teléfono, contraseña) se cambian en la tienda, no en el panel.

#Mis servidores

Una tarjeta por cada servidor contratado con:

• Nombre y la IP del servidor, y el plan.
• Estado: Conectado, Sin conexión, Preparando (el servidor todavía se está preparando) o el estado del servicio (vencido, suspendido).
• Próximo vencimiento (en amarillo cuando faltan pocos días, en rojo si venció).
• El estado de cada proceso (DataServer, GameServer...).
• Abrir consola y, si el servidor no responde, el botón Soporte (WhatsApp con el mensaje ya escrito).

#La consola de tu servidor

Arriba: el estado de la conexión, CPU y RAM del equipo, disco libre, la acción en curso y los botones Iniciar todo, Apagar ▾ y Reiniciar ▾ (normal, con aviso en el juego de 1, 3 o 5 minutos, o forzado).

Si guardaste archivos que necesitan recarga, aparece la barra "Hay N archivos guardados que esperan su recarga" con el botón Aplicar recargas (hace la recarga en todos los GameServer encendidos, o reinicia el servidor si ese archivo lo necesita).

Pestañas:

Lo que no se ve ni se descarga desde el panel: los ejecutables y librerías (.exe, .dll...), la carpeta del StartUp y los archivos con la contraseña de SQL (DataServer.ini y JoinServer.ini).

#Baneos desde el panel

Botón Banear (en la pestaña Baneos o en cada jugador en línea):

Tiempo: 1, 3, 7, 15, 30 o 90 días, o permanente. El motivo es obligatorio.

El baneo se aplica al momento: quien esté conectado con esa IP o PC sale en unos segundos. Quitar lo levanta al instante (queda en el historial). Más detalles en 12_SEGURIDAD_Y_BANS.md.

#Comprobar y Corregir IP y puertos (pestaña Servidores)

Comprobar revisa, contra la IP de tu servidor:

• ConnectServer\Data\ServerList.dat: la IP y el puerto de cada servidor de la lista.
• El MapServerInfo.dat de cada carpeta Data (principal y subservidores): IP, puerto y que esté la línea de cada GameServer.
• El MainConnect.ini del Encoder: IP y puerto del ConnectServer, y versión y serial del cliente iguales a los del GameServer.
• WebBridge.ini: que todos los puertos estén en ServerPorts.

Corregir arregla lo que se puede, guarda una copia de cada archivo que toca y recarga el ServerList y los GameServer. Si cambió el MainConnect.ini, ejecuta el Encoder para que el cliente tenga la IP nueva. Si cambió el WebBridge.ini, reinicia el WebBridge.

#Subservidores (pestaña Servidores)

Agregar subservidor copia la carpeta Data y el GameServer del principal a MuServer\SubServerN, con su propio Data (drops, eventos, tiendas propias). Lo agrega al ServerList, al MapServerInfo de todos los Data y al firewall, y lo enciende.

• Nombre: hasta 20 letras, números, espacios, - o _.
• Código: de 1 a 18 (0 es el principal y 19 el Castle Siege).
• Puerto: el panel sugiere uno libre.

Quitar lo apaga, lo saca del ServerList y de los MapServerInfo, y guarda su carpeta en un respaldo (no se borra). Cuántos subservidores puedes tener depende de tu plan.

#Errores de los scripts Lua (pestaña Lua)

La pestaña Lua muestra los errores de los scripts Lua de tus GameServer (hoy, hoy y ayer, o los últimos 7 días): cuándo, en qué servidor, el archivo con la línea y el mensaje. Un clic en el archivo lo abre en el editor en esa línea. El botón Revisar todos los scripts comprueba que todos los .lua de Data/Script estén bien escritos sin recargarlos. Al guardar un .lua desde la pestaña Archivos, el panel lo revisa al momento y marca en rojo la línea con el error (el archivo se guarda igual). Más sobre Lua en 16_LUA.md.

#Encoder remoto (pestaña Encoder)

1. Edita la configuración en Archivos > MainInfo: MainInfo.ini, MainConnect.ini, Item, Interface...
2. Si usas plugins (antihack, reshader), elige sus .dll: solo se usa su CRC y no se guardan. Los nombres tienen que ser los de PluginAntiHack y PluginReShader de MainInfo.ini.
3. Pulsa Ejecutar el Encoder y descarga el zip. Su carpeta Data va dentro de la carpeta del cliente.

El resultado muestra el log y los errores de configuración. PathExport no se usa: el resultado siempre sale en el zip. Las últimas ejecuciones quedan en Ejecuciones para volver a descargarlas.

#Backups

• Automáticos: todos los días a la hora que fija IGK Host. Se guardan los más nuevos (los viejos se borran solos).
• Manuales: botón Hacer backup ahora, si tu plan los incluye. Quedan hasta que los borres y cuentan para el máximo de tu plan.
• Se guardan fuera del VPS, en un almacenamiento en la nube.
• Cada backup tiene dos partes que se descargan por separado:
  • Base de datos: todas las bases del servidor (MuOnline...), como archivos .bak de SQL Server.
  • Archivos: MuServer sin logs, ejecutables, dumps, la carpeta del StartUp ni los archivos con la contraseña de SQL.
• Los servidores siguen encendidos mientras se hace.
• Estados: En cola, Haciéndose, Completo, Incompleto, Falló.

Además, cada archivo que guardas desde el panel o IGK Connect guarda su versión anterior en el VPS (las 30 últimas de cada archivo), en la pestaña Archivos > Versiones.

#Vencimiento, avisos por WhatsApp y soporte

• Activo: puedes usar todo.
• Vencido: ves todo pero no puedes cambiar nada (solo lectura) hasta renovar. Los servidores se pueden apagar por el vencimiento.
• Suspendido: no puedes abrir la consola; los servidores se apagan. Escribe a soporte para reactivarlo.
• Si no se renueva, el servicio termina y el servidor se libera.

Avisos por WhatsApp (en Mi cuenta > Avisos por WhatsApp, interruptor "Avisarme si un servidor se cae, se cuelga o va a vencer"): bienvenida, caídas y reinicios automáticos, freno anti-bucle, vencimiento cercano, vence hoy, vencido, suspensión y renovación. Necesitas tener tu teléfono en la tienda. En Mi cuenta también ves los últimos avisos.

Soporte por WhatsApp: cuando el servidor no responde, la consola muestra Escribir a soporte con el mensaje ya escrito.

#Mi cuenta

• Tus datos (vienen de la tienda; botón Traer de la tienda para actualizarlos).
• Avisos por WhatsApp.
• IGK Connect: botón Descargar IGK Connect y la lista de Equipos conectados, con Desconectar para cada uno (IGK Connect deja de funcionar en ese PC hasta que vuelvas a entrar).

#Problemas comunes del panel

#IGK Connect (herramienta de escritorio)

#Qué es

IGK Connect pone los archivos de tu servidor como una unidad de tu PC (M:, N:...). Los editas con tus programas (Notepad++, VS Code, el editor que quieras) y cada vez que guardas, se sube solo. También abre la base de datos con HeidiSQL por una conexión cifrada.

#Instalación

1. En el panel: Mi cuenta > IGK Connect > Descargar IGK Connect (IGKConnect-Setup.exe).
2. Ejecuta el instalador. No pide administrador: se instala solo para tu usuario.
3. Puedes crear un acceso en el escritorio.

Requisitos y qué trae:

• Windows de 64 bits con .NET Framework 4.8 (Windows 10 y 11 ya lo traen). Si falta, el instalador avisa y abre la página de Microsoft.
• Trae HeidiSQL (gratis, portable) para la base de datos.
• Trae el controlador de Microsoft para SQL Server (OLE DB Driver 18). Al terminar de instalar, IGK Connect lo instala si falta, junto con el Visual C++ que necesita (lo baja de Microsoft). Windows pide permiso una sola vez. Si dices que no, lo vuelve a ofrecer al pulsar Base de datos; sin él HeidiSQL igual funciona con el controlador de Windows (más viejo) y avisa.
• Para actualizar, instala la versión nueva encima.

#Entrar

Entra con el correo y la contraseña de tu cuenta de la tienda (los mismos del panel). IGK Connect recuerda la sesión en ese PC. Cerrar sesión desmonta las unidades; para volver, entras otra vez. Cada PC conectado aparece en el panel en Mi cuenta > Equipos conectados, donde lo puedes desconectar.

#La unidad con los archivos

1. Elige tu servidor en TUS SERVIDORES.
2. Elige la letra de la unidad (botón con la letra).
3. Pulsa Conectar: se descargan tus archivos ("Descargando X de Y...") y aparece la unidad. Abrir unidad la abre en el Explorador.

Cómo se sincroniza:

• Lo que guardas se sube solo. En la lista de actividad ves "Subido: ..." y, si hace falta, qué recarga falta.
• Lo que cambia en el servidor (por ejemplo desde el panel) se trae cada 20 segundos.
• Si un archivo cambió en los dos lados, no se pisa nada: queda en conflicto. Clic derecho sobre él en la actividad: Subir mi versión (reemplaza la del servidor), Traer la del servidor (pierdes tus cambios) o Mostrar el archivo.
• Archivos nuevos (una tienda nueva, otro EventItemBag...) se suben solos, con sus carpetas.
• Borrar o renombrar en la unidad no borra en el servidor. Un nombre nuevo se sube como otro archivo.
• Nunca se descargan ni se suben ejecutables ni librerías (.exe, .dll, .bat...). Tampoco se traen las carpetas de logs (los logs se leen en el panel).
• Codificación: los servidores leen sus .txt, .ini, .lua, .cfg y .csv en ANSI (Windows-1252). Si guardas en UTF-8 un archivo que era ANSI, el servidor lo guarda en ANSI y te avisa. Si tiene letras que ANSI no tiene, no se guarda y lo dice. Un archivo que ya era UTF-8 queda en UTF-8.
• Recargas pendientes: aparece la barra "N archivos guardados esperan su recarga en el servidor" con el botón Aplicar recargas.
• Con el servicio vencido, la unidad es de solo lectura (no se sube nada).

Desconectar (o salir) sube lo pendiente, desmonta la unidad y borra la copia de tu PC.

La X de la ventana, con una unidad conectada, solo esconde IGK Connect junto al reloj (sigue sincronizando). Para salir: clic derecho en el icono > Salir (desconecta las unidades).

#La base de datos con HeidiSQL

1. Con tu servidor elegido, pulsa Base de datos.
2. Se abre HeidiSQL ya conectado a las bases de tu servidor (MuOnline...). No escribes usuario ni contraseña.
3. Deja IGK Connect abierto mientras usas HeidiSQL: la conexión pasa por él, cifrada.

• Cada sesión dura 8 horas; después vuelve a pulsar Base de datos.
• El usuario de SQL es propio de tu servidor y solo ve sus bases.
• El puerto de SQL Server no se abre a internet: todo pasa por la conexión cifrada.

#Problemas comunes de IGK Connect

#Preguntas frecuentes

P: ¿Tengo que usar el StartUp viejo (ServerStartUp.exe) o IGK StartUp? R: IGK StartUp (MuServer\IGKStartUp\IGKStartUp.exe). Reemplaza al viejo. No uses los dos a la vez.

P: Cerré el StartUp con la X. ¿Se apagaron los servidores? R: Depende de lo que respondiste. "Sí" deja los servidores corriendo; "No" los apaga limpio. Al abrir el StartUp de nuevo retoma los que siguen encendidos.

P: ¿Dónde está el StartUp? No veo la ventana. R: Minimizado en la bandeja, junto al reloj. Doble clic en su icono, o abre IGKStartUp.exe otra vez y se muestra la ventana.

P: ¿Cómo hago para que los servidores se reinicien todos los días? R: Ajustes > General > Reinicio diario: escribe la hora (por ejemplo 05:00) y elige el aviso (1, 3 o 5 minutos). En el ini: [DailyRestart] Time y NoticeMinutes.

P: ¿Cómo hago que todo arranque solo al reiniciar el VPS? R: Ajustes > General: pulsa "Arrancar el StartUp con Windows" y marca "Arrancar los servidores al abrir el StartUp". Activa el inicio de sesión automático de Windows.

P: Un servidor dice "Detenido (error)". ¿Qué hago? R: Se cayó varias veces seguidas y el StartUp lo frenó. Mira su log (clic derecho > Abrir su log de hoy), corrige el problema y arráncalo con ▶ Iniciar.

P: ¿Cuál es la diferencia entre apagado normal y forzado? R: El normal hace que los jugadores salgan guardando. El forzado corta al momento: cada jugador puede perder lo que no se guardó (hasta 60 segundos).

P: Edité un archivo en el panel y no cambia nada en el juego. R: Pulsa Aplicar recargas en la barra de arriba. Algunos archivos (Terrain, DataServer, JoinServer, ConnectServer) necesitan reiniciar ese servidor.

P: Cambié la IP del VPS. ¿Qué toco? R: En el panel: Servidores > IP y puertos > Comprobar y Corregir. Después ejecuta el Encoder y entrega el nuevo Connect.igk a los jugadores.

P: ¿Puedo descargar el Encoder.exe o los ejecutables? R: No. El Encoder corre en el VPS desde la pestaña Encoder del panel. Los ejecutables nunca se descargan.

P: ¿Cómo restauro un backup? R: Descarga la parte que necesitas en la pestaña Backups. La base de datos viene como archivos .bak de SQL Server; los archivos, como un zip de MuServer. Si tu servidor es de IGK Host, pide la restauración a soporte.

P: ¿Cómo recupero la versión anterior de un archivo que edité? R: En Archivos, abre el archivo y pulsa Versiones: se guardan las 30 últimas de cada archivo.

P: ¿IGK Connect necesita permisos de administrador? R: No para instalarse ni para la unidad. Solo pide permiso una vez para instalar el controlador de Microsoft de SQL Server.

P: Borré archivos en la unidad de IGK Connect. ¿Se borraron del servidor? R: No. Desde IGK Connect nunca se borra nada del servidor.

P: ¿Cómo abro la base de datos? R: En IGK Connect elige tu servidor y pulsa Base de datos: se abre HeidiSQL ya conectado. Deja IGK Connect abierto mientras la usas.