NPC's - zerodawnbr/zerodawntoolbox GitHub Wiki

Banner do Mod

badge1 badge2 badge3 badge4 R$ 0,00

🤖 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

  1. O administrador define a posição e características do NPC.
  2. O mod gera o NPC na área definida quando o servidor é iniciado.
  3. 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"]