Como Criar NPC Customizado com Funções Especiais no Servidor MU

O que é um NPC Customizado e por que criá-lo

No MU Online Season 6, os NPCs (Non-Player Characters) são a espinha dorsal da interação entre jogadores e o mundo do jogo. Desde Balgass em Crywolf até os guardas de Lorencia, cada NPC possui um ID único, coordenadas de mapa, sprite e conjunto de funções codificadas no servidor.

Criar um NPC customizado significa registrar um novo personagem — ou reutilizar um ID de sprite existente com comportamento diferente — com funções definidas pelo administrador. Isso abre possibilidades como:

• Portais inteligentes que verificam condições antes de teletransportar
• Vendedores com catálogos de itens exclusivos do servidor
• NPCs de missão que rastreiam progresso por personagem
• Personagens de lore que enriquecem a narrativa do servidor

Este guia aborda o fluxo técnico completo para S6, com foco em precisão — sem atalhos que quebrem a integridade dos dados do servidor.

Estrutura de Dados do NPC no S6

Todo NPC no MU Online S6 é definido por um conjunto de registros interdependentes. Compreender essa estrutura é o primeiro passo antes de qualquer modificação.

Identificação e Sprite

Cada NPC possui um NPC ID numérico que aponta para sua definição visual (sprite/modelo 3D) e seu comportamento base. No S6, os IDs de NPC vão de 0 a aproximadamente 500, com faixas reservadas para monstros, personagens de missão e NPCs de serviço.

Estrutura básica de registro de NPC:
NPC_ID       → Identificador único (ex: 257 = Chaos Goblin)
SPRITE_ID    → Modelo visual carregado pelo cliente
MAP_ID       → Mapa de spawn (ex: 0 = Lorencia, 8 = Tarkan)
COORD_X      → Coordenada X no mapa (0-255)
COORD_Y      → Coordenada Y no mapa (0-255)
DIR          → Direção inicial (0-7, sentido horário a partir do norte)
FUNC_TYPE    → Tipo de função (loja, missão, portal, utilidade)
DIALOG_ID    → ID do conjunto de diálogos vinculado

Para um NPC de missão em Lorencia (MAP_ID 0), coordenadas típicas ficam entre X:130-170, Y:125-155, evitando sobreposição com NPCs nativos como a Priest Sevina (X:173, Y:164).

Arquivo de Configuração Principal

No S6, as definições de NPCs customizados são gerenciadas em arquivos de configuração do servidor (comumente .ini, .xml ou tabelas de banco de dados, dependendo da implementação do core). O padrão mais comum em cores S6 abertos usa tabelas SQL com a seguinte lógica:

Tabela: T_NPC_Info
────────────────────────────────────────────
npc_index    INT   → Índice único do NPC
npc_name     VARCHAR → Nome exibido no hover
map_number   INT   → ID do mapa de spawn
x_pos        INT   → Posição X
y_pos        INT   → Posição Y
direction    INT   → Direção (0=N, 2=L, 4=S, 6=O)
func_number  INT   → Código de função interna
attr         INT   → Atributos especiais (bitmask)

Criando o NPC Passo a Passo

Passo 1 — Escolha de Sprite e ID

Antes de registrar o NPC, decida se usará um sprite existente (reutilizando o visual de um NPC nativo sem conflito de função) ou um sprite customizado adicionado ao cliente.

Para reutilizar: escolha um NPC_ID cujo sprite seja neutro e não cause confusão — evite IDs de quest NPCs críticos como Marlon (responsável pela progressão de asas) ou o Chaos Goblin.

Para sprite novo: o arquivo .bmd ou .ozg do modelo deve ser adicionado ao diretório correto do cliente e referenciado no NpcMesh.bmd antes de qualquer teste.

Passo 2 — Registro na Tabela de NPCs

Com o ID e sprite definidos, insira o registro:

INSERT INTO T_NPC_Info (
  npc_index, npc_name, map_number,
  x_pos, y_pos, direction, func_number, attr
) VALUES (
  9001,           -- ID customizado (acima dos nativos)
  'Guardião Arcano',
  0,              -- Lorencia
  145, 140,       -- Coordenadas centrais de Lorencia
  4,              -- Direção sul (voltado para o jogador)
  3,              -- func_number = missão
  0               -- sem atributos especiais
);

Passo 3 — Definição de Diálogos

Os diálogos são o texto exibido quando o jogador interage com o NPC. No S6, diálogos são gerenciados em arquivos de texto localizados (client-side) ou em tabelas server-side dependendo do tipo de interação.

Estrutura de diálogo para NPC de missão:
────────────────────────────────────────
DIALOG_ID: 9001
LINE_01: "Aventureiro, para adentrar as profundezas de"
LINE_02: "Acheron, você precisará provar seu valor."
LINE_03: "Traga-me 10 Jewel of Bless e retorne."
OPTION_01: [Aceitar Missão]  → TRIGGER: quest_accept(9001)
OPTION_02: [Sair]            → TRIGGER: dialog_close

