Cómo Crear NPC Personalizado con Funciones Especiales en el Servidor MU

Qué es un NPC Personalizado y por qué crearlo

En MU Online Season 6, los NPCs (Non-Player Characters) son la columna vertebral de la interacción entre jugadores y el mundo del juego. Desde Balgass en Crywolf hasta los guardias de Lorencia, cada NPC tiene un ID único, coordenadas de mapa, sprite y conjunto de funciones codificadas en el servidor.

Crear un NPC personalizado significa registrar un nuevo personaje — o reutilizar un ID de sprite existente con comportamiento diferente — con funciones definidas por el administrador. Esto abre posibilidades como:

• Portales inteligentes que verifican condiciones antes de teletransportar
• Vendedores con catálogos de ítems exclusivos del servidor
• NPCs de misión que rastrean el progreso por personaje
• Personajes de lore que enriquecen la narrativa del servidor

Esta guía cubre el flujo técnico completo para S6, con énfasis en la precisión — sin atajos que rompan la integridad de los datos del servidor.

Estructura de Datos del NPC en S6

Todo NPC en MU Online S6 está definido por un conjunto de registros interdependientes. Comprender esta estructura es el primer paso antes de cualquier modificación.

Identificación y Sprite

Cada NPC tiene un NPC ID numérico que apunta a su definición visual (sprite/modelo 3D) y su comportamiento base. En S6, los IDs de NPC van de 0 a aproximadamente 500, con rangos reservados para monstruos, personajes de misión y NPCs de servicio.

Estructura básica de registro de NPC:
NPC_ID       → Identificador único (ej: 257 = Chaos Goblin)
SPRITE_ID    → Modelo visual cargado por el cliente
MAP_ID       → Mapa de spawn (ej: 0 = Lorencia, 8 = Tarkan)
COORD_X      → Coordenada X en el mapa (0-255)
COORD_Y      → Coordenada Y en el mapa (0-255)
DIR          → Dirección inicial (0-7, sentido horario desde el norte)
FUNC_TYPE    → Tipo de función (tienda, misión, portal, utilidad)
DIALOG_ID    → ID del conjunto de diálogos vinculado

Para un NPC de misión en Lorencia (MAP_ID 0), las coordenadas típicas se encuentran entre X:130-170, Y:125-155, evitando la superposición con NPCs nativos como Priest Sevina (X:173, Y:164).

Archivo de Configuración Principal

En S6, las definiciones de NPCs personalizados se gestionan en archivos de configuración del servidor (comúnmente .ini, .xml o tablas de base de datos, según la implementación del core). El patrón más común en cores S6 abiertos usa tablas SQL con la siguiente lógica:

Tabla: T_NPC_Info
────────────────────────────────────────────
npc_index    INT   → Índice único del NPC
npc_name     VARCHAR → Nombre mostrado al pasar el cursor
map_number   INT   → ID del mapa de spawn
x_pos        INT   → Posición X
y_pos        INT   → Posición Y
direction    INT   → Dirección (0=N, 2=E, 4=S, 6=O)
func_number  INT   → Código de función interna
attr         INT   → Atributos especiales (bitmask)

Creando el NPC Paso a Paso

Paso 1 — Elección de Sprite e ID

Antes de registrar el NPC, decide si usarás un sprite existente (reutilizando el visual de un NPC nativo sin conflicto de función) o un sprite personalizado añadido al cliente.

Para reutilizar: elige un NPC_ID cuyo sprite sea neutro y no cause confusión — evita IDs de NPCs de quest críticos como Marlon (responsable de la progresión de alas) o el Chaos Goblin.

Para sprite nuevo: el archivo .bmd o .ozg del modelo debe añadirse al directorio correcto del cliente y referenciarse en NpcMesh.bmd antes de cualquier prueba.

Paso 2 — Registro en la Tabla de NPCs

Con el ID y sprite definidos, inserta el registro:

INSERT INTO T_NPC_Info (
  npc_index, npc_name, map_number,
  x_pos, y_pos, direction, func_number, attr
) VALUES (
  9001,           -- ID personalizado (por encima de los nativos)
  'Guardián Arcano',
  0,              -- Lorencia
  145, 140,       -- Coordenadas centrales de Lorencia
  4,              -- Dirección sur (mirando al jugador)
  3,              -- func_number = misión
  0               -- sin atributos especiales
);

Paso 3 — Definición de Diálogos

Los diálogos son el texto que se muestra cuando el jugador interactúa con el NPC. En S6, los diálogos se gestionan en archivos de texto localizados (client-side) o en tablas server-side según el tipo de interacción.

Estructura de diálogo para NPC de misión:
──────────────────────────────────────────
DIALOG_ID: 9001
LINE_01: "Aventurero, para adentrarte en las profundidades de"
LINE_02: "Acheron, deberás demostrar tu valía."
LINE_03: "Tráeme 10 Jewels of Bless y regresa."
OPTION_01: [Aceptar Misión]  → TRIGGER: quest_accept(9001)
OPTION_02: [Salir]           → TRIGGER: dialog_close

Para NPCs con verificación de clase — por ejemplo, restringir el acceso a Blade Masters (DK con 2ª evolución) y Lord Emperors (DL con evolución):

