Cómo configurar un minimapa personalizado en el cliente de MU

El minimapa es uno de los elementos de interfaz más subestimados del cliente de MU Online, pero también uno de los que más elevan la percepción de calidad de un servidor privado. Cuando un jugador abre el panel de orientación y ve el plano correcto del mapa, con íconos bien posicionados de NPCs, portales y spots de caza, la experiencia cambia por completo. Este tutorial cubre el proceso completo — de la preparación del arte base a la conversión a los formatos internos de MU, el registro de los íconos y la validación de escala — para que tu minimapa quede alineado a las coordenadas reales que el servidor envía al cliente. Es un trabajo de nivel avanzado porque involucra conversión de imagen, sistema de coordenadas de tile y, en algunos clientes, edición de archivos de configuración poco documentados.

Antes de empezar, vale recordar que casi toda personalización de cliente presupone que ya tienes un servidor corriendo y un cliente compatible en mano. Si aún estás montando la base, empieza por la guía de cómo crear un servidor de MU Online y vuelve aquí después de tener el cliente funcional apuntando a tu servidor.

Requisitos previos

Reúne el entorno antes de tocar cualquier archivo. La falta de una sola herramienta suele trabar el proceso a la mitad.

• Cliente de MU compatible con la season de tu servidor, ya probado y conectando normalmente.
• Editor de imagen — GIMP (gratuito) o Photoshop, para dibujar y ajustar el plano del mapa.
• Conversor de imágenes MU (MU Image Converter / OZJ-OZT Tools) para transformar .png/.jpg a los formatos internos .ozj y .ozt.
• Editor de texto para código — Notepad++ o VS Code, para editar los archivos de definición de íconos del minimapa.
• Herramienta de captura de coordenadas — el comando de GM /pos o el overlay de posición del cliente, para descubrir las coordenadas exactas de NPCs y portales.
• Backup completo de la carpeta del cliente antes de empezar. Crea una carpeta _original/ y copia allí todo lo que vayas a modificar.

Cómo funciona el minimapa en el cliente

El panel de minimapa de MU combina tres capas independientes que el cliente superpone en tiempo real:

1. El arte base del mapa — una imagen estática que representa el plano de ese world (Lorencia, Devias, Noria, etc.), almacenada en formato interno de MU.
2. El marcador del personaje — un ícono que el cliente dibuja dinámicamente convirtiendo la coordenada de tile del jugador (X e Y de 0 a 255) a píxeles dentro del arte.
3. Los íconos de interés — NPCs, portales, tiendas y spots definidos en un archivo de configuración, cada uno con un tipo de ícono y una coordenada de tile.

La parte crítica de entender es el sistema de coordenadas. Todo mapa en MU es una cuadrícula de 256×256 tiles. El servidor siempre habla en esas coordenadas. Cuando el cliente dibuja el marcador, hace una regla de tres: pixel_x = (tile_x / 256) * ancho_del_arte. Si tu arte no cubre exactamente la misma área lógica que el servidor usa, los íconos quedan desplazados. Por eso la dimensión de la imagen y el encuadre importan tanto — más que la belleza del dibujo.

Estructura de archivos del minimapa

La ubicación exacta varía según season/cliente, pero la organización típica sigue este patrón:

MUClient/
├── Data/
│   └── Local/
│       ├── MiniMap/            ← artes de mini-mapa por world
│       │   ├── MiniMap0.ozj    ← Lorencia (world 0)
│       │   ├── MiniMap2.ozj    ← Devias (world 2)
│       │   ├── MiniMap3.ozj    ← Noria (world 3)
│       │   └── ...
│       └── MiniMapInfo.txt     ← definição de ícones (nome varia)
├── Interface/
│   └── minimap_frame.ozt       ← moldura/borda do painel
└── Main.exe

Paso 1 — Preparar el arte base del mapa

El arte necesita representar fielmente el área navegable del world. El enfoque más confiable es partir del propio plano del juego:

1. Entra al mapa con un personaje GM y activa el modo de vista amplia, o usa una captura de mapa completa de la comunidad de esa season.
2. En el editor de imagen, monta el plano en un lienzo cuadrado (por ejemplo 256×256 o 512×512 píxeles) — el minimapa de MU presupone proporción 1:1 con la cuadrícula de tiles.
3. Alinea el dibujo de forma que la esquina inferior izquierda represente el tile (0,0) y la esquina superior derecha represente el tile (255,255). La orientación del eje Y en MU está invertida respecto a la imagen, así que planifica esto desde el comienzo.
4. Deja el fondo con un color sólido o textura oscura, y dibuja los caminos, obstáculos y regiones de agua/pared con buen contraste.
5. Exporta como .jpg con calidad 90% (arte sin transparencia) o .png (si vas a usar .ozt con canal alfa).

Tabla de referencia de dimensiones

