PMA Persistent Model Assignment

📦 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&rsquo;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