Cliente de PC y Encoder

Guía para el dueño del servidor: cómo se configura el cliente de PC, qué hace el Encoder, qué significa cada opción de MainInfo.ini y MainConnect.ini, cada tabla de las carpetas del Encoder, el config.ini del jugador, los tipos de interfaz, los textos e idiomas, las pantallas de carga, el video de la lista de servidores y las texturas HD.

Para el celular, ver 09_ANDROID.md. Para el navegador, ver 10_WEB.md. La guía para jugadores está en 14_GUIA_DEL_JUGADOR.md.

Rutas: en este documento MainInfo\ es la carpeta del Encoder y Client\ es la carpeta del cliente de PC (la que reciben los jugadores). Data\... siempre es dentro de la carpeta del cliente.

---

#Qué hay en cada carpeta

#Carpeta MainInfo\ (el Encoder)

#Carpeta Client\ (el cliente de PC)

Leer un MuError.log: el archivo va cifrado, para que los jugadores no lo lean. Arrástralo sobre Encoder.exe (el de MainInfo): el Encoder no codifica nada esa vez, escribe al lado MuError.txt en claro y espera Enter para cerrar. Con un archivo que no es un MuError.log cifrado, lo dice y no escribe nada.

El cliente completo con las texturas HD ocupa unos 2,2 GB (la carpeta Data\HD son unos 580 MB de eso).

---

#Encoder: cómo se usa

#Encoder.exe paso a paso

1. Edita MainInfo\MainInfo.ini, MainInfo\MainConnect.ini o la tabla que quieras (.txt). Usa un editor de texto (Bloc de notas, Notepad++).
2. Cierra el juego si lo tienes abierto (si no, el Encoder no puede escribir los archivos).
3. Haz doble clic en MainInfo\Encoder.exe. Lee todo y crea los archivos.
4. Abre MainInfo\Encoder.log y revisa el final:
   • Todos los archivos se crearon sin errores. = todo bien.
   • N error(es) de configuracion: revisar los mensajes de arriba. = hay algo mal escrito; arriba dice qué archivo y qué línea.
5. Copia los archivos nuevos al cliente que repartes a los jugadores (ver tabla de abajo). Si PathExport apunta a tu carpeta Client\, ya quedaron ahí.
6. Abre el juego para probar.

#Archivos que crea el Encoder y dónde van

• La carpeta de destino la da la clave PathExport (ver abajo). En los archivos que vienen con IGK: PathExport = ..\Client, o sea la carpeta Client que está al lado de MainInfo.
• MainInfo.igk y TextInfo.igk van a la carpeta del PathExport de MainInfo.ini. Connect.igk va a la del PathExport de MainConnect.ini.
• Si PathExport está vacío, los archivos quedan en MainInfo\Release\Data\... y los copias tú.
• Cada vez que cambies algo, reparte los .igk nuevos a todos los jugadores (por ejemplo, con tu actualizador o el paquete del cliente). Un jugador con un MainInfo.igk viejo ve la configuración vieja.
• Después de actualizar el cliente (Main.exe) a una versión nueva de IGK, vuelve a correr el Encoder. Un Main.exe nuevo puede no aceptar un MainInfo.igk hecho con un Encoder viejo (sale "Data\MainInfo.igk - Archivo dañado.").

#Mensajes de Encoder.log

#Reglas generales de las tablas .txt

• Las líneas que empiezan con // son comentarios.
• Cada tabla termina con la palabra end. Algunas tienen secciones: un número solo en una línea (0, 1, 2) y luego sus filas hasta end.
• Los textos van entre comillas: "VIP Bronze".
• Los decimales van con punto: 1.5, no 1,5.
• * en una columna significa "cualquiera" (en las tablas que lo permiten).
• Un ítem se escribe casi siempre como grupo y número (las dos primeras columnas, igual que en Item.txt del servidor). Algunas tablas usan el número completo del ítem: grupo × 512 + número (por ejemplo, la Bolt del grupo 4 número 7 es 4 × 512 + 7 = 2055).
• Después de editar cualquier tabla: correr Encoder.exe y repartir el MainInfo.igk (o el TextInfo.igk) nuevo.

---

#MainConnect.ini (conexión)

Archivo: MainInfo\MainConnect.ini, sección [MainInfo]. Crea Data\Local\Connect.igk.

#Problemas comunes de MainConnect.ini