Paso 2 — Convertir al formato interno de MU

El cliente no lee .png/.jpg directamente para el minimapa. Convierte el arte final:

1. Abre el MU Image Converter.
2. Arrastra tu arte .jpg a la ventana y selecciona salida .ozj (sin transparencia) — o .png para salida .ozt (con alfa).
3. Haz clic en Convert y verifica que el archivo generado tenga tamaño coherente (un .ozj corrupto generalmente sale con pocos bytes).
4. Renómbralo exactamente al índice esperado por el cliente, por ejemplo MiniMap2.ozj para Devias.
5. Cópialo a la carpeta de minimapa del cliente.

# PowerShell — validar rapidamente se os arquivos convertidos existem e têm tamanho
Get-ChildItem "MUClient\Data\Local\MiniMap\*.ozj" |
  Select-Object Name, @{Name="KB";Expression={[math]::Round($_.Length/1KB,1)}}

Paso 3 — Registrar los íconos de NPCs y portales

Aquí es donde el minimapa deja de ser solo una imagen y se convierte en una herramienta de navegación. Los íconos se definen en un archivo de texto que asocia world + coordenada + tipo de ícono. La sintaxis exacta varía según cliente, pero el patrón conceptual es constante:

// MiniMapInfo.txt  (formato ilustrativo — varia por season/cliente)
// World  X    Y    TipoIcone  Descricao
2        123  110  1          "Loja de Armas"
2        180  95   2          "Portal para Dungeon"
2        207  50   3          "NPC de Quest"
0        135  128  4          "Safe Zone / Spot"

El paso a paso para llenarlo con precisión:

1. Entra al mapa con un personaje GM.
2. Camina hasta cada NPC o portal y usa el comando /pos (o el overlay de coordenadas) para leer el X e Y de tile exactos.
3. Anota la coordenada y elige el tipo de ícono correspondiente en la tabla de tipos de tu cliente.
4. Agrega una línea por punto de interés, siempre con el índice de world correcto.
5. Guarda el archivo en ANSI/UTF-8 sin BOM — algunos clientes no interpretan el BOM e ignoran el archivo entero.

Tipos de ícono comunes

Paso 4 — Ajustar el marco y la posición del panel

El marco (frame) que envuelve el minimapa es un .ozt separado, con transparencia, superpuesto al arte. Para darle identidad a tu servidor:

1. Convierte el minimap_frame.ozt a .png.
2. En el editor de imagen, redibuja el borde con los colores/logo del servidor, manteniendo las áreas transparentes exactamente donde estaban.
3. Reconviértelo a .ozt y reemplázalo.
4. La posición del panel en la pantalla suele ser fija en el cliente; en clientes que exponen esto, el ajuste queda en un .ini de interfaz — el campo y su existencia varían según season/cliente.

Paso 5 — Validar escala y posicionamiento

Esta es la prueba que separa un minimapa profesional de uno amateur. Nunca confíes solo en la apariencia estática.

1. Entra al mapa con el personaje y abre el minimapa (tecla M o Tab, según la season).
2. Ve hasta un punto de referencia conocido — por ejemplo, la puerta de un NPC — y observa si el marcador del personaje cae exactamente sobre el ícono de ese NPC en el panel.
3. Camina hasta las cuatro esquinas extremas del área navegable y confirma que el marcador llega a los bordes del arte sin "reventar" hacia afuera ni detenerse demasiado pronto.
4. Si el marcador queda consistentemente desplazado en horizontal o vertical, el problema es el encuadre del arte (no cubre 0–255 en los dos ejes). Si queda espejado, es el eje Y invertido.

Errores comunes y soluciones

Lista de verificación de lanzamiento

• Backup de la carpeta original del cliente hecho en _original/
• Arte base creado en proporción 1:1 y alineado a los tiles 0–255
• Todos los .ozj/.ozt convertidos y con tamaño coherente (> 1 KB)
• Índices de archivo coincidiendo con el world correcto de cada mapa
• Íconos de NPCs y portales registrados con coordenadas capturadas vía /pos
• Archivo de definición guardado sin BOM
• Prueba de calibración de las cuatro esquinas aprobada
• El marcador del personaje cae exactamente sobre los puntos de referencia
• Marco personalizado aplicado con transparencia preservada
• Cliente probado en al menos tres mapas diferentes
• Cliente reempaquetado y hash de verificación actualizado

Con el minimapa calibrado y los íconos en su lugar, tu servidor gana una capa de pulido que la mayoría de los competidores ignora. El secreto es siempre tratar el arte como una proyección fiel de la cuadrícula de tiles — cuando la escala está correcta, todo lo demás encaja naturalmente y puedes reaprovechar el mismo proceso para cualquier nuevo mapa personalizado que agregues en el futuro.

Preguntas frecuentes