NPC's - zerodawnbr/zerodawntoolbox GitHub Wiki

🤖 NPC Estáticos
O mod de NPCs Estáticos permite criar personagens não-jogadores (NPCs) dentro do servidor.
Por enquanto, todos os NPCs são estáticos — ou seja, não se movimentam ou caçam jogadores.
Esse recurso é útil, por exemplo, para traders, NPCs que vendem itens ou interagem de forma fixa com os jogadores.
Ao iniciar pela primeira vez, será criado o arquivo config.json em $profile:/ZeroDawnBRCoreTools/NPC/
📌 Funcionalidades
- ✅ Criação de NPCs: Permite adicionar NPCs em locais específicos do mapa.
- ✅ Estáticos: Os NPCs não se movem e não atacam.
- ✅ Uso em traders: Ideal para criar pontos de comércio ou interação fixa.
- ✅ Customizável: Pode-se definir modelo, posição e inventário do NPC (dependendo da configuração do mod).
💡 Como funciona
- O administrador define a posição e características do NPC.
- O mod gera o NPC na área definida quando o servidor é iniciado.
- Jogadores podem interagir com o NPC (uso futuro).
📂 Arquivo de configuração (config.json)
O arquivo define se os NPCs estão habilitados e todas as informações necessárias para spawnar cada NPC:
{
"config": {
"enableNPC": 1,
"version": "1.0",
"info": "ZeroDawnBR NPCs configuration file. Control spawn and meta info."
},
"npcs": [
{
"name": "BlackMarket",
"model": "SurvivorM_Kaito",
"position": [
12697.9462890625,
244.54078674316407,
12396.4150390625
],
"rotation": [
-143.99990844726563,
0.0,
-0.0
],
"inventory": [
"FAMAS",
"SVD",
"PSO1Optic"
]
}
]
}
⚙️ Explicação dos campos – config.json (NPCs)
Seção config
| Campo | Descrição | Valor Padrão / Exemplo |
|---|---|---|
enableNPC |
Habilita (1) ou desabilita (0) o spawn de NPCs no servidor. | 1 |
version |
Versão do arquivo de configuração do mod. | "1.0" |
info |
Texto informativo sobre o propósito do arquivo. | "ZeroDawnBR NPCs configuration file. Control spawn and meta info." |
Seção npcs
| Campo | Descrição | Exemplo |
|---|---|---|
name |
Nome do NPC para referência interna ou para identificar o local onde o NPC está. | "Inicio" |
model |
Modelo do NPC que deve existir no types.xml. |
"SurvivorM_Kaito" |
position |
Posição XYZ no mapa onde o NPC será spawnado. | [12697.94, 244.54, 12396.41] |
rotation |
Rotação do NPC na hora do spawn, normalmente em Euler angles [x, y, z]. |
[-143.99, 0.0, 0.0] |
inventory |
Lista de itens que o NPC possui (armas, roupas, acessórios, etc.). | ["FAMAS","SVD","PSO1Optic"] |