• El juego no conecta / no aparece la lista de servidores: IpAddress o IpAddressPort mal, o el puerto cerrado en el firewall del VPS.
• Conecta pero no deja entrar al juego (error de versión): ClientVersion o ClientSerial no coinciden con ServerVersion / ServerSerial del GameServerInfo - Common.dat. Revisa también el del GameServerCS.
• "Data\Local\Connect.igk - ¡no está o no es válido!" al abrir el juego: falta el archivo en el cliente, o se copió uno roto. Vuelve a correr el Encoder y copia el Connect.igk.

---

#MainInfo.ini (opciones del administrador)

Archivo: MainInfo\MainInfo.ini. Crea Data\MainInfo.igk. El jugador no puede cambiar nada de esto: lo decide el administrador. Las opciones de gusto de cada jugador (FPS, resolución, gráficos, sonido) están en el config.ini del jugador.

Algunas claves aparecen comentadas con ; y la nota MIGRATED to the player's config.ini: ya no se leen aquí. Ahora las elige cada jugador en Opciones (ver la tabla "Claves que pasaron al config.ini").

#[MainInfo]

Si cambias el .dll de un plugin, vuelve a correr el Encoder: el cliente comprueba que el archivo sea exactamente el mismo que estaba al codificar. Si no, sale "¡Error de CRC del plugin!".

#[HelperInfo] (MU Helper)

#[ReconnectInfo] (reconexión automática)

#[CharacterInfo]

#[Custom] (sistemas y botones)

#Escenas: SceneLogin y SceneCharacter

• El mapa de cada escena debe estar en Data\ del cliente (por ejemplo Data\World56). Revisa que exista antes de elegir un valor.
• Con ServerListVideo = 1 el video reemplaza al mapa de SceneLogin (solo en PC).

#[Interface]

#Claves que pasaron al config.ini del jugador

Estas claves están comentadas en MainInfo.ini. Cambiarlas ahí no hace nada. Ahora cada jugador las elige en Opciones y quedan en su config.ini.

---

#Tablas del Encoder

Todas se aplican con el Encoder (crean MainInfo.igk, salvo los tooltips y buffs, que van en TextInfo.igk).

#Common\CustomBuffEffect.txt (nombre y descripción de los buffs)

Qué es: el nombre y la descripción que se ven al pasar el ratón sobre el icono de un buff. Va en TextInfo.igk.

Ejemplo: 2 2 255 255 "Increase Defense" 0 1 1 "Increases Defence : +%d".

#Common\CustomBuyVip.txt (comprar VIP en el juego)

Qué es: los planes VIP que se compran desde la tienda VIP del juego (menú F4 > Tienda Premium).

#Common\CustomChatColor.txt (colores del chat)

Qué es: color de letra de cada tipo de mensaje del chat. Solo se usa con GLFont = 1 en MainInfo.ini.

#Common\CustomCommand.txt (lista de comandos del juego)

Qué es: la lista que el jugador ve en la ventana de Comandos (menú F4 > Comandos). No activa ni desactiva comandos en el servidor: eso se hace en los archivos del servidor.

#Common\CustomMessageGremory.txt (origen de los ítems del Gremory Case)

Qué es: el texto que se ve debajo del nombre de un ítem del Gremory Case (de dónde vino).

• Una sección por idioma del cliente: 0 inglés, 1 portugués, 2 español. Si el idioma del jugador no tiene el texto, se usa el de la sección 0.
• Columnas: Index y Message (hasta 63 letras).
• Index 0 a 249: el número de bolsa (G_Num) de EventItemBagManager.txt del servidor. 250 = /gremory, 251 = Daily Reward, 252 = scripts Lua, 253 = /gremoryall.

#Common\CustomNameWave.txt (nombres con brillo de colores)

Qué es: personajes cuyo nombre se ve con efecto arcoíris / brillo de 7 colores.

#Item\CustomItem.txt (ítems custom)

Qué es: agrega el modelo de un ítem nuevo. Los modelos van en Data\Item\ (o Data\Player\ para piezas de set) y sus texturas en Data\Item\Texture\.

El ítem también debe existir en el servidor (Item.txt) y en Item.bmd del cliente. Su posición en las ventanas va en CustomItemPosition.txt.

#Item\CustomItemPosition.txt (posición de ítems en las ventanas)

