Cómo crear un mod para Hytale: guía práctica completa

Hytale está revolucionando el modding gracias a su colaboración con CurseForge. Después de dos semanas de experimentar con el sistema de modificaciones, comparto soluciones reales y errores comunes.

Arquitectura del modding: tres niveles de profundidad

Packs (Assets) — empieza en 15 minutos

Ideal para artistas y diseñadores. Trabajo con JSON y editores visuales sin escribir una sola línea de código.

Plugins — para desarrolladores

Desarrollo en Java de sistemas completos de juego. Requiere conocimiento de OOP y arquitectura de servidor.

Bootstrap — modding hardcore

Modificación a nivel JVM para cambios del sistema. Similar a ASM / Mixin de Minecraft Forge.

Práctica: creando un cristal brillante

Paso 1. Manifiesto del objeto

Ruta:

./AppData/Roaming/Hytale/UserData/Packs/CrystalMod/Server/Item/Items/glowing_crystal.json

{
  "TranslationProperties": {
    "Name": "server.Glowing_Crystal.name"
  },
  "MaxStack": 64,
  "Icon": "Icons/ItemsGenerated/Glowing_Crystal.png",
  "Categories": ["Blocks.Minerals"],
  "PlayerAnimationsId": "Block",
  "Set": "Crystal_Luminous",
  "BlockType": {
    "Material": "Solid",
    "DrawType": "Cube",
    "Group": "Crystal",
    "Flags": {
      "EmitsLight": true
    },
    "Gathering": {
      "Breaking": {
        "GatherType": "Minerals",
        "ItemId": "Crystal_Luminous_Shard",
        "ToolRequired": "Pickaxe"
      }
    },
    "BlockParticleSetId": "Crystal",
    "Textures": [
      {
        "All": "BlockTextures/Glowing_Crystal_Texture.png"
      }
    ],
    "ParticleColor": "#4d9fff",
    "LightEmission": 12,
    "BlockSoundSetId": "Glass",
    "BlockBreakingDecalId": "Breaking_Decals_Crystal"
  },
  "ResourceTypes": [
    {
      "Id": "Crystal"
    }
  ]
}

Nuevas funciones:

• EmitsLight — el bloque emite luz
• LightEmission — nivel de luz (0–15)
• ToolRequired — herramienta necesaria
• ItemId — objeto que cae

Paso 2. Gráficos y localización

Textura (32x32):

Common/BlockTextures/Glowing_Crystal_Texture.png

Usa el canal alfa para un brillo suave.

Localización RU:

Glowing_Crystal.name = Светящийся кристалл

Localización EN:

Glowing_Crystal.name = Luminous Crystal

Paso 3. Asset Editor

1. Worlds
2. Clic derecho → Manage Packs
3. Activar el mod
4. En el juego: ~ /asseteditor

• Hardness
• Blast Resistance
• Collision Box

Categorización avanzada

Plugin Java: sistema de teletransporte

• JDK 25
• IntelliJ IDEA
• Gradle 8+

Errores comunes

• Ruta incorrecta de texturas
• JSON inválido
• LightEmission no es número

Optimización

• Texturas hasta 512x512
• Usar atlas
• Cachear objetos
• Async para tareas pesadas

Checklist

• Texturas PNG
• JSON válido
• Traducciones en-US
• Prueba en singleplayer
• Prueba en servidor
• README

Conclusión

Hytale combina la simplicidad de JSON con el poder de Java. Empieza con Packs y luego pasa a plugins para crear mecánicas únicas.