Skip to main content

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 → id iron_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​

KeyDescription
DisplayNameName shown in the menu, the wheel, the cast bar and the chat
DescriptionText under the name in the menu card
RarityId of a rarity from config.json ▸ Rarities. Sets the menu tab and the color. Defaults to Common
SpeedBonusSpeed of the mount, as a percentage added to the player's walking speed (see Speed). Defaults to 70
ModelId of a model asset in Server/Models (the name of its .json file). Required
ScaleSize of the model (1.0 = the asset's size)
IconIcon texture, relative to Common/UI/Custom
PermissionPermission that unlocks the mount. Defaults to mountale.mount.<id>
MovementConfigRider physics while mounted, from Server/Entity/MovementConfig (vanilla: Mount): jumping, acceleration, falling. Speed comes from SpeedBonus instead
AnchorX / AnchorY / AnchorZSeat 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):

SpeedBonusRun speedSprint speed
407.7 b/s9.8 b/s
659.08 b/s11.55 b/s
709.35 b/s11.9 b/s
759.63 b/s12.25 b/s
809.9 b/s12.6 b/s
9010.45 b/s13.3 b/s
9510.73 b/s13.65 b/s
10011 b/s14 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, multiply AnchorY by the same factor. The goblin motorbike's seat is at 0.72 blocks at scale 1, so at 1.45× it uses 0.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.
  • AnchorZ moves the seat back (+) or forward (−). The red raptor sits its rider over the hips with 0.23.
Finding AnchorY for a Blockbench model

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 .json files at all, the default mounts are written.

Default Mounts​

FileRaritySpeedBonusModelScaleAnchorY
armadillo.jsonCommon40Mountale_Armadillo1.01.5 (AnchorZ 0.22)
tetrabird.jsonCommon65Mountale_Tetrabird1.21.46 (AnchorZ 0.27)
horse.jsonCommon70Mountale_Horse1.01.6
armored_skeleton_horse.jsonUncommon80Horse_Skeleton_Armored1.01.58
war_wolf.jsonUncommon75Mountale_WarWolf1.41.79
red_raptor.jsonUncommon80Mountale_RedRaptor1.01.42 (AnchorZ 0.23)
bengal_tiger.jsonRare90Mountale_BengalTiger1.451.26
sacred_horse.jsonRare95Mountale_SacredHorse1.01.63
caravan_bison.jsonRare75Mountale_CaravanBison1.22.06 (AnchorZ 0.22)
goblin_motorbike.jsonLegendary100Mountale_GoblinMotorbike1.451.04
spectral_tiger.jsonLegendary100Mountale_SpectralTiger1.451.26
ancient_bear.jsonLegendary90Mountale_AncientBear1.01.6

To add a mount with your own model, see Custom Mounts.