Qué es: posición, giro y escala del modelo de un ítem dentro de su casilla (inventario, baúl, tiendas). Las filas de aquí reemplazan o agregan a los valores de Data\Local\ItemTRSData.bmd. Pon solo los ítems que agregas o cambias.

Decimales con punto y sin exponente. Cada ítem una sola vez.

#Item\CustomWing.txt (alas custom)

Qué es: alas y capas nuevas, con sus opciones. Debe coincidir con MuServer\Data\Custom\CustomWing.txt del servidor.

Números de opción (lista del archivo): 80 daño adicional, 81 daño mágico adicional, 82 tasa de defensa, 83 defensa adicional, 84 suerte, 85 recuperación automática de vida %, 102 ignorar defensa %, 109 devolver daño %, 110 recuperar toda la vida %, 111 recuperar todo el maná %, 113 daño de maldición adicional.

#Item\CustomCape.txt (capas con física)

Qué es: cómo se dibuja una capa (con tela que se mueve).

#Item\CustomJewel.txt (joyas custom)

Qué es: joyas nuevas y a qué ítems se pueden aplicar. Tiene sección 0 y termina con end.

* = sin límite. Debe coincidir con la configuración de joyas del servidor.

#Item\CustomStack.txt (ítems apilables)

Qué es: ítems que se apilan en una casilla. Debe coincidir con MuServer\Data\Item\ItemStack.txt.

#Item\CustomImage.txt (texturas extra)

Qué es: texturas adicionales que usan otras tablas (por ejemplo CustomItemRenderMesh.txt). Ruta por defecto: Data\Item\Texture\.

#Item\CustomItemRenderMesh.txt y Item\CEffectRenderMesh.txt (brillos y efectos en el modelo)

Qué es: efectos sobre partes del modelo de un ítem (cromado, brillo, movimiento de textura).

CustomItemRenderMesh.txt:

CEffectRenderMesh.txt hace lo mismo con otro orden de columnas: Type Index Red Green Blue Group RenderEffect EffectType TimeEffectType TextureID TimeTextureID LevelGlow. En IGK trae efectos para pociones y joyas de colores.

#Item\CustomRenderEffect.txt (efectos de armas y alas especiales)

Qué es: asigna a un ítem uno de los efectos predefinidos (Blessed Divine, Holyangel, Awakening, alas especiales...).

#Item\CustomEffectStatic.txt y Item\CustomEffectDynamic.txt (efectos de luz en ítems)

Qué es: partículas o brillos fijos (Static) o con movimiento (Dynamic) pegados a un hueso del modelo.

En los archivos de IGK están vacías (solo ejemplos comentados).

#Item\CustomSmokeItem.txt (humo de sets)

Qué es: color del humo de un set de armadura.

En IGK está vacía.

#Item\CustomRuneEffect.txt (efecto de las runas)

Qué es: el círculo que gira en el suelo debajo del personaje que tiene equipada una runa. Lo ven todos.

• La runa debe estar en Item.txt del servidor y en Item.bmd del cliente con la casilla (Slot) 241. Sus opciones van en el servidor (Data\Item\RuneItemOption.txt).
• La casilla se enciende con RenderEquipmentRune = 1 en MainInfo.ini.

Hasta 32 runas.

#Item\CustomItemToolTip.txt y Item\CustomTextTooltip.txt (líneas extra en la descripción de ítems)

Qué es: líneas de texto extra en la ayuda de un ítem, según su rango, nivel y si es excelente o ancient. Va en TextInfo.igk.

CustomItemToolTip.txt tiene dos secciones (0 ítems, 1 sets), cada una con end:

CustomTextTooltip.txt: Index y Text (el texto entre comillas).

En IGK, CustomItemToolTip.txt viene sin filas activas y los textos de ejemplo están en vietnamita.

#Map\CustomWorld.txt (mapas custom)

Qué es: mapas nuevos con su nombre, imagen y música.

En IGK está activo el mapa 92 (modo MOBA League of Masters).

#Map\CustomSky.txt (cielo por mapa)

Qué es: colores del cielo de cada mapa. El cliente ya trae cielo en los mapas exteriores (Lorencia, Devias, Noria, Tarkan, Aida, Crywolf, Kanturu, Elbeland, Swamp of Calmness, Raklion, Santa Town, Vulcanus, Loren Market y Karutan). Aquí se cambian sus colores, se quita el cielo a un mapa o se le da a otro. Sin fila, el mapa usa el cielo de fábrica (gris de día nublado).

