Saltearse al contenido
Hytale Modding Manual

Herencia y Plantillas

Descripción general

El sistema de configuración de Hytale utiliza un modelo de herencia de plantillas. En lugar de definir cada campo para cada entidad, creas plantillas base con propiedades compartidas y luego las extiendes con sobrecargas específicas. Este patrón aparece en roles de NPCs, objetos, configuraciones de juego y tipos de daño.

Cómo funciona la herencia

flowchart TD;
    A["Base Template<br>Template_Beasts_Passive"] --> B[Chicken Role];
    A --> C[Rabbit Role];
    A --> D[Sheep Role];
    B -->|"Reference + Modify"| E["Chicken<br>HP: 15, Speed: 1.2<br>Drops: Feathers"];
    C -->|"Reference + Modify"| F["Rabbit<br>HP: 10, Speed: 2.0<br>Drops: Rabbit Hide"];
    D -->|"Reference + Modify"| G["Sheep<br>HP: 20, Speed: 1.0<br>Drops: Wool"];
    H[Shared from Template] --> I[AI: Passive Wander];
    H --> J[Flee when attacked];
    H --> K[Sensing range: 10];
    H --> L[Sound reactions];
    style A fill:rebeccapurple,color:white;
    style E fill:darkgreen,color:white;
    style F fill:darkgreen,color:white;
    style G fill:darkgreen,color:white;
    style H fill:steelblue,color:white;

Orden de resolución

flowchart LR;
    A["Role File<br>Chicken.json"] -->|"1. Read Reference"| B["Template File<br>Template_Beasts_Passive"];
    B -->|"2. Load Base"| C["Full Template<br>All fields defined"];
    C -->|"3. Apply Modify"| D["Override<br>Appearance, Stats,<br>Drops, Speed"];
    D -->|"4. Result"| E["Final NPC Definition<br>Template + Overrides"];
    style A fill:darkgoldenrod,color:white;
    style E fill:darkgreen,color:white;

Mecanismos de herencia

Reference + Modify (Roles de NPC)

El patrón más común para NPCs. El campo Reference apunta a una plantilla, y Modify sobrescribe campos específicos:

{
  "Reference": "Template_Beasts_Passive_Critter",
  "Modify": {
    "Appearance": "Chicken",
    "MaxHealth": 10,
    "MaxSpeed": 3.0,
    "DropList": "Drop_Chicken",
    "NameTranslationKey": "server.npc.chicken.name"
  }
}

El NPC resultante hereda todas las propiedades de Template_Beasts_Passive_Critter (comportamiento de IA, rango de visión, audición, patrones de manada, etc.) y solo sobrescribe los cinco campos listados en Modify.

Parent (Objetos, Configuraciones)

Los objetos y configuraciones de juego usan un campo Parent para herencia de un solo nivel:

{
  "Parent": "Template_Food",
  "TranslationProperties": {
    "Name": "server.items.food_bread.name",
    "Description": "server.items.food_bread.description"
  },
  "Quality": "Uncommon",
  "Recipe": {
    "Input": [{ "ItemId": "Ingredient_Dough", "Quantity": 1 }],
    "Output": [{ "ItemId": "Food_Bread", "Quantity": 1 }],
    "BenchRequirement": { "Type": "Processing", "Id": "Cookingbench" },
    "TimeSeconds": 8
  }
}

Inherits (Tipos de daño)

Los tipos de daño usan Inherits para jerarquías de clasificación:

{
  "Inherits": "Physical"
}

Esto crea una cadena: Bludgeoning hereda de Physical, que hereda del tipo base Damage.

Tipo Variant

Algunos archivos de NPC usan "Type": "Variant" para definir múltiples variaciones de la misma entidad base:

{
  "Type": "Variant",
  "Reference": "Template_Livestock_Cow",
  "Modify": {
    "Appearance": "Cow_Brown"
  }
}

Parameters y Compute

Las plantillas pueden definir parámetros con valores predeterminados, que las entidades concretas pueden sobrescribir:

{
  "Parameters": {
    "BaseHealth": {
      "Value": 100,
      "Description": "Base health for this NPC tier"
    },
    "SpeedMultiplier": {
      "Value": 1.0,
      "Description": "Movement speed modifier"
    }
  },
  "MaxHealth": { "Compute": "BaseHealth" },
  "MaxSpeed": { "Compute": "4.0 * SpeedMultiplier" }
}

Una entidad hija sobrescribe los parámetros para cambiar los valores calculados sin redefinir las fórmulas.

Jerarquía de plantillas

Las plantillas se organizan típicamente en directorios _Core/Templates/:

Server/NPC/Roles/
├── _Core/
│   └── Templates/
│       ├── Template_Beasts_Passive_Critter.json
│       ├── Template_Beasts_Hostile.json
│       ├── Template_Livestock_Cow.json
│       └── Template_Intelligent_Villager.json
├── Critter/
│   ├── Chicken.json          (References Template_Beasts_Passive_Critter)
│   └── Rabbit.json           (References Template_Beasts_Passive_Critter)
└── Beast/
    ├── Bear_Grizzly.json     (References Template_Beasts_Hostile)
    └── Wolf.json             (References Template_Beasts_Hostile)

Mejores prácticas

  • Siempre referencia una plantilla al crear nuevas entidades — no definas cada campo desde cero
  • Solo sobrescribe lo que sea diferente — mantén los bloques Modify pequeños
  • Usa Parameters para ajustes — facilita el balanceo sin tocar las fórmulas
  • Revisa la plantilla primero — lee el archivo de plantilla para entender qué valores predeterminados heredas

Páginas relacionadas