Pular para o conteúdo
Hytale Modding Manual

Grupos de NPC

Visao Geral

Arquivos de Grupo de NPC definem colecoes nomeadas de IDs de role. Um grupo da um nome unico a um conjunto de roles para que regras de spawn, tabelas de atitude e volumes de supressao possam se referir ao conjunto inteiro sem listar cada role individualmente. IDs de role suportam um sufixo curinga * para corresponder a todos os roles cujo nome comeca com um determinado prefixo.

Localizacao dos Arquivos

Assets/Server/NPC/Groups/**/*.json

Os grupos sao organizados em subdiretorios que espelham a arvore Roles/ (ex: Groups/Creature/Livestock/Chicken.json para o grupo de bando de Chicken, Groups/Birds.json para todos os passaros).

Schema

FieldTypeRequiredDefaultDescricao
IncludeRolesstring[]Sim—Lista de IDs de role a incluir neste grupo. Suporta sufixo curinga * (ex: "Trilobite*" corresponde a todos os roles cujo ID comeca com "Trilobite").

Correspondencia por Curinga

Um * no final de um ID de role corresponde a todos os roles com aquele prefixo. Isso e util para familias de variantes:

{ "IncludeRoles": ["Trilobite*", "Jellyfish*", "Tang*"] }

Isso corresponde a Trilobite, Trilobite_Small, Jellyfish_Blue, etc. sem listar cada variante explicitamente.

Exemplos

Grupo de passaros

{
  "IncludeRoles": [
    "Bluebird",
    "Crow",
    "Finch_Green",
    "Owl_Brown",
    "Owl_Snow",
    "Parrot",
    "Pigeon",
    "Raven",
    "Sparrow",
    "Woodpecker",
    "Duck",
    "Archaeopteryx",
    "Hawk",
    "Pterodactyl",
    "Vulture"
  ]
}

Grupo aquatico (com curingas)

{
  "IncludeRoles": [
    "Eel_Moray",
    "Shark_Hammerhead",
    "Shellfish_Lava",
    "Trilobite*",
    "Whale_Humpback",
    "Bluegill",
    "Frostgill",
    "Minnow",
    "Pike",
    "Piranha_Black",
    "Piranha",
    "Salmon",
    "Snapjaw",
    "Trout_Rainbow",
    "Clownfish",
    "Jellyfish*",
    "Pufferfish",
    "Tang*"
  ]
}

Grupo de especie unica (bando de Chicken)

{
  "IncludeRoles": [
    "Chicken",
    "Chicken_Chick"
  ]
}

Como os Grupos Sao Usados

  • Regras de spawn referenciam IDs de grupo no campo Flock de uma entrada de spawn de NPC para definir quais roles podem aparecer juntos.
  • Arquivos de atitude referenciam IDs de grupo no objeto Groups para definir como um tipo de NPC se sente em relacao a uma categoria inteira (ex: todos os "Predators" sao "Hostile" para animais presa).
  • Volumes de supressao referenciam IDs de grupo em SuppressedGroups para impedir que uma categoria de NPCs spawne em uma area.

Paginas Relacionadas

  • NPC Roles — Arquivos de role individuais listados dentro dos grupos
  • NPC Spawn Rules — Arquivos de spawn que referenciam IDs de grupo via Flock e SuppressedGroups
  • NPC Attitudes — Arquivos de atitude que referenciam IDs de grupo para definicoes de relacionamento