• El cielo se ve donde no hay nada dibujado: arriba al inclinar la cámara 3D (F10) y donde se acaba el terreno.
• El ciclo de día y noche lo cambia solo: horizonte cálido al amanecer y atardecer, azul oscuro de noche, gris con lluvia.
• La niebla de un mapa con cielo toma el color de su horizonte.
• Cada jugador puede apagarlo en Opciones > Imagen > Cielo.

Sin colores, se usan los de fábrica del mapa. Ejemplo (Lorencia): 0 1 1 72 118 182 168 188 208.

#Map\CustomFog.txt (niebla por mapa)

Qué es: deja la niebla siempre encendida en un mapa, con un color. Empieza a 2000 unidades y tapa todo a 2700. Vale para mapas sin cielo (los mapas con cielo usan el color de su horizonte).

En IGK está vacía (solo un ejemplo comentado).

#Monster\CustomMonster.txt (monstruos y NPC custom)

Qué es: monstruos y NPC nuevos con su modelo.

En IGK están los monstruos del modo MOBA (nexos, torres, súbditos).

#Monster\CustomMonsterNameColor.txt (color del nombre de monstruos)

Qué es: color del nombre del monstruo (su barra de vida y lo que dice). Sin fila, blanco.

En IGK vienen coloreados invasiones, Golden, jefes y mini jefes.

#Monster\CustomMonsterSound.txt (sonidos de monstruos)

Qué es: sonidos propios de un monstruo, en lugar de los de su modelo.

#Monster\CustomMonsterRenderMesh.txt (brillos en monstruos)

Igual que CustomItemRenderMesh.txt, pero la primera columna es el número del monstruo (una sola columna). En IGK está vacía.

#Monster\CustomNpcName.txt (nombre de un NPC en un lugar)

Qué es: cambia el nombre de un NPC puesto en un mapa y posición.

En IGK está vacía.

#Pet\CustomPet.txt (mascotas custom)

Qué es: mascotas y monturas nuevas. Texturas en Data\Item\Texture\.

#Pet\CustomPetEffectStatic.txt y Pet\CustomPetEffectDynamic.txt

Iguales que CustomEffectStatic.txt / CustomEffectDynamic.txt, pero para mascotas. En IGK solo traen ejemplos comentados.

---

#Tipos de interfaz (LookAndFeel)

Se elige en MainInfo\MainInfo.ini [Interface] LookAndFeel, se corre el Encoder y se reinicia el juego. El jugador no lo puede cambiar.

• Qué cambia con el tipo: sobre todo la barra de abajo (orbes, AG, SD, experiencia, botones, ranuras Q/W/E/R, skills). En los tipos 1 y 2 también cambian los marcos de casi todas las ventanas, el chat y la lista del grupo.
• Qué no cambia: las pantallas de antes de entrar (carga, servidores, login, personajes), la ventana de Opciones y las ventanas nuevas de IGK.
• En Android la interfaz es siempre la suya (táctil), sin importar LookAndFeel.
• En los tipos 1 y 2 no hay tecla R de pociones (solo Q, W, E). El tipo 1 no tiene botón de amigos ni de tienda en la barra.

#Imágenes de cada tipo: Look-N y Overrides

• Data\Interface\HUD\Look-N\: las piezas propias del tipo (orb_life, button_character, bar...). Cámbialas por otro dibujo con la misma medida.
• Data\Interface\HUD\Look-N\Overrides\: reemplazos de imágenes de Season 6 solo para ese tipo. Mismo nombre, misma ruta (contada desde Data\Interface\) y misma medida que la original. Por ejemplo, Look-3\Overrides\partCharge1\newui_menu03.OZJ reemplaza Data\Interface\partCharge1\newui_menu03.OZJ solo en el tipo 3.
• Un reemplazo que no mide lo mismo que el original no se usa (el juego usa el original y lo anota en MuError.log).
• Lo que un tipo no tiene en su carpeta se toma de Season 6.
• Si falta una imagen, el juego avisa al arrancar "No se pudo cargar la imagen: <ruta>" y esa pieza sale vacía.
• Las versiones HD van en Data\HD\ con la misma ruta (ver "Texturas HD").

#Posiciones: Data\IGK\Settings\Interface\interface_N.json

