Mount Files
Each mount is one JSON file in mods/HaporeLab_Mountale/mounts/. What the file says is what the mount does: Mountale never rewrites these files.
- The file name is the mount id: letters, numbers,
_and-, in English by convention (iron_boar.json→ idiron_boar). - The id sets the default permission:
mountale.mount.iron_boar. - The menu lists mounts in alphabetical order of their file names.
Example
{
"DisplayName": "Iron Boar",
"Description": "Stubborn, tusked and armored.",
"Rarity": "Rare",
"SpeedBonus": 85.0,
"Model": "Mountale_IronBoar",
"Scale": 1.0,
"Icon": "Mountale/Icons/IronBoar.png",
"Permission": "mountale.mount.iron_boar",
"MovementConfig": "Mount",
"AnchorX": 0.0,
"AnchorY": 1.2,
"AnchorZ": 0.0
}
Keys
| Key | Description |
|---|---|
DisplayName | Name shown in the menu, the wheel, the cast bar and the chat |
Description | Text under the name in the menu card |
Rarity | Id of a rarity from config.json ▸ Rarities. Sets the menu tab and the color. Defaults to Common |
SpeedBonus | Speed of the mount, as a percentage added to the player's walking speed (see Speed). Defaults to 70 |
Model | Id of a model asset in Server/Models (the name of its .json file). Required |
Scale | Size of the model (1.0 = the asset's size) |
Icon | Icon texture, relative to Common/UI/Custom |
Permission | Permission that unlocks the mount. Defaults to mountale.mount.<id> |
MovementConfig | Rider physics while mounted, from Server/Entity/MovementConfig (vanilla: Mount): jumping, acceleration, falling. Speed comes from SpeedBonus instead |
AnchorX / AnchorY / AnchorZ | Seat position relative to the mount's origin, in blocks. A positive AnchorZ moves the seat back |
Names and descriptions are written here, not in lang/, so they are the same in every language.
Speed
SpeedBonus is added to the player's own speed when walking, running and sprinting, from 0 to 1000. The menu shows it on each mount card.
With the vanilla player movement (5.5 blocks per second running, 7 sprinting):
SpeedBonus | Run speed | Sprint speed |
|---|---|---|
| 40 | 7.7 b/s | 9.8 b/s |
| 65 | 9.08 b/s | 11.55 b/s |
| 70 | 9.35 b/s | 11.9 b/s |
| 75 | 9.63 b/s | 12.25 b/s |
| 80 | 9.9 b/s | 12.6 b/s |
| 90 | 10.45 b/s | 13.3 b/s |
| 95 | 10.73 b/s | 13.65 b/s |
| 100 | 11 b/s | 14 b/s |
For comparison, the vanilla horse runs at 8 b/s and sprints at 13.2 b/s.
Seat Position
AnchorY is the height of the saddle above the ground, in blocks. On the vanilla horse it is 1.6.
- It doesn't scale with
Scale: when you enlarge a mount, multiplyAnchorYby the same factor. The goblin motorbike's seat is at 0.72 blocks at scale 1, so at 1.45× it uses0.72 × 1.45 = 1.04. - The rider doesn't scale. On a model you enlarge, handlebars and footrests have to be placed for the rider at that scale.
AnchorZmoves the seat back (+) or forward (−). The red raptor sits its rider over the hips with0.23.
In Hytale character models, 64 px = 1 block. AnchorY = the height of the model's Saddle-Attachment node above the ground in pixels ÷ 64, times Scale.
Loading Rules
- An invalid file (broken JSON, no
Model, or a name with other characters) is skipped with a console warning; the other mounts still load. - If
mounts/has no.jsonfiles at all, the default mounts are written.
Default Mounts
| File | Rarity | SpeedBonus | Model | Scale | AnchorY |
|---|---|---|---|---|---|
armadillo.json | Common | 40 | Mountale_Armadillo | 1.0 | 1.5 (AnchorZ 0.22) |
tetrabird.json | Common | 65 | Mountale_Tetrabird | 1.2 | 1.46 (AnchorZ 0.27) |
horse.json | Common | 70 | Mountale_Horse | 1.0 | 1.6 |
armored_skeleton_horse.json | Uncommon | 80 | Horse_Skeleton_Armored | 1.0 | 1.58 |
war_wolf.json | Uncommon | 75 | Mountale_WarWolf | 1.4 | 1.79 |
red_raptor.json | Uncommon | 80 | Mountale_RedRaptor | 1.0 | 1.42 (AnchorZ 0.23) |
bengal_tiger.json | Rare | 90 | Mountale_BengalTiger | 1.45 | 1.26 |
sacred_horse.json | Rare | 95 | Mountale_SacredHorse | 1.0 | 1.63 |
caravan_bison.json | Rare | 75 | Mountale_CaravanBison | 1.2 | 2.06 (AnchorZ 0.22) |
goblin_motorbike.json | Legendary | 100 | Mountale_GoblinMotorbike | 1.45 | 1.04 |
spectral_tiger.json | Legendary | 100 | Mountale_SpectralTiger | 1.45 | 1.26 |
ancient_bear.json | Legendary | 90 | Mountale_AncientBear | 1.0 | 1.6 |
To add a mount with your own model, see Custom Mounts.