📦 PMA – Persistent Model Assignment (Server-Side)

PMA (Persistent Model Assignment) is a lightweight, server-side Hytale plugin that automatically remembers and reapplies player avatar models when they reconnect to the server.

Once a player sets a model using Hytale’s built-in /model set command, PMA detects the command from the server log, saves the chosen model (and optional scale), and reapplies it every time the player joins — no client mods required.

✨ Features

✅ Automatic model persistence
Player models are restored on login without re-running commands
📏 Scale support
Supports --scale values, including:
- --scale 0.5
- --scale=0.5
- --scale .5
🔓 Bypass scale limits support
Players should include --bypassScaleLimits when setting a scale.
Without this flag, Hytale enforces very small scale limits, and changes may be subtle or unnoticeable.
💾 Persistent storage
Model assignments are saved to disk and survive server restarts
🔁 Safe retry system
Models are applied only once the player entity is fully initialized
⚙️ Server-side only
No client mods, no packets, no command overrides

🛠 How It Works

PMA tails the server log in real time
When a player runs:

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

PMA captures the model ID and scale from the log output
The model assignment is saved per player
On login, PMA:
- Waits for the player entity to become valid
- Applies the saved model and scale directly to the entity
- Persists the assignment using Hytale’s PersistentModel component

📁 Data Storage

Model assignments are stored in:

PMAData/models.properties

Format:

username=modelAssetId|scale

Example:

John_Doe=feran|0.25

(Entries without a scale automatically default to 1.0.)

⚠️ Notes & Tips

PMA does not replace or modify the /model command
Always include --bypassScaleLimits when using --scale to ensure the change is noticeable
The plugin relies on standard server log output
Intended for player avatar models (non-static entities)

👤 Ideal For

Roleplay servers
Persistent character customization
Servers that want player models to just stick between sessions

PMA Persistent Model Assignment