Saltearse al contenido
Hytale Modding Manual

Tablas de Drops

Descripción general

Las tablas de drops definen qué objetos se producen cuando se abre un contenedor, se mata a un NPC o se cosecha un nodo de recursos. El sistema utiliza una estructura recursiva de Container que soporta tres modos de selección: Single (siempre produce un objeto), Choice (elige aleatoriamente un hijo por peso) y Multiple (evalúa todos los hijos). Anidar estos tipos permite crear tablas de botín complejas con drops garantizados y opcionales.

Cómo funcionan las tablas de drops

flowchart TD;
    A[NPC Dies / Block Breaks] --> B[Lookup Drop Table];
    B --> C{Container Type?};


    C -->|"Multiple"| D[Evaluate ALL Children];
    C -->|"Choice"| E[Pick ONE by Weight];
    C -->|"Single"| F[Always Drop This Item];


    D --> G["Child 1: Guaranteed<br>Single → 3x Bone"];
    D --> H["Child 2: Random Loot<br>Choice → Weighted Pool"];


    H --> I{Roll Weights};
    I -->|"Weight: 60"| J["Common:<br>5x Stone"];
    I -->|"Weight: 30"| K["Uncommon:<br>1x Iron"];
    I -->|"Weight: 10"| L["Rare:<br>1x Diamond"];


    G --> M[Final Drops];
    J --> M;
    K --> M;
    L --> M;


    style A fill:darkred,color:white;
    style M fill:darkgreen,color:white;
    style L fill:darkgoldenrod,color:white;

Ejemplo de anidación de contenedores

flowchart TD;
    A[Root: Multiple] --> B["Single<br>1x XP Orb<br>Guaranteed"];
    A --> C["Choice<br>Weighted random"];
    A --> D["Choice<br>Weighted random"];


    C -->|"70%"| E[Nothing];
    C -->|"30%"| F[1x Feather];


    D -->|"90%"| G[Nothing];
    D -->|"10%"| H[1x Rare Egg];


    style B fill:darkgreen,color:white;
    style F fill:steelblue,color:white;
    style H fill:darkgoldenrod,color:white;

Ubicación de archivos

Assets/Server/Drops/
  Items/          (contenedores del mundo: barriles, vasijas, ataúdes)
  NPCs/
    Beast/
    Boss/
    Critter/
    Elemental/
    Flying_Beast/
    Flying_Critter/
    Flying_Wildlife/
    Intelligent/
    Inventory/
  Objectives/
  Plant/
  Rock/
  Wood/

Esquema

Nivel superior

FieldTypeRequiredDefaultDescription
ContainerContainerSí—Nodo contenedor raíz que define la lógica de botín.

Container

FieldTypeRequiredDefaultDescription
Type"Single" | "Multiple" | "Choice" | "Empty"Sí—Modo de selección para este nodo contenedor.
ItemItemEntryNo—El objeto a producir. Solo válido cuando Type es "Single".
ContainersContainer[]No—Contenedores hijos. Usado por los tipos Multiple y Choice.
WeightnumberNo—Peso de probabilidad relativa. Usado por contenedores padre Choice al seleccionar entre hermanos.

Tipos de contenedores

TypeComportamiento
SingleSiempre produce exactamente el objeto definido en Item.
MultipleEvalúa cada contenedor hijo de forma independiente y combina todos los resultados.
ChoiceSelecciona aleatoriamente un contenedor hijo ponderado por el campo Weight de cada hijo.
EmptyNo produce nada. Se usa como opción de “sin drop” ponderada dentro de nodos Choice.

ItemEntry

FieldTypeRequiredDefaultDescription
ItemIdstringSí—ID del objeto a producir.
QuantityMinnumberSí—Tamaño mínimo del stack producido.
QuantityMaxnumberSí—Tamaño máximo del stack producido. La cantidad real se elige uniformemente entre min y max.

Ejemplos

Contenedor del mundo con drops de selección ponderada (Assets/Server/Drops/Items/Barrels.json):

{
  "Container": {
    "Type": "Choice",
    "Containers": [
      {
        "Type": "Choice",
        "Weight": 100,
        "Containers": [
          {
            "Type": "Single",
            "Item": {
              "ItemId": "Plant_Fruit_Apple",
              "QuantityMin": 1,
              "QuantityMax": 1
            }
          }
        ]
      },
      {
        "Type": "Choice",
        "Weight": 25,
        "Containers": [
          {
            "Type": "Single",
            "Item": {
              "ItemId": "Weapon_Arrow_Crude",
              "QuantityMin": 1,
              "QuantityMax": 5
            }
          }
        ]
      },
      {
        "Type": "Empty",
        "Weight": 800
      }
    ]
  }
}

Drop de NPC con múltiples drops garantizados (Assets/Server/Drops/NPCs/Beast/Drop_Bear_Grizzly.json):

{
  "Container": {
    "Type": "Multiple",
    "Containers": [
      {
        "Type": "Choice",
        "Weight": 100,
        "Containers": [
          {
            "Type": "Single",
            "Item": {
              "ItemId": "Ingredient_Hide_Heavy",
              "QuantityMin": 1,
              "QuantityMax": 2
            }
          }
        ]
      },
      {
        "Type": "Choice",
        "Weight": 100,
        "Containers": [
          {
            "Type": "Single",
            "Item": {
              "ItemId": "Food_Wildmeat_Raw",
              "QuantityMin": 2,
              "QuantityMax": 3
            }
          }
        ]
      }
    ]
  }
}

El Multiple raíz asegura que el oso siempre suelte tanto cuero como carne. Cada hijo usa un Choice con peso 100 (la única opción no vacía), haciendo que cada drop individual sea garantizado.

Páginas relacionadas