Saltearse al contenido
Hytale Modding Manual

Definiciones de Bloques

Descripción General

Las definiciones de bloques describen las propiedades visuales y físicas de los bloques colocados en el mundo. La mayoría de los datos de bloque se encuentran dentro del objeto BlockType de un archivo de definición de objeto, pero existen archivos de bloque independientes para fluidos, efectos de fluidos y calcomanías de rotura. Las texturas pueden especificarse por cara o como un atajo único All, con valores Weight opcionales para variantes aleatorias.

Ubicación del Archivo

Los datos de bloque se almacenan en dos lugares:

  • Bloques integrados en objetos (rocas, madera, tierra, etc.): Objeto BlockType dentro de Assets/Server/Item/Items/<Category>/<ItemId>.json
  • Archivos de bloque independientes (fluidos, calcomanías, efectos de fluidos): Assets/Server/Item/Block/<Subcategory>/<BlockId>.json

Subcategorías bajo Assets/Server/Item/Block/:

Block/Fluids/          — Bloques de fluido (Lava, Agua, Slime, Veneno, Fuego)
Block/BreakingDecals/  — Superposiciones de grietas de animación de rotura
Block/FluidFX/         — Configuraciones de efectos visuales de fluidos
Block/Hitboxes/        — Definiciones de formas de hitbox personalizadas
Block/Blocks/_Debug/   — Bloques de prueba solo para depuración

Esquema

Campos del Objeto de Textura

Cada entrada en el arreglo Textures define una variante de textura. Múltiples entradas con valores Weight permiten la selección aleatoria de texturas.

CampoTipoRequeridoPor DefectoDescripción
AllstringNo—Ruta de textura aplicada a las seis caras del bloque.
SidesstringNo—Textura aplicada a las cuatro caras laterales (Norte, Sur, Este, Oeste).
UpDownstringNo—Textura aplicada a las caras superior e inferior.
TopstringNo—Textura aplicada solo a la cara superior.
BottomstringNo—Textura aplicada solo a la cara inferior.
NorthstringNo—Textura aplicada solo a la cara norte.
SouthstringNo—Textura aplicada solo a la cara sur.
EaststringNo—Textura aplicada solo a la cara este.
WeststringNo—Textura aplicada solo a la cara oeste.
WeightnumberNo1Peso de probabilidad relativa para esta variante cuando hay múltiples entradas de textura presentes.

Campos de BlockType / Nivel de Bloque

CampoTipoRequeridoPor DefectoDescripción
Texturesobject[]No—Arreglo de objetos de variantes de textura (ver arriba).
MaterialstringNo—Categoría de material físico. Valores: Solid, Fluid, Empty, Plant. Controla el comportamiento de colisión e interacción.
DrawTypestringNo—Modo de renderizado. Valores comunes: Model (malla personalizada), Block (cubo estándar), Plant (follaje tipo billboard).
OpacitystringNo—Nivel de transparencia. Valores: Opaque, Semitransparent, Transparent.
LightobjectNo—Configuración de emisión de luz. Contiene Color (cadena hexadecimal, ej. "#e90") y opcionalmente Level (número).
ParticleColorstringNo—Color hexadecimal para los efectos de partículas de rotura de bloque (ej. "#58ad9b").
CustomModelstringNo—Ruta a un archivo .blockymodel usado en lugar de una malla de cubo estándar.
CustomModelTextureobject[]No—Arreglo de { "Texture": "<ruta>", "Weight": <número> } para variantes de textura de modelo personalizado.
CustomModelScalenumberNo1.0Multiplicador de escala para el modelo personalizado.
HitboxTypestringNo—ID de una definición de hitbox de Block/Hitboxes/.
RandomRotationstringNo—Aleatorización de rotación al colocarse. Ejemplo: "YawStep1".
BlockParticleSetIdstringNo—Conjunto de partículas usado para partículas ambientales del bloque (ej. "Lava", "Dust").
BlockSoundSetIdstringNo—ID del conjunto de sonidos para los sonidos de interacción con bloques.
GatheringobjectNo—Configuración de cosecha. Los objetos hijos Harvest, Soft y Breaking aceptan cada uno una cadena GatherType.
Aliasesstring[]No—IDs de cadena alternativos para este bloque, usados por comandos y generación de mundo.

Campos Específicos de Fluidos

Estos campos aparecen en archivos de bloques de fluidos independientes bajo Block/Fluids/.

CampoTipoRequeridoPor DefectoDescripción
MaxFluidLevelnumberNo—Entero de nivel máximo de fluido. Los bloques fuente típicamente usan 1; los fluidos en movimiento usan 8.
Effectstring[]No—Lista de IDs de efecto aplicados cuando una entidad entra en este fluido (ej. ["Lava"]).
FluidFXIdstringNo—Referencia una configuración de efecto visual de fluido de Block/FluidFX/.
TickerobjectNo—Comportamiento de flujo del fluido. Contiene CanDemote (boolean), SpreadFluid (string), FlowRate (number), SupportedBy (string) y Collisions (objeto que mapea IDs de bloque a resultados de colocación).
InteractionsobjectNo—Cadenas de interacción a nivel de bloque (ej. efectos de colisión). Usa el mismo formato de cadena que las interacciones de objetos.
ParentstringNo—ID de un bloque padre del cual heredar campos.

Ejemplo

Assets/Server/Item/Items/Rock/Rock_Aqua.json (sección BlockType):

{
  "TranslationProperties": {
    "Name": "server.items.Rock_Aqua.name"
  },
  "Icon": "Icons/ItemsGenerated/Rock_Aqua.png",
  "Parent": "Rock_Stone",
  "BlockType": {
    "Textures": [
      {
        "All": "BlockTextures/Rock_Aqua.png",
        "Weight": 1
      }
    ],
    "ParticleColor": "#58ad9b",
    "Gathering": {
      "Breaking": {
        "GatherType": "Rocks"
      }
    },
    "Aliases": [
      "aqua",
      "aqua00"
    ]
  }
}

Assets/Server/Item/Block/Blocks/_Debug/Debug_Test_Block.json (bloque independiente con luz):

{
  "Textures": [
    {
      "All": "Blocks/_Debug/Texture.png"
    }
  ],
  "Material": "Solid",
  "Light": {
    "Color": "#f0f"
  }
}

Assets/Server/Item/Block/Fluids/Lava_Source.json (bloque de fluido):

{
  "MaxFluidLevel": 1,
  "Effect": ["Lava"],
  "Opacity": "Transparent",
  "Textures": [
    {
      "Weight": 1,
      "All": "BlockTextures/Fluid_Lava.png"
    }
  ],
  "Light": {
    "Color": "#e90"
  },
  "Ticker": {
    "CanDemote": false,
    "SpreadFluid": "Lava",
    "FlowRate": 2.0,
    "Collisions": {
      "Water": {
        "BlockToPlace": "Rock_Stone_Cobble",
        "SoundEvent": "SFX_Flame_Break"
      }
    }
  }
}

Páginas Relacionadas