Introducción¶

Bienvenido a la documentación de desarrollo de plugins y mods para Hytale. Esta guía te ayudará a entender las capacidades de modificación del juego y cómo empezar a crear tus propias extensiones.

¿Qué puedes hacer?¶

Con la API de Hytale puedes:

🔧 Modificación de Comportamiento¶

Transformar bytecode de clases del juego en tiempo de carga
Inyectar código personalizado en métodos existentes
Modificar el comportamiento de sistemas del juego

📦 Almacenamiento de Datos¶

Guardar metadatos asociados a entidades, bloques y otros objetos
Persistir información entre sesiones
Compartir datos entre diferentes componentes

🎮 Interacciones Personalizadas¶

Crear interacciones nuevas con bloques y entidades
Modificar interacciones existentes
Definir efectos y animaciones personalizadas

🌍 Extensión del Servidor¶

Agregar comandos personalizados
Implementar eventos y listeners
Modificar la lógica del servidor

Tipos de Extensiones¶

Early Plugins¶

Los Early Plugins se cargan antes de que el servidor principal inicie. Esto les permite:

Transformar clases antes de que sean cargadas
Modificar el bytecode de las clases del juego
Implementar cambios fundamentales en el comportamiento

Ubicación: earlyplugins/ en la raíz del servidor

server/
├── earlyplugins/
│   ├── mi-plugin.jar
│   └── otro-plugin.jar
└── hytale-server.jar

Standard Plugins¶

Los Standard Plugins se cargan después del servidor y tienen acceso a la API completa del juego.

Características: - Acceso completo a la API - Pueden usar el Meta System - Pueden definir interacciones - Más seguros y estables

Mods¶

Los mods son extensiones que pueden combinar ambos tipos de plugins y agregar contenido nuevo al juego.

Arquitectura General¶

graph TD
    A[Inicio del Servidor] --> B[Cargar Early Plugins]
    B --> C[Transformar Clases]
    C --> D[Iniciar HytaleServer]
    D --> E[Cargar Standard Plugins]
    E --> F[Inicializar Sistemas]
    F --> G[Servidor Listo]

Limitaciones y Consideraciones¶

Importante

Esta API está basada en código descompilado
No es oficialmente soportada por Hypixel Studios
Puede cambiar en cualquier actualización
Usa bajo tu propio riesgo

Seguridad¶

Los Early Plugins requieren confirmación explícita para ejecutarse
La transformación de bytecode puede causar problemas de estabilidad
Siempre prueba en un entorno de desarrollo primero

Rendimiento¶

La transformación de bytecode tiene un costo de rendimiento
Múltiples transformadores pueden afectar el tiempo de inicio
Optimiza tu código para minimizar el impacto

Próximos Pasos¶

Requisitos: Verifica que tienes todo lo necesario
Instalación: Configura tu entorno de desarrollo
Arquitectura: Entiende la estructura interna

¿Tienes preguntas? Consulta nuestra sección de FAQ