Hyxin

Hyxin proporciona un entorno Mixin para el juego Hytale. Permite a los desarrolladores modificar, extender e inyectar comportamientos en el código de Hytale sin modificar directamente los archivos del juego.

Características

Mixin es un marco de rasgos/mixins para Java que permite a los desarrolladores de plugins modificar el código del juego sin parchear o modificar directamente los archivos del juego. Esta es una herramienta muy poderosa para los desarrolladores, permitiéndoles añadir hooks, modificar la lógica del juego y empoderándolos para hacer cosas que de otro modo no podrían hacer.

Hyxin proporciona tanto el Fork de Mixin de FabricMC como MixinExtras de LlamaLad7. Los desarrolladores deberían poder utilizar la mayoría de las características añadidas por ambos proyectos, aunque no todo está listo para producción aún.

Advertencia de Acceso Anticipado

El juego Hytale está en acceso anticipado. Las cosas son inestables y propensas a cambios frecuentes. Puede que algunas cosas no funcionen, o que funcionen de maneras inesperadas o subóptimas. Por favor, ten paciencia mientras trabajamos para abordar los problemas.

Problemas Conocidos y Advertencias

Las configuraciones de Mixin solo se pueden cargar desde earlyplugins.
Solo escaneamos la carpeta earlyplugins en el directorio de trabajo para las configuraciones de Hyxin. Se pueden añadir rutas adicionales utilizando argumentos de ejecución, pero aún no podemos escanearlas.
Al desarrollar Hyxin en sí, los archivos se cargan desde el AppClassLoader en lugar del esperado early plugins URLClassLoader.
Los accessors, invokers, inyección de interfaces y características similares no están listas para producción.
La opción DisabledByDefault, junto con la función de plugins desactivados, no está soportada.

Instalando Hyxin

El archivo jar de Hyxin y todos los plugins que utilizan Hyxin deben ir en tu carpeta earlyplugins. Necesitarás crear la carpeta, ya que aún no la crean por ti. En un servidor, deberás crear la carpeta justo al lado de las carpetas de plugins y logs. En modo un jugador, tu plugin debe ir dentro de tu mundo, en la carpeta earlyplugins de los mundos.

Desarrollando con Hyxin

El proyecto Hyxin aún no está disponible en Maven central. Puedes añadirlo a tus dependencias de Gradle manualmente, o usar Cursemaven.

Añade una configuración de Hyxin al archivo manifest.json estándar del plugin. El array Configs define una lista de archivos de configuración de Mixin que Hyxin intentará cargar desde tu archivo jar del plugin.

{
  "Group": "...",
  "Name": "...",
  "Version": "...",
  "Description": "...",
  "Hyxin": {
    "Configs": [
      "your_plugin.mixins.json"
    ]
  }
}

Dentro del archivo your_plugin.mixins.json deberías establecer el nombre del paquete raíz desde el cual se cargan las clases de Mixin, y luego llenar el array mixins con el nombre de cada clase que deseas cargar.

{
  "required": true,
  "minVersion": "0.8",
  "package": "com.example.mixins",
  "mixins": [
    "ExampleMixin"
  ]
}

Luego define tu clase mixin en la ubicación esperada, en este caso es src/main/com/example/mixins/ExampleMixin.java. En este ejemplo, estamos inyectando nuestro método onMain inmediatamente antes de que se invoque EarlyPluginLoaders#hasTransformers en el constructor de HytaleServer.

@Mixin(HytaleServer.class)
public class ExampleMixin {

    @Inject(method = "<init>", at = @At(value = "INVOKE", target = "Lcom/hypixel/hytale/plugin/early/EarlyPluginLoader;hasTransformers()Z"))
    private static void onMain(CallbackInfo ci) {
        HytaleLogger.get("Hyxin-Example").at(Level.INFO).log("¡Hola desde Hyxin! ¡El servidor ha sido parcheado!");
    }
}

Créditos y Agradecimientos

El proyecto Hyxin es desarrollado y mantenido por Darkhax y Jaredlll08. El proyecto Hyxin se basa en Mixin. Un agradecimiento especial a Mumfrey en particular, quien ha dedicado innumerables horas a mantener el proyecto.

Agradecemos mucho todas las obras previas que han hecho posible este proyecto. Todas las marcas registradas, derechos de autor y propiedad permanecen con sus autores originales. La inclusión de estas bibliotecas no implica la aprobación de este proyecto por parte de sus creadores u organizaciones afiliadas.