PMA Persistent Model Assignment

PMA (Asignación de Modelo Persistente) es un plugin ligero del lado del servidor para Hytale que recuerda y reaplica automáticamente los modelos de avatar de los jugadores cuando se reconectan al servidor.

Una vez que un jugador establece un modelo utilizando el comando incorporado de Hytale /model set, PMA detecta el comando del registro del servidor, guarda el modelo elegido (y la escala opcional) y lo reaplica cada vez que el jugador se une, sin necesidad de mods del cliente.

✨ Características

✅ Persistencia automática del modelo
Los modelos de los jugadores se restauran al iniciar sesión sin necesidad de volver a ejecutar comandos
📏 Soporte de escala
Soporta valores de --scale, incluyendo:
- --scale 0.5
- --scale=0.5
- --scale .5
🔓 Soporte para omitir límites de escala
Los jugadores deben incluir --bypassScaleLimits al establecer una escala.
Sin esta bandera, Hytale impone límites de escala muy pequeños, y los cambios pueden ser sutiles o imperceptibles.
💾 Almacenamiento persistente
Las asignaciones de modelos se guardan en el disco y sobreviven a los reinicios del servidor
🔁 Sistema de reintento seguro
Los modelos se aplican solo una vez que la entidad del jugador está completamente inicializada
⚙️ Solo del lado del servidor
Sin mods del cliente, sin paquetes, sin sobrescrituras de comandos

🛠 Cómo Funciona

PMA sigue el registro del servidor en tiempo real
Cuando un jugador ejecuta:

/model set <model> [player] --scale <value> --bypassScaleLimits

PMA captura el ID del modelo y la escala de la salida del registro
La asignación del modelo se guarda por jugador
Al iniciar sesión, PMA:
- Espera a que la entidad del jugador se vuelva válida
- Aplica el modelo y la escala guardados directamente a la entidad
- Persiste la asignación utilizando el componente PersistentModel de Hytale

📁 Almacenamiento de Datos

Las asignaciones de modelos se almacenan en:

PMAData/models.properties

Formato:

username=modelAssetId|scale

Ejemplo:

John_Doe=feran|0.25

(Las entradas sin una escala se establecen automáticamente en 1.0.)

⚠️ Notas y Consejos

PMA no reemplaza ni modifica el comando /model
Siempre incluye --bypassScaleLimits al usar --scale para asegurar que el cambio sea notable
El plugin se basa en la salida estándar del registro del servidor
Destinado a modelos de avatar de jugadores (entidades no estáticas)