Saltearse al contenido
Hytale Modding Manual

Reglas de aparición de NPCs

Descripción general

Los archivos de reglas de aparición vinculan roles de NPC con ubicaciones y condiciones del mundo. El sistema tiene tres mecanismos de aparición: las apariciones por baliza gestionan puntos de aparición dinámicos vinculados a etiquetas de entorno con controles de ciclo de vida; las apariciones del mundo son tablas más simples vinculadas a etiquetas de entorno y ventanas de hora del día opcionales; las apariciones por marcador se colocan directamente en el mundo y referencian nombres específicos de NPC con temporizadores de reaparición.

Ubicación de archivos

  • Assets/Server/NPC/Spawn/Beacons/**/*.json — Apariciones impulsadas por balizas
  • Assets/Server/NPC/Spawn/World/**/*.json — Apariciones del entorno del mundo
  • Assets/Server/NPC/Spawn/Markers/**/*.json — Apariciones por marcador colocado
  • Assets/Server/NPC/Spawn/Suppression/**/*.json — Volúmenes de supresión de aparición

Cómo funciona la aparición de NPCs

flowchart TD;
    A[World Loads Chunk] --> B{Check Spawn Sources};


    B --> C[Beacon Spawns];
    B --> D[World Spawns];
    B --> E[Marker Spawns];


    C --> F["Environment<br>Matches?"];
    F -->|"Yes"| G["Player in<br>Range?"];
    F -->|"No"| Z[Skip];
    G -->|"Yes"| H["Light Level<br>OK?"];
    G -->|"No"| Z;
    H -->|"Yes"| I[Select NPC by Weight];
    H -->|"No"| Z;


    D --> J["Environment<br>Matches?"];
    J -->|"Yes"| K["DayTimeRange<br>OK?"];
    J -->|"No"| Z;
    K -->|"Yes"| L[Select NPC by Weight];
    K -->|"No"| Z;


    E --> M["Player Near<br>Marker?"];
    M -->|"Yes"| N["Respawn Timer<br>Ready?"];
    M -->|"No"| Z;
    N -->|"Yes"| O[Spawn Specific NPC];
    N -->|"No"| Z;


    I --> P["MaxSpawnedNPCs<br>Reached?"];
    P -->|"No"| Q[Spawn NPC];
    P -->|"Yes"| Z;
    L --> Q;
    O --> Q;


    Q --> R["Flock<br>Defined?"];
    R -->|"Yes"| S["Spawn Group<br>Size: min-max"];
    R -->|"No"| T[Spawn Single NPC];


    style A fill:darkgreen,color:white;
    style Q fill:rebeccapurple,color:white;
    style Z fill:darkred,color:white;

Zonas de supresión

flowchart LR;
    A["NPC Tries to Spawn"] --> B["Inside Suppression<br>Volume?"];
    B -->|"No"| C[Spawn Allowed];
    B -->|"Yes"| D["NPC Group in<br>SuppressedGroups?"];
    D -->|"No"| C;
    D -->|"Yes"| E[Spawn Blocked];


    style C fill:darkgreen,color:white;
    style E fill:darkred,color:white;

Esquema

Aparición por baliza

FieldTypeRequiredDefaultDescripción
Environmentsstring[]Sí—IDs de etiquetas de entorno donde esta baliza está activa.
NPCsarraySí—Lista de entradas de NPC (ver tabla de entradas de NPC abajo).
MinDistanceFromPlayernumberNo—Distancia mínima del jugador para aparecer, en bloques.
MaxSpawnedNPCsnumberNo—Máximo de NPCs vivos que esta baliza mantendrá.
ConcurrentSpawnsRange[number, number]No—Min/max de NPCs a aparecer en un solo evento de aparición.
SpawnAfterGameTimeRange[string, string]No—Rango de duración ISO 8601 antes de la primera aparición (p.ej. ["PT20M", "PT40M"]).
NPCIdleDespawnTimenumberNo—Segundos que un NPC inactivo persiste antes de desaparecer.
BeaconVacantDespawnGameTimestringNo—Duración ISO 8601 — cuánto tiempo espera una baliza vacante antes de desaparecer.
BeaconRadiusnumberNo—Radio del área gestionada por la baliza, en bloques.
SpawnRadiusnumberNo—Radio dentro del cual se aparecen los NPCs, en bloques.
TargetDistanceFromPlayernumberNo—Distancia ideal de aparición desde el jugador.
LightRangesobjectNo—Restricciones de nivel de luz del bloque, p.ej. { "Light": [0, 2] }.

Aparición del mundo

FieldTypeRequiredDefaultDescripción
Environmentsstring[]Sí—IDs de etiquetas de entorno donde esta tabla de aparición está activa.
NPCsarraySí—Lista de entradas de NPC (ver tabla de entradas de NPC abajo).
DayTimeRange[number, number]No—Rango de horas del juego cuando la aparición está permitida, p.ej. [6, 18] para solo durante el día.