Qué es: un archivo por tipo (1 a 5) con la posición y el tamaño de todo lo que se puede mover: la barra de abajo, el chat, el minimapa, los buffs, la lista del grupo, los avisos, el inventario, el personaje, el baúl, el comercio, las tiendas y más. Cada elemento trae una nota "_note" que explica qué es.

• Se edita con el juego abierto: al guardar, el juego lo vuelve a leer en un segundo y todo se mueve, sin reiniciar.
• Lo que falta en el archivo usa el valor de fábrica. Las claves que empiezan con _ son notas.
• Los valores de fábrica de cada tipo están en MainInfo\Interface\reference_N.json (también el de Season 6, reference_0.json). Sirven para volver a poner un valor.
• Unidades de la barra (bar): una pantalla de 640x480 (x de 0 a 640, y de 0 a 480). El juego centra ese cuadro abajo en cualquier resolución.
• Unidades del resto (screen): x desde la izquierda, y desde arriba, from_right y from_bottom desde el borde derecho y el de abajo.
• Piezas de la barra (tipos 1 a 5): cada una tiene además enabled (false = apagada, ni se ve ni recibe clic), image (archivo de la carpeta Look-N), crop ([x, y, ancho, alto], qué parte de la imagen se dibuja), mirror (al revés), frames / columns / seconds (animación de los orbes) y states (estados de un botón: 1, 2 o 3).
• Para usar una imagen de otra medida en una pieza de la barra: ponla en Look-N\ y cambia su image y su crop.
• Un JSON roto (por ejemplo, falta una coma) no rompe el juego: se usa todo de fábrica y MuError.log puede indicar la línea y la columna del error.

Ejemplo (mover el orbe de vida del tipo 3):

"life": { "enabled": true, "x": 108, "y": 408, "width": 60, "height": 60, "number_x": 30, "number_y": 30 }

#Crear una interfaz nueva (LookAndFeel 6 o más)

Sin programar:

1. En MainInfo.ini: LookAndFeel = 6 (o 7, 8...). Correr el Encoder.
2. En el cliente, copiar la carpeta del tipo en que te basas (por ejemplo Look-3, con su Overrides) como Data\Interface\HUD\Look-6\.
3. Copiar Data\IGK\Settings\Interface\interface_3.json como interface_6.json y agregarle "base": 3 (a cuál de los tipos 0 a 5 se parece).
4. Cambiar posiciones en interface_6.json e imágenes en Look-6.

Con base 0: copia MainInfo\Interface\reference_0.json como interface_6.json, agrega "base": 0, y en Look-6 pon solo su Overrides\.

Si al nuevo tipo le falta una pieza propia, se usa la del tipo base. Sin interface_6.json o sin un "base" válido, se dibuja como el tipo 0.

#Resoluciones: Data\IGK\Settings\Resolutions.xml

Lista de las 15 resoluciones que el jugador puede elegir (de 800x600 a 1920x1080). Opciones solo muestra las que caben en el monitor. Data\Resolutions_OLD.xml es una lista vieja que el juego no lee.

---

#config.ini del jugador

Archivo: config.ini, en la carpeta del cliente (junto a Main.exe). Lo crea el juego la primera vez y lo cambia la ventana de Opciones. Cada jugador tiene el suyo. Formato: Clave=Valor en secciones [...].

• Si falta una clave, el juego la agrega con su valor por defecto. Si la PC tenía un MU viejo, algunas (resolución, motor, FPS, modo de pantalla, sonido, idioma, recordar cuenta) se toman de la configuración vieja de Windows.
• La primera vez en una PC con gráfica integrada, el juego empieza con el preajuste Medio.
• Para restablecer todo: cerrar el juego y borrar config.ini. Se crea de nuevo al abrir.
• No repartas tu propio config.ini en el cliente para jugadores: lleva tus gustos (motor, resolución, cámara). Mejor que el juego lo cree.

#[Display] (pantalla)

#[Graphics] (gráficos)

#[Interface] (interfaz)

#[Sound], [Game], [Camera], [SettingsFont]

La sección [Mobile] (HudScale) solo la usa Android.

---

#Carpeta Data\IGK del cliente

---

#Textos e idiomas

#Archivos de idioma: Data\IGK\Local\Lang\<idioma>.json

• Todos los textos del juego están en un archivo JSON por idioma, en UTF-8: "name" (el nombre en la lista de Opciones, por ejemplo "Español") y los textos "txt_0", "txt_1"...
• Los originales (maestros) están en MainInfo\Lang\. El juego lee la copia del cliente, en Data\IGK\Local\Lang\.
• El Encoder no toca estos archivos.
• Si falta un texto, en el juego se ve txt_N (por ejemplo txt_5108).
• Si el archivo del idioma falta o está roto, el juego usa Eng.json.

