Skip to main content

Custom Mounts

A mount is just a model plus a mount file. You can use any model from Server/Models, vanilla or your own.

Using a Vanilla Model​

Create mods/HaporeLab_Mountale/mounts/<id>.json pointing to a vanilla model, set the seat position, and run /mountale reload:

{
"DisplayName": "Camel",
"Description": "Slow to anger, hard to tire.",
"Rarity": "Uncommon",
"SpeedBonus": 60.0,
"Model": "Camel",
"Scale": 1.0,
"Icon": "Mountale/Icons/Horse.png",
"MovementConfig": "Mount",
"AnchorX": 0.0,
"AnchorY": 2.25,
"AnchorZ": 0.2
}

Then grant mountale.mount.camel to the players who should have it.

Seat position of vanilla mounts

Creatures that are rideable in vanilla already define their seat in their tamed role (Server/NPC/Roles/Creature/Livestock/Tamed/) as MountAnchorX, MountAnchorY and MountAnchorZ. Copy those values into AnchorX, AnchorY and AnchorZ. The camel above uses the ones from Tamed_Camel.json.

Making Your Own Model​

Mountale's own mounts are modeled in Blockbench with the official Hytale plugin (hytale_character format: 64 px = 1 block, only cubes and quads).

1. Model and animate​

Export the model (.blockymodel) and its animations (.blockyanim). Cover at least the movement animations: Idle, Walk, Run, and ideally WalkBackward, Jump, Fall and Swim, like the vanilla horse.

The rider doesn't follow your animations

The rider stays fixed on the seat anchor. If an animation raises, tilts or lowers the seat or the handlebars, the rider's hands and hips come loose. Animate suspensions, wheels, tails and decorations, not the whole body under the saddle.

Reins

A .blockymodel has no skinning: every piece follows a single bone. Keep each rein segment on the bone it lies on, and turn every segment that crosses a joint into a bridge: an unrotated node pivoting at its body-side end, holding the segment. Animate the bridge in each of the mount's animations (rotation and position, plus a shapeStretch on the segment) so it always reaches the head side. Animations move attachment nodes by name, the same way the cosmetic capes' Cape1–Cape3 are animated. Mountale's armadillo, bison and raptor reins work like this.

2. Add the files to an asset pack​

Common/NPC/Mountale/IronBoar/Models/Model.blockymodel
Common/NPC/Mountale/IronBoar/Models/Texture.png
Common/NPC/Mountale/IronBoar/Animations/Idle.blockyanim (Walk, Run, Jump, Fall…)
Common/UI/Custom/Mountale/Icons/IronBoar.png
Server/Models/Mountale/Mountale_IronBoar.json

3. Write the model asset​

Server/Models/Mountale/Mountale_IronBoar.json follows the vanilla Server/Models/Livestock/Horse.json schema:

{
"Model": "NPC/Mountale/IronBoar/Models/Model.blockymodel",
"Texture": "NPC/Mountale/IronBoar/Models/Texture.png",
"EyeHeight": 1.6,
"HitBox": { "Min": { "X": -0.45, "Y": 0, "Z": -0.45 }, "Max": { "X": 0.45, "Y": 1.8, "Z": 0.45 } },
"AnimationSets": {
"Idle": { "Animations": [ { "Animation": "NPC/Mountale/IronBoar/Animations/Idle.blockyanim" } ] },
"Walk": { "Animations": [ { "Animation": "NPC/Mountale/IronBoar/Animations/Walk.blockyanim" } ] },
"Run": { "Animations": [ { "Animation": "NPC/Mountale/IronBoar/Animations/Run.blockyanim" } ] }
}
}

Optional extras:

  • Land animation — If the model defines a Land set, Mountale plays it in the Action slot whenever the mount lands at 4 blocks per second or more, even with fall damage off. The goblin motorbike uses it for its shock absorbers.

  • Particles — "Particles": [{ "SystemId": "...", "TargetNodeName": "<node>" }] attaches a particle system to a node of the model, like the fire of the vanilla Emberwulf or the goblin motorbike's exhaust smoke.

  • Sounds — Each AnimationSets entry accepts a "SoundEventId". The game restarts the sound on every loop of the animation, so a sound as long as the animation plays seamlessly. Set "PreventSoundInterruption": true in the sound event so each sound finishes before the next one starts, as Mountale's own mounts do:

    {
    "Layers": [ { "Files": ["Sounds/Mountale/IronBoar/Run.ogg"] } ],
    "PreventSoundInterruption": true,
    "AudioCategory": "AudioCat_NPC",
    "Parent": "SFX_Attn_Quiet"
    }
Don't use looping sounds

Don't set "Looping": true on a mount's sound events. The mount is removed when the rider gets off, and a looping sound would keep playing forever.

4. Create the mount file​

Create mounts/iron_boar.json with "Model": "Mountale_IronBoar", a Rarity, a SpeedBonus, and AnchorY set to the height of the saddle (see Seat Position).

5. Test on a local server first​

Start a test server before publishing: an invalid asset stops the whole server when assets are validated on startup.

Why every mount uses Empty_Role​

Mounts don't need a role of their own. They all use the vanilla Empty_Role, the same role the game gives the horse while it is ridden. A copy with another name doesn't work: the server only keeps the movement states sent by the rider (walking, running, jumping) when the role is named exactly Empty_Role. With any other name it recalculates them from the NPC's own speed, which is zero, and other players see the mount standing still.

That's why MountRole in config.json must stay Empty_Role.