Verificación de clase en el servidor:
IF player.class == BLADE_MASTER OR player.class == LORD_EMPEROR THEN
  → Mostrar diálogo de misión exclusiva
  → stat CMD disponible para DL (verificar CMD >= 200 si es necesario)
ELSE
  → "Solo los guerreros más poderosos pueden consultarme."
  → dialog_close
END IF

Paso 4 — Configuración de Funciones Especiales

Los NPCs con funciones más allá del diálogo simple requieren handlers server-side. Las funciones más comunes en S6:

Portal Condicional:

func_portal {
  destination_map: ACHERON (map_id varía según el core)
  dest_x: 50, dest_y: 50
  require_level: 380
  require_item: JEWEL_OF_CHAOS (1x)
  consume_item: true
  fail_msg: "Nivel insuficiente o ítem ausente."
}

Tienda Personalizada:

func_shop {
  shop_id: 9001
  items: [
    { item_id: LOCH_FEATHER, price_zen: 0, price_jewel_chaos: 5 },
    { item_id: JEWEL_OF_CREATION, price_zen: 5000000, price_jewel_chaos: 0 }
  ]
  note: "Loch's Feather normalmente solo cae de Balgass cuando Crywolf FALLA"
}

Posicionamiento y Pruebas en el Mapa

Elección Estratégica de Ubicación

El posicionamiento de un NPC personalizado impacta directamente en la experiencia del jugador. Recomendaciones por tipo:

Tipo de NPC          → Mapa recomendado        → Motivo
────────────────────────────────────────────────────────────
NPC de misión general → Lorencia (0)           → Hub central, fácil acceso
NPC de misión élite  → Land of Trials          → Acceso ya restringido por nivel
NPC de portal        → Crywolf Fortress        → Contexto de evento de guerra
NPC de crafting      → Noria (2)               → Tradición de crafting en el lore
NPC de información   → Karutan / Vulcanus      → Mapas de alto nivel, contexto

Verificación de Colisión

Antes de finalizar las coordenadas, verifica el mapa de colisión (ATT map) del mapa objetivo. Las celdas con colisión activa impiden el spawn del NPC o lo hacen inaccesible. En S6, los archivos .att definen qué celdas son transitables.

Integración con el Sistema de Misiones del S6

Misiones y Evolución de Clases

El S6 tiene un sistema de evolución de clases basado en misiones (Quests). Al crear NPCs de misión personalizados, es esencial no interferir con el flujo nativo:

Flujo nativo de evolución (referencia):
DK  → Blade Knight (Quest 1) → Blade Master (Quest 2/3)
DW  → Soul Master (Quest 1)  → Grand Master (Quest 2/3)
Elf → Muse Elf (Quest 1)     → High Elf (Quest 2/3)
MG  → Duel Master (sin Quest 1/2 estándar, sin Wing L1)
DL  → Lord Emperor (sin etapa de quest intermedia)
SUM → Bloody Summoner (Q1)   → Dimension Master (Q2/3)

Los NPCs de misión personalizados no deben interferir con los NPCs de quest nativa (Marlon, Chaos Goblin, etc.). Usa IDs de quest separados (superiores a 1000 para misiones personalizadas) y nunca sobrescribas flags de quest nativas en los datos del personaje.

Recompensas Alineadas con la Economía del Servidor

Al definir recompensas para NPCs de misión personalizados, considera la rareza real de los ítems en S6:

• Loch's Feather: ítem raro, obtenido exclusivamente de Balgass cuando el evento Crywolf falla. Los NPCs que otorguen Loch's Feather como recompensa deben exigir un esfuerzo equivalente.
• Jewel of Creation: usado en la creación de Alas Nivel 3 (Wing L3 = Wing L2 + 3x Loch's Feather + Jewel of Creation). Las recompensas de crafting deben reflejar este peso.
• No existe Flame of Condor en S6 — cualquier referencia a este ítem en misiones personalizadas es un error de diseño y confundirá a los jugadores.

Errores Comunes y Cómo Evitarlos

La mayoría de los problemas al crear NPCs personalizados en S6 provienen de errores de registro o conflicto de IDs. Los más frecuentes:

Error                          → Causa probable           → Solución
──────────────────────────────────────────────────────────────────────
NPC no aparece en el mapa      → ID duplicado             → Verificar tabla completa
NPC aparece sin interacción    → func_number incorrecto   → Revisar doc del core
Crash al abrir diálogo         → Dialog_ID no registrado  → Crear entrada en archivo diálogo
Jugador atraviesa el NPC       → Colisión no configurada  → Ajustar ATT map en celda del NPC
Quest no progresa              → Flag de quest conflictiva → Aislar IDs de quest personalizados

Consideraciones Finales

Crear NPCs personalizados es una de las formas más poderosas de personalizar la experiencia en un servidor MU Online S6, pero requiere un conocimiento sólido de la estructura interna del juego. Los principios presentados aquí — registro correcto de IDs, definición de funciones, posicionamiento consciente e integración con el sistema nativo — forman la base para cualquier NPC funcional y estable.

El siguiente paso natural es profundizar en el scripting server-side para crear lógicas de misión más complejas, como misiones en cadena, verificación de guild y eventos temporarios vinculados a NPCs personalizados.

Perguntas frequentes