#Cambiar un texto

1. Abre MainInfo\Lang\Spn.json (o el idioma que sea) con un editor que guarde en UTF-8 (Notepad++, VS Code).
2. Busca el texto y cámbialo. Respeta los %d, %s y \n: mismos y en el mismo orden.
3. Guarda y copia el archivo a Data\IGK\Local\Lang\ del cliente.
4. Reinicia el juego.

Cuidado con las comillas: dentro de un texto usa \". Una coma de más o de menos rompe el archivo.

#Agregar un idioma

1. Copia Eng.json como <Código>.json (solo letras, por ejemplo Por.json o Fra.json).
2. Cambia "name" (por ejemplo "Português") y traduce los textos.
3. Ponlo en MainInfo\Lang\ y en Data\IGK\Local\Lang\ del cliente. Aparece solo en Opciones > Juego > Idioma.
4. Opcional: una carpeta Data\Local\<Código>\ con los archivos de ese idioma (ítems, skills, nombres de NPC). Si no está, se usan los de Data\Local\Eng\.

#Cambiar el idioma de un jugador

En el juego: Opciones > Juego > Idioma (necesita reiniciar). O en config.ini: [Game] Language=Spn.

#Otros textos que no están en el JSON

• Mensajes que manda el servidor: en los archivos del servidor.
• Nombres de ítems, skills y NPC: Data\Local\<idioma>\ (Item.bmd, Skill.bmd, NpcName.txt...).
• Origen de los ítems del Gremory Case: MainInfo\Common\CustomMessageGremory.txt.
• El nombre de la ventana: MainConnect.ini WindowName.

---

#Pantallas de carga propias y logo

#Data\IGK\Custom\Loading\ (pantallas de carga)

El juego tiene dos pantallas de carga. Cada una usa tus imágenes si están; si no, la de siempre.

Piezas de la barra (en la misma carpeta):

Para poner tu logo: reemplaza loading_logo.png (PNG con transparencia). Para poner tus fondos: reemplaza loading_01.jpg, loading_02.jpg (puedes agregar _03 y _04) y loading_game_01.jpg, loading_game_02.jpg.

#loading.ini

Las medidas son píxeles de una pantalla de 1920x1080 (el juego las ajusta a la ventana). Si falta una clave, vale el valor de fábrica.

Las frases de cada parte de la carga ("Cargando ítems custom"...) están en el archivo de idioma.

loading_profile.txt y loading_files.txt los escribe el juego en cada carga para saber de antemano cuánto falta. Se pueden borrar sin problema.

#Logos del login y de las capturas

• Logo de MU en el login: Data\Logo\MU-logo.tga (el juego abre el .OZT del mismo nombre) y MU-logo_g.jpg.
• Logo en las capturas de pantalla: Data\Interface\HUD\MU-logo.OZT, activado con MainInfo.ini [Custom] PrintLogo.

---

#Video de la lista de servidores

• Activar: MainInfo\MainInfo.ini [Custom] ServerListVideo = 1, correr el Encoder.
• Archivo: Data\IGK\Custom\Serverlist\bg_serverlist.mp4 en el cliente. Se ve en bucle detrás de la lista de servidores y del login, en lugar del mapa de SceneLogin.
• Su audio suena en lugar de la música del login, al volumen de música de Opciones.
• Se ajusta a la ventana recortando lo que sobra. Recomendado: H.264, 1920x1080 (IGK se probó con un video así a 30 fps).
• Si el archivo falta o no se puede reproducir, queda el mapa con su música.
• En PC necesita Windows 8 o más nuevo.
• Para cambiarlo: reemplaza bg_serverlist.mp4 con tu video (mismo nombre).

---

#Texturas HD (IgkGamers HD Tools)

#Cómo funcionan las texturas HD