Aparición por marcador

FieldTypeRequiredDefaultDescripción
ModelstringSí—El ID del modelo del marcador (típicamente "NPC_Spawn_Marker").
NPCsarraySí—Lista de entradas de NPC (ver tabla de entradas de NPC abajo).
ExclusionRadiusnumberNo—Otros marcadores dentro de este radio no aparecerán también, en bloques.
RealtimeRespawnbooleanNofalseSi es true, los NPCs reaparecen con un temporizador en tiempo real.
MaxDropHeightnumberNo—Distancia máxima sobre el suelo donde se puede colocar al NPC.
DeactivationDistancenumberNo—Distancia del jugador a la que este marcador deja de simular, en bloques.

Volumen de supresión

FieldTypeRequiredDefaultDescripción
SuppressionRadiusnumberSí—Radio de la zona de supresión, en bloques.
SuppressedGroupsstring[]Sí—IDs de grupos de NPC suprimidos dentro de esta zona (p.ej. ["Aggressive", "Passive"]).
SuppressSpawnMarkersbooleanNofalseSi es true, también suprime marcadores de aparición dentro de la zona.

Entrada de NPC (usada en el arreglo NPCs)

FieldTypeRequiredDefaultDescripción
Id / NamestringSí—ID de rol del NPC a aparecer. Las balizas usan Id; los marcadores usan Name.
WeightnumberNo—Peso relativo de aparición al seleccionar entre múltiples candidatos.
Flockstring | objectNo—ID de grupo de manada (string) o especificación de tamaño de manada en línea { "Size": [min, max] }.
SpawnBlockSetstringNo—Etiqueta del conjunto de bloques sobre el que el NPC debe aparecer (p.ej. "Volcanic", "Portals_Oasis_Soil").
SpawnFluidTagstringNo—Etiqueta de fluido requerida cerca del punto de aparición (p.ej. "Water").
RealtimeRespawnTimenumberNo—Segundos antes de que este NPC reaparezca (apariciones por marcador).
SpawnAfterGameTimestringNo—Duración ISO 8601 antes de que esta entrada sea elegible (p.ej. "P1D").

Ejemplos

Aparición por baliza (goblins de cueva)

{
  "Environments": ["Env_Zone1_Caves_Goblins"],
  "MinDistanceFromPlayer": 15,
  "MaxSpawnedNPCs": 3,
  "ConcurrentSpawnsRange": [1, 2],
  "SpawnAfterGameTimeRange": ["PT20M", "PT40M"],
  "NPCIdleDespawnTime": 60,
  "BeaconVacantDespawnGameTime": "PT15M",
  "BeaconRadius": 50,
  "SpawnRadius": 40,
  "TargetDistanceFromPlayer": 25,
  "NPCs": [
    { "Weight": 60, "SpawnBlockSet": "Volcanic", "Id": "Goblin_Scrapper" },
    { "Weight": 20, "SpawnBlockSet": "Volcanic", "Id": "Goblin_Lobber" },
    { "Weight": 20, "SpawnBlockSet": "Volcanic", "Id": "Goblin_Miner" }
  ],
  "LightRanges": {
    "Light": [0, 2]
  }
}

Aparición del mundo (animales de oasis, solo de día)

{
  "Environments": ["Env_Portals_Oasis"],
  "NPCs": [
    {
      "Weight": 15,
      "SpawnBlockSet": "Portals_Oasis_Soil",
      "SpawnFluidTag": "Water",
      "Id": "Flamingo",
      "Flock": "Group_Small"
    },
    {
      "Weight": 10,
      "SpawnBlockSet": "Portals_Oasis_Soil",
      "Id": "Tortoise"
    }
  ],
  "DayTimeRange": [6, 18]
}

Aparición por marcador (oso, reaparición en tiempo real)

{
  "Model": "NPC_Spawn_Marker",
  "NPCs": [
    {
      "Name": "Bear_Grizzly",
      "Weight": 100,
      "RealtimeRespawnTime": 420
    }
  ],
  "ExclusionRadius": 20,
  "RealtimeRespawn": true,
  "MaxDropHeight": 4,
  "DeactivationDistance": 150
}

Volumen de supresión

{
  "SuppressionRadius": 45,
  "SuppressedGroups": ["Aggressive", "Passive", "Neutral"],
  "SuppressSpawnMarkers": true
}

Páginas relacionadas

  • Roles de NPC — Archivos de rol referenciados por Id / Name en las entradas de aparición
  • Grupos de NPC — IDs de grupo usados en Flock y supresión
  • Actitudes de NPC — Cómo los NPCs aparecidos se relacionan entre sí