Para NPCs com verificação de classe — por exemplo, restringir o acesso a Blade Masters (DK com 2ª evolução) e Lord Emperors (DL com evolução):

Verificação de classe server-side:
IF player.class == BLADE_MASTER OR player.class == LORD_EMPEROR THEN
  → Exibir diálogo de missão exclusiva
  → cmd_stat disponível para DL (verificar CMD >= 200 se necessário)
ELSE
  → "Apenas os mais poderosos guerreiros podem me consultar."
  → dialog_close
END IF

Passo 4 — Configuração de Funções Especiais

NPCs com funções além do diálogo simples requerem handlers server-side. As funções mais comuns no S6:

Portal Condicional:

func_portal {
  destination_map: ACHERON (map_id varia por core)
  dest_x: 50, dest_y: 50
  require_level: 380
  require_item: JEWEL_OF_CHAOS (1x)
  consume_item: true
  fail_msg: "Nível insuficiente ou item ausente."
}

Loja Customizada:

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 só cai com Balgass quando Crywolf FALHA"
}

Posicionamento e Testes no Mapa

Escolha Estratégica de Localização

O posicionamento de um NPC customizado impacta diretamente a experiência do jogador. Recomendações por tipo:

Tipo de NPC         → Mapa recomendado        → Motivo
────────────────────────────────────────────────────────
NPC de missão geral → Lorencia (0)            → Hub central, acesso fácil
NPC de missão elite → Land of Trials          → Acesso já restrito por nível
NPC de portal       → Crywolf Fortress        → Contexto de evento de guerra
NPC de crafting     → Noria (2)               → Tradição de crafting no lore
NPC de informação   → Karutan / Vulcanus      → Mapas de alto nível, contexto

Verificação de Colisão

Antes de finalizar as coordenadas, verifique o mapa de colisão (ATT map) do mapa alvo. Células com colisão ativa impedem o spawn do NPC ou o tornam inacessível. No S6, os arquivos .att definem quais células são passáveis.

Integração com o Sistema de Missões do S6

Missões e Evolução de Classes

O S6 possui um sistema de evolução de classes baseado em missões (Quests). Ao criar NPCs de missão customizados, é essencial não conflitar com o fluxo nativo:

Fluxo nativo de evolução (referência):
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 (sem Quest 1/2 padrão, sem Wing L1)
DL  → Lord Emperor (sem Quest intermediária)
SUM → Bloody Summoner (Q1)   → Dimension Master (Q2/3)

NPCs de missão customizados não devem interferir com os NPCs de quest nativa (Marlon, Chaos Goblin, etc.). Use IDs de quest separados (acima de 1000 para missões customizadas) e nunca sobrescreva flags de quest nativas nos dados do personagem.

Recompensas Alinhadas com a Economia do Servidor

Ao definir recompensas para NPCs de missão customizados, considere a raridade real dos itens no S6:

• Loch's Feather: item raro, obtido exclusivamente de Balgass quando o evento Crywolf falha. NPCs que dão Loch's Feather como recompensa devem exigir esforço equivalente.
• Jewel of Creation: usado na criação de Asas Nível 3 (Wing L3 = Wing L2 + 3x Loch's Feather + Jewel of Creation). Recompensas de crafting devem refletir esse peso.
• Não existe Flame of Condor no S6 — qualquer referência a esse item em missões customizadas é erro de design e confundirá os jogadores.

Erros Comuns e Como Evitá-los

A maioria dos problemas ao criar NPCs customizados no S6 vem de erros de registro ou conflito de IDs. Os mais frequentes:

Erro                          → Causa provável            → Solução
──────────────────────────────────────────────────────────────────────
NPC não aparece no mapa       → ID duplicado              → Verificar tabela completa
NPC aparece sem interação     → func_number errado        → Revisar documentação do core
Crash ao abrir diálogo        → Dialog_ID não registrado  → Criar entrada no arquivo de diálogo
Jogador atravessa o NPC       → Colisão não configurada   → Ajustar ATT map na célula do NPC
Quest não progride            → Flag de quest conflitante → Isolar IDs de quest customizados

Considerações Finais

Criar NPCs customizados é uma das formas mais poderosas de personalizar a experiência em um servidor MU Online S6, mas exige conhecimento sólido da estrutura interna do jogo. Os princípios apresentados aqui — registro correto de IDs, definição de funções, posicionamento consciente e integração com o sistema nativo — formam a base para qualquer NPC funcional e estável.

O próximo passo natural é aprofundar-se em scripting server-side para criar lógicas de missão mais complexas, como missões em cadeia, verificação de guild e eventos temporários vinculados a NPCs customizados.

Perguntas frequentes