mountale-1.0.0.jar
What's new
CHANGELOG Version 1.0.0.jar
First public release of Mountale: summonable mounts for Hytale servers.
Twelve Mounts
- Every mount has its own rarity and its own speed, a bonus over walking speed:
- Common: Saddled Armadillo (+40 %), Saddled Tetrabird (+65 %) and Horse (+70 %).
- Uncommon: Armored Skeleton Horse (+80 %), War Wolf (+75 %) and Red Raptor (+80 %).
- Rare: Bengal Tiger (+90 %), Sacred Horse (+95 %) and Caravan Bison (+75 %).
- Legendary: Goblin Motorbike (+100 %), Spectral Tiger (+100 %) and Ancient Bear (+90 %).
- Each mount has its own saddle, armor, bridle and reins. The Goblin Motorbike has working suspension, exhaust smoke, engine sounds and a wheelie when jumping, and the Sacred Horse, the Spectral Tiger and the Ancient Bear glow with their own auras.
- Mounts use Hytale's own mount system, the same one the vanilla horse uses, so every player sees their animations. They are never saved: a mount vanishes as soon as its rider gets off.
- Every mount is a file in
mounts/<id>.jsonwith its name, description, rarity, speed, model, scale, icon, seat position and permission. You can add your own mounts made in Blockbench.
Summoning
/mountaleopens a menu with the mounts the player has unlocked: a Favorites tab and one tab per rarity, in the style of the 0.7 crafting bench. Each card shows the mount's icon, name, rarity, speed and description, with a Summon button, or Dismount for the mount in use.- Picking a mount starts a 1.5-second cast (
CastTimeSeconds). A HUD bar shows the mount's icon and the time left, the character kneels with a hand on the ground, glows blue, and particles in the rarity color rise around them. - Moving more than 0.3 blocks or taking damage cancels the cast, and the bar turns red with Cancelled.
- The mount appears with a ring of light, rising motes and a cloud of smoke, with the player already in the saddle. When it vanishes, the ring closes and the motes scatter.
- Riders have their own riding animation with a light sway that follows the mount's gait, and take vanilla fall damage on hard landings without being thrown off.
Favorites and Radial Wheel
- Each player can mark up to 4 favorite mounts with the star on the mount cards. They get their own first tab in the menu and are saved per player.
- Holding F for half a second opens a radial wheel with your favorites, so you can summon one without opening the menu. A short tap of F keeps its normal action: opening doors and chests, talking, mounting.
- The center of the wheel opens the full menu.
/mountale wheelopens the wheel from the chat. - The F key can be turned off or switched to tap-to-open with
WheelUseF,WheelOpenOnHoldandWheelHoldSeconds. The wheel works side by side with GroupManager's ping wheel.
Mount Scrolls
- Every mount has a consumable scroll (
Mountale_Scroll_<Mount_Id>, for exampleMountale_Scroll_Red_Raptor). Using it unlocks the mount for good, and it isn't used up if the player can already ride that mount. - Scrolls look like recipe scrolls with the mount's icon in front, with a frame and label in the rarity color. Their names and descriptions follow each player's game language: English, Spanish or Portuguese.
- They are generated on startup for every mount in
mounts/, your own included, so you can hand them out as shop items, loot, quest or event rewards.
Combat and Dismounting
- Hitting or being hit by a player or a creature puts you in combat for 10 seconds (
CombatTimeSeconds), and you can't summon while it lasts. The chat tells you when it starts and ends. Falls and the environment don't count. - Taking damage dismounts the rider (
DismountOnDamage). Hitting a mount counts as hitting its rider, and mounts themselves never take damage. - Fall damage hurts but doesn't dismount by default (
DismountOnFallDamage).
Commands and Permissions
/mountaleopens the mount menu and/mountale wheelthe favorites wheel. Neither needs a permission.- Each mount is unlocked by the permission
mountale.mount.<id>, for examplemountale.mount.horse. - With
mountale.admin:/mountale reloadreloads the configuration, the mounts and the languages without restarting./mountale give <player> <mount> [--amount N]gives mount scrolls./mountale unlock <player> <mount>and/mountale lock <player> <mount>unlock a mount for a player or take it away.
Configuration and Languages
config.jsonsets the cast time and what cancels it, the combat log, the dismount rules, the language and the wheel keys.- Rarities are configurable, with their name, color and icons. Common, Uncommon, Rare and Legendary come by default, and you can add your own.
- Spanish (Paraguay, default), English (US) and Portuguese (Brazil) are included, and any other language can be added by copying a file in
lang/. Edited texts are kept when the plugin updates, and new texts are added automatically.
Developer API
- Other plugins can use the public Java API (
com.mountale.api,MountaleProvider.get()) to see who is riding or summoning, dismount players, cancel a summon, put a player in combat, and unlock or lock mounts. - Summon restrictions let a plugin forbid summoning anywhere it needs, such as arenas, dungeons or claims.
- Listeners receive events when a summon starts or is cancelled, a mount is summoned, a player dismounts, enters or leaves combat, or unlocks a mount.
Notes
- Requires Hytale Server 0.7.7 or later and Java 25.
- On first launch, Mountale creates
mods/HaporeLab_Mountale/withconfig.json, one file per mount inmounts/and the language files inlang/. The default language is Spanish: set"Language": "en-US"inconfig.jsonand run/mountale reloadto switch to English. - The wheel keys and the mount scrolls are set up on startup: a new mount gets its scroll after a server restart, not with
/mountale reload.
For more information, consult the Wiki
All Relations
- All Relations
- Embedded Library
- Optional Dependency
- Required Dependency
- Tool
- Incompatible
- Include