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.
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 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.
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:
-
Landanimation — If the model defines aLandset, Mountale plays it in theActionslot 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
AnimationSetsentry 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": truein 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 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.