Mounts
Mounts are creatures you can ride. Each mount lives in a Mount Horn: right-click the horn and you sit on your mount right away. 9 mounts ship with the plugin.
The mount module is on by default (modules.mount in config.json). With the module off, Mount Horns do nothing, the “Mounts” tab of the compendium is hidden and /ksmount is not registered. See Configuration.
Summoning and riding
Section titled “Summoning and riding”- Right-click a Mount Horn. The mount appears two blocks next to you and you are placed on it at once (no cast time). Right-click the horn again to get off; the mount disappears.
- A blank horn binds a new mount on its first right-click, named after the type’s
displayName. - In the Pet Compendium (
/kspet, tab “Mounts”) you can summon a mount you own (the window closes so you can ride off) or dismiss it. - Commands (
/ksmount, aliasmount, needsks.pet.user.mount, allowed by default):/ksmount summon <type>: summons and mounts; the horn must be in your inventory./ksmount dismount: gets you off./ksmount list: lists all mount types with ID, name and type.
/kspet mount(or/kspet mounts) opens the older mount list: the mounts you own, the one you rode last first, three per page, with a mount button and a dismount button. Like/ksmount summon, it needs the mount’s horn in your inventory.- One mount can be out at a time, next to one collector pet and one combat pet.
- Mounts cannot be hurt.
See Commands and Permissions for the full syntax.
Controls
Section titled “Controls”| Input | Action |
|---|---|
| Movement keys | Steer the mount like any Hytale mount |
| F (dismount key) | Get off; the mount is removed half a second later |
| Right-click the horn | Get off |
- While you ride, the mount’s
speedis applied to your movement settings: higher values are faster, 1.0 changes nothing. - Forward movement uses the mount’s full speed whether you walk, run, sprint or crouch (crouching does not slow the mount down). Backwards is 65 % and sideways 80 % of that speed.
- Your normal movement speed is restored when you get off.
Drop guard and dismount rules
Section titled “Drop guard and dismount rules”| What happens | Result |
|---|---|
| You press F | You get off; the mount is removed after 0.5 seconds |
Right-click the horn again, /ksmount dismount, dismiss in the compendium | You get off and the mount is removed |
| The horn leaves your inventory (dropped, put into a chest, traded away) | You are dismounted automatically (“Your pet was dismissed because its item was dropped.”) |
| You die | You are dismounted and the mount is removed |
| You change worlds or log out | You are dismounted and the mount is removed at once |
| An admin restores this mount onto a new horn for someone else | Whoever still rides it through an old horn is dismounted |
The drop guard keeps a mount from staying in the world after its horn is gone. When you get off, the mount’s data (level, name) is saved to the pet database.
Multiplayer sync
Section titled “Multiplayer sync”- The plugin uses Hytale’s own mount link between rider and mount, so the server syncs the mount’s position to all players.
- A sync system copies the rider’s movement to the mount every tick, so other players see it walk, run and stand idle with the right animations.
- Leftover mount NPCs are cleaned up: 5 seconds after the server starts every mount and pet NPC left from the last session is removed from all worlds, every 60 seconds mounts that no player is riding any more are removed, and all mounts are removed when the server stops.
Mount types
Section titled “Mount types”mountConfig.mountType decides which NPC role the mount uses:
| Type | NPC role | Behaviour |
|---|---|---|
walk | KS_Mount_Walk_Role | Ground mount. All shipped mounts except the Frostdrache |
fly | KS_Mount_Fly_Role | Walk and fly movement. Flying is still work in progress; riding on the ground is the supported mode in 1.12.1 |
swim | KS_Mount_Swim_Role | Walk and dive movement. No shipped mount uses it |
Speed roles: a mount with a speed other than 1.0 uses a speed variant of its role, named KS_Mount_<Type>_S<speed x 10>_Role (speed 1.4 = KS_Mount_Walk_S14_Role). Walk roles for 1.1 to 3.0 and the fly role for 1.8 ship in the jar; any other speed is generated on server start into mods/kyuubisoft_pets/npc-roles/. If a speed role fails to spawn, the plugin retries once with the base role of the type, so the mount still appears.
Mount settings
Section titled “Mount settings”Each mount type has a mountConfig block in its file (mods/kyuubisoft_pets/pet-types/mount/<id>.json):
| Field | Default | Meaning |
|---|---|---|
mountType | "walk" | walk, fly or swim (see above) |
mountYOffset | 2.5 | Seat height of the rider above the mount, in blocks |
speed | 1.5 | Movement speed while riding; also picks the speed role |
baseHealth | 200 | Added to the mount NPC’s health. Mounts are invulnerable, so it has no effect in 1.12.1 |
modelScale in the same file sets the size of the model. More fields: Custom Pets Guide.
Levels and stats
Section titled “Levels and stats”- Mounts have a level and a maximum level (shown in the compendium together with their speed), but no XP source feeds a mount in 1.12.1. Only admins change a mount’s level (
/kspetadmin setlevel,addxp,maxoutor the admin window). - A mount bound by right-clicking a blank horn has no stats. Mounts created by an admin roll stats like a collector pet of their rarity, but mount stats give no buffs: a mount never takes one of the two buff slots. The compendium’s reroll dice use Pet scrolls for mounts.
Mount Horns
Section titled “Mount Horns”- Every mount has its own horn item (
Mount_Horn_..., see the table below). Horns do not stack. - The horn is the proof of ownership: you can only summon the mount while its horn is in your inventory, and trading the horn trades the mount. The horn stores only the mount’s ID; the rest is in the pet database (
pets.db). - Horns are never dropped when you die, in every death mode (see Collector Pets). With
maxPetsEverywhere: true, a blank horn does not bind a new mount while all your pet slots are used. A lost horn can be replaced by an admin with/kspetadmin restore; older copies then become void (item generations, see Collector Pets).
All mounts (9)
Section titled “All mounts (9)”Names are the displayName of each pet type file and ship in German. Server owners can rename them by changing displayName (see Custom Pets Guide).
| Mount | ID | Rarity | Horn item | Model | Type | Speed | Seat height | Max level |
|---|---|---|---|---|---|---|---|---|
| Frostdrache | dragon_mount | Legendary | Mount_Horn_Dragon | Dragon_Frost | fly | 1.8 | 5.2 | 50 |
| Hoehlen-Rex | rex_cave_mount | Epic | Mount_Horn_Rex_Cave | Rex_Cave | walk | 1.5 | 3.5 | 40 |
| Saebeltiger | sabertooth_mount | Epic | Mount_Horn_Sabertooth | Tiger_Sabertooth | walk | 1.6 | 1.8 | 30 |
| Bison | bison_mount | Rare | Mount_Horn_Bison | Bison | walk | 1.1 | 2.2 | 30 |
| Eisbaer | bear_polar_mount | Rare | Mount_Horn_Bear_Polar | Bear_Polar | walk | 1.0 | 2.0 | 35 |
| Elch | moose_mount | Rare | Mount_Horn_Moose | Moose_Bull | walk | 1.3 | 2.5 | 30 |
| Kamel | camel_mount | Uncommon | Mount_Horn_Camel | Camel | walk | 1.3 | 2.7 | 30 |
| Pferd | horse_mount | Uncommon | Mount_Horn_Horse | Horse | walk | 1.4 | 1.8 | 30 |
| Reitwolf | wolf_mount | Uncommon | Mount_Horn_Wolf | Wolf_Black | walk | 1.4 | 1.2 | 30 |
Seat height = mountYOffset. The ID is what you type in /ksmount summon <type> and /kspetadmin give <player> <type>.