• Las texturas HD están en Data\HD\ del cliente, con la misma ruta y nombre que la original (por ejemplo Data\HD\World1\TileGrass01.jpg para Data\World1\TileGrass01.OZJ).
• Las originales no se tocan.
• El jugador las activa en Opciones > Gráficos > Texturas > "Texturas HD" (o config.ini [Graphics] HDTextures=1) y reinicia. Esa casilla solo aparece si el cliente tiene la carpeta Data\HD.
• Una HD debe medir de 1 a 8 veces la original y tener el mismo dibujo.
• Para quitar las HD del cliente: borra Data\HD (o HDTextures=0).
• Memoria de video: a x2 cada textura ocupa 4 veces más. Con "Compresión de texturas" activada se ve igual de nítido con mucha menos memoria. En gráficas con poca memoria conviene usar las dos cosas juntas.

#IgkGamers HD Tools paso a paso

Programa: HDTools\IgkGamersHDTools.exe (Windows 10 u 11 de 64 bits). Para el método con IA necesita una tarjeta gráfica con Vulkan y la carpeta realesrgan junto al .exe.

1. Doble clic en IgkGamersHDTools.exe.
2. Carpeta Data del cliente: elige la carpeta Data de tu cliente (con Examinar...).
3. La lista muestra cada carpeta con texturas, cuántas ya están en HD y cuántas faltan. Marca las que quieras. También puedes arrastrar carpetas o archivos a la ventana.
4. Elige:
   • Método: IA (recomendado: agrega detalle) o Simple (solo agranda).
   • Escala: x2 (recomendado) o x4 (4 veces más memoria que x2).
   • Rehacer las que ya están en HD: sin marcar, solo hace las que faltan (puedes parar y seguir otro día).
5. Convertir. Muestra el avance y el tiempo. Detener para; lo hecho se queda.
6. Prueba en el juego con "Texturas HD" activado.

Otros botones:

Tiempos de referencia con IA a x2 (gráfica de gama media): unas 4 texturas por segundo; Lorencia unos 2 minutos; unas 7.600 texturas (mapas, personajes, armas, monstruos e interfaz) en media hora.

No convierte texturas de menos de 8 píxeles, de más de 1024, .OZT sin transparencia ni los datos del mapa (TerrainLight, TerrainHeight).

Retocar a mano: las HD son JPEG o PNG normales. Puedes editarlas en Photoshop o GIMP con el mismo nombre, carpeta y dibujo, de 1 a 8 veces el tamaño original. Luego usa Revisar.

#Paquete para celular (HDTools\Mobile)

Paquete celular... arma siempre en HDTools\Mobile\:

• Mobile\Data: copia de Data con las texturas del mundo comprimidas para celular (archivos .ktx en lugar de la original). La usa el cliente web en el celular.
• Mobile\data.zip: lo mismo comprimido; es lo que descarga la app de Android.

La interfaz va sin comprimir (para que se lea bien). Data\HD no va en el paquete. Al rehacerlo solo procesa lo nuevo o cambiado. El cliente de PC no usa este paquete. Detalles de publicación en 09_ANDROID.md y 10_WEB.md.

#Línea de comandos de HD Tools

En cmd usa start /wait IgkGamersHDTools ... para esperar a que termine.

---

#Problemas comunes

#"Data\MainInfo.igk - Archivo dañado." al abrir el juego

El MainInfo.igk no corresponde a ese Main.exe (por ejemplo, se actualizó el cliente y no el Encoder, o al revés), o el archivo se copió mal. Corre el Encoder de la misma versión que el Main.exe y copia el MainInfo.igk nuevo.

#"Data\MainInfo.igk - No se encuentra el archivo"

Falta Data\MainInfo.igk en el cliente. Corre el Encoder y cópialo.

#"Data\Local\TextInfo.igk - ¡no está o no es válido!"

Falta o está roto Data\Local\TextInfo.igk. Corre el Encoder y cópialo.

#Cambié MainInfo.ini y no pasa nada

• No corriste el Encoder, o copiaste el .igk a otra carpeta. Revisa PathExport y Encoder.log.
• La clave está comentada como MIGRATED to the player's config.ini: ahora se cambia en Opciones del jugador.
• El jugador tiene un cliente viejo: hay que repartirle el MainInfo.igk nuevo.

#Un texto se ve como "txt_1234"

Falta ese texto en el archivo de idioma del jugador (Data\IGK\Local\Lang\<idioma>.json). Agrégalo (copia la línea de Eng.json y tradúcela).

#Todo el juego sale en inglés aunque elegí Español

El archivo Spn.json del cliente está roto (por ejemplo, falta una coma) o falta. Revisa el JSON en un validador; MuError.log puede indicar la línea.

#La interfaz se ve rara después de editar interface_N.json

