Mounts+

Overview

Mounts+ is a comprehensive rideable mounts system for Hytale servers. Players can obtain mounts through admin commands or by finding mount eggs in mob drops. Mounts can be ridden using Hytale's native mounting system and include features like storage, health management, and respawn cooldowns.

Important: This is a server-only plugin. Singleplayer is not supported and no support will be provided for it.

Core features

• Mount collection – Add any entity as a configurable mount type (Horse, Wolf, Bear, Dragon, T-Rex, etc.)
• Mount eggs – Automatically generated egg items for all mount types that admins can add to mob loot tables
• Mount redemption – Players redeem eggs using /mounts redeem while holding the egg to add a mount
• Rideable mounts – Players can mount their active mount using Hytale's native mounting system (default key: F)
• Stationary behavior – Mounts stay in place when not ridden; despawn if player moves >15 blocks away
• Storage system – Configurable storage size per mount type (0, 9, 18, 27, 54 slots)
• Health & invulnerability – Base health per mount type with optional invulnerability toggle
• Respawn cooldown – Configurable cooldown in seconds before mount can be respawned after death
• Rarity system – Rarity levels (Common, Uncommon, Rare, Epic, Legendary) for organization
• Per-mount permissions – Optional permission system to restrict mount usage per type

Player experience

• Mount list – View mounts, spawn/despawn, rename, see mount details
• Mount storage – Access mount inventory when mounted (if storage size > 0)
• Mount transfer – Give a mount to another player (if enabled in config)
• Mount details – View mount type, rarity, and configuration info

Admin features

• Admin UI – Enter player name, select mount by config key, add mounts with one click
• /mounts create – Admin-only command and UI to create and edit mount types
• Loot table integration – Add mount eggs to any mob's loot table for players to find
• Configurable spawn offset, mount Y offset, storage size, health, and more per mount type

Installation

1. Place the Mounts+ JAR file into your Hytale server's plugins or mods folder.
2. Extract assets.zip – Mounts+ requires extracted assets. Running the game from assets.zip will corrupt the file and prevent the mod from loading.
   • Extract assets.zip → make sure the game uses the Assets folder → reinstall Mounts+.
   • (Optional: delete assets.zip after extraction.)
3. Restart the server to generate the default configuration files.
4. Edit config.json in the plugin data folder to add mount types and configure settings.
5. Use /mounts admin (with the appropriate permission) or /mounts add <player> <mount_type> to give mounts to players.

Egg generation

By default, Mounts+ generates egg item files in Assets/Server/Item/Items/. If you don't want these files created automatically, set "generateEggItems": false in config.json.

Player commands

• /mounts – Open the mount management UI.
  Permission: none.
• /mounts redeem – Redeem a mount egg (hold egg in hand).
  Permission: none.
• /mounts transfer <playerName> <mountId> – Transfer one of your mounts to another player.
  Permission: owner only (if allowTransfer is enabled).

Admin commands

• /mounts add <player> <mount_type> – Give a mount to a player using the config key (for example Rex_Cave).
  Permission: mounts.admin.
• /mounts admin – Open the admin mount management UI.
  Permission: mounts.admin.
• /mounts create – Open the create/edit mount types UI (admin only).
  Permission: mounts.admin.

How to use mounts

1. Obtain a mount via admin command, admin UI, or by redeeming a mount egg.
2. Open the mount UI with /mounts and select a mount to spawn.
3. Press F (default key) to mount your active mount using Hytale's native mounting system.
4. While mounted, access mount storage if the mount type has storage configured.
5. Mounts stay stationary when not ridden and despawn if you move more than 15 blocks away.

Adding mount eggs to mob drops

Admins can configure mobs to drop mount eggs by editing entity loot tables. Each mount type automatically generates an egg item with ID: Egg_MountsPlus_<MountType>

Step 1: Locate the entity's loot table

• Navigate to your server's assets directory
• Find the entity's loot table file in Assets\Server\Drops\NPCs\
• The file name typically matches the entity name (e.g. Wolf.json, Bear_Polar.json)

Step 2: Add the egg to loot containers

The loot table uses a Container structure. Add a new Choice container for the mount egg.

Example: Adding a Wolf mount egg to Wolf mob drops:

{
  "Container": {
    "Type": "Multiple",
    "Containers": [
      {
        "Type": "Choice",
        "Weight": 100,
        "Containers": [
          {
            "Type": "Single",
            "Item": {
              "ItemId": "Food_Wildmeat_Raw",
              "QuantityMin": 1,
              "QuantityMax": 1
            }
          }
        ]
      },
      {
        "Type": "Choice",
        "Weight": 50,
        "Containers": [
          {
            "Type": "Single",
            "Item": {
              "ItemId": "Egg_MountsPlus_Wolf",
              "QuantityMin": 1,
              "QuantityMax": 1
            }
          }
        ]
      }
    ]
  }
}

Step 3: Configure drop rates

Each Choice container has a Weight. Drop chance is calculated as: (Container Weight) / (Total Weight of All Containers) × 100%

Recommended weights:

• Common Mounts: Weight 50-100 (higher chance)
• Uncommon Mounts: Weight 25-50 (medium chance)
• Rare Mounts: Weight 10-25 (lower chance)
• Epic/Legendary Mounts: Weight 5-10 (very low chance)

Step 4: Restart server

Loot table changes require a server restart. Test by killing the mob and checking for egg drops.

Step 5: Players redeem eggs

1. Players hold the egg in their hand
2. Run /mounts redeem to add the mount to their collection
3. The egg is consumed and the mount is added

Available egg items

All egg items are automatically generated based on your config.json mount types:

• Format: Egg_MountsPlus_<MountType>
• Example: Egg_MountsPlus_Wolf, Egg_MountsPlus_Bear_Polar, Egg_MountsPlus_Rex_Cave, Egg_MountsPlus_Dragon_Frost
• Location: Server/Item/Items/Egg_MountsPlus_<MountType>.json

Configuration

Key sections in config.json:

mountEntities

Defines each mount type with the following properties:

• entityType – The entity type (e.g. Horse, Wolf_Black, Bear_Polar, Rex_Cave, Dragon_Frost)
• rarity – Rarity level (Common, Uncommon, Rare, Epic, Legendary)
• displayName – Display name for the mount
• spawnOffset – Distance from owner when mount is spawned (prevents clipping for large mounts, e.g. 3.0 for T-Rex)
• defaultScale – Base scale for the mount model (1.0 = normal size)
• mountYOffset – Vertical offset for rider seat position (adjusts based on model height, e.g. 2.5 for T-Rex, 3.2 for dragons)
• storageSize – Number of inventory slots (0, 9, 18, 27, 54)
• invulnerable – Toggle to make mount immune to damage
• baseHealth – Starting health for the mount entity
• respawnCooldownSeconds – Seconds before mount can be respawned after death
• permission – Optional permission node (e.g. mounts.mount.Rex_Cave)

Global settings

• usePerMountPermissions – If true, each mount type's permission node is enforced. Players must have the permission (e.g. mounts.mount.Rex_Cave) to use that mount type.
• allowTransfer – If true, players can transfer mounts to other players using /mounts transfer.
• generateEggItems – If true, automatically generates egg item files for all mount types in Assets/Server/Item/Items/. Set to false if you don't want these files created.

Technical details

• Stationary mounts – Mounts do not follow; they stay in place and despawn if player moves >15 blocks away
• Dynamic Y offset – Mount Y offset is enforced via system to override static JSON values
• Transaction-based inventory – Proper item handling using Hytale's inventory API
• Mount lifecycle management – Automatic despawn on distance, respawn cooldown tracking