Vuelve a poner el valor de fábrica copiándolo de MainInfo\Interface\reference_N.json, o borra la línea (lo que falta usa el valor de fábrica).

#Una imagen de Overrides no se usa

Debe tener el mismo nombre, la misma ruta y la misma medida (ancho, alto y canales) que la original de Season 6. Si no, el juego usa la original.

#No aparece la casilla "Texturas HD" en Opciones

El cliente no tiene la carpeta Data\HD. Conviértelas con HD Tools.

---

#Preguntas frecuentes

P: ¿Dónde cambio la IP del servidor en el cliente? R: En MainInfo\MainConnect.ini, clave IpAddress (y IpAddressPort si cambiaste el puerto del ConnectServer). Luego corre Encoder.exe y reparte el Data\Local\Connect.igk nuevo.

P: ¿Dónde cambio el nombre de la ventana del juego? R: MainInfo\MainConnect.ini, clave WindowName. Corre el Encoder.

P: Los jugadores no pueden entrar: dice error de versión. ¿Qué reviso? R: Que ClientVersion y ClientSerial de MainConnect.ini sean iguales a ServerVersion y ServerSerial de GameServerInfo - Common.dat del GameServer y del GameServerCS. Después corre el Encoder y reparte el Connect.igk.

P: ¿Cómo cambio la interfaz del juego (Season 6, Season 1, Legends...)? R: MainInfo\MainInfo.ini [Interface] LookAndFeel (0 Season 6, 1 Season 1, 2 Season 2/3, 3 Ex700, 4 Legends). Corre el Encoder y reinicia el juego. El 5 está incompleto.

P: ¿Cómo muevo el chat, el minimapa o un orbe de la barra? R: En Data\IGK\Settings\Interface\interface_N.json del cliente (N = tu LookAndFeel). Guarda con el juego abierto y se mueve en un segundo. Season 6 (tipo 0) no tiene archivo.

P: ¿Cómo pongo mi logo en la pantalla de carga? R: Reemplaza Data\IGK\Custom\Loading\loading_logo.png por tu logo en PNG. El tamaño se ajusta con loading.ini [Logo] Scale.

P: ¿Cómo cambio el video de la lista de servidores? R: Reemplaza Data\IGK\Custom\Serverlist\bg_serverlist.mp4 por tu video (mismo nombre, H.264). Debe estar ServerListVideo = 1 en MainInfo.ini.

P: ¿Cómo traduzco o cambio un texto del juego? R: Edita MainInfo\Lang\<idioma>.json en UTF-8, respetando %d y %s, y copia el archivo a Data\IGK\Local\Lang\ del cliente. No hace falta el Encoder.

P: ¿Puedo limitar los FPS de todos los jugadores desde MainInfo.ini? R: No. FpsRenderMax ya no se lee. Cada jugador elige su límite en Opciones > Pantalla (config.ini [Display] FpsLimit).

P: ¿Cómo activo el ciclo de día y noche? R: Se enciende en el servidor (DayNightSwitch y claves DayNight en GameServerInfo - Common.dat). En el cliente, cada mapa lo sigue si tiene DayNight = 1 en MainInfo\Map\CustomSky.txt.

P: ¿Cómo agrego un ítem nuevo al cliente? R: Pon el modelo en Data\Item\ y sus texturas en Data\Item\Texture\, agrégalo a Item.bmd del cliente y a Item.txt del servidor, y agrega su fila en MainInfo\Item\CustomItem.txt (y su posición en CustomItemPosition.txt). Corre el Encoder.

P: ¿Cómo quito las clases Summoner y Rage Fighter de la creación de personaje? R: MainInfo.ini [Custom] RemoveClass = 2. Corre el Encoder.

P: ¿Por qué el menú F4 no muestra "Banco de ítems" o "Misiones"? R: "Banco de ítems" necesita EnableJewelOfInventory = 1. Recompensa diaria, Gremory Case, Misiones y Pase de temporada solo aparecen si el servidor los tiene activados.

P: ¿Debo incluir mi config.ini en el cliente que reparto? R: No. Lleva tus gustos (motor, resolución, cámara). Sin él, el juego crea uno con valores por defecto para cada jugador.

P: ¿Las texturas HD son obligatorias? R: No. Son opcionales: cada jugador las activa en Opciones. Si no quieres repartirlas (pesan unos 580 MB), quita la carpeta Data\HD del cliente.