Skip to content
Luis-Dev edited this page Jun 28, 2026 · 1 revision

FAQ

Frequently asked questions about BetterHorses.


General

What is BetterHorses?

BetterHorses expands Minecraft's horse system with improved breeding, stored horse items, traits, training, mount customization, and support for multiple rideable mount types.


Is this plugin open-source?

Yes. You can find the source code here.


Which mount types are supported?

BetterHorses currently supports:

  • Horses
  • Skeleton Horses
  • Zombie Horses
  • Camels
  • Mules
  • Donkeys

Camels are disabled by default and can be enabled in the config.


Feeding & Breeding

Why can't I feed my horse?

This usually happens because the horse recently bred.

By default, female horses have a 5 minute breeding cooldown. During this cooldown, they cannot be fed.

Male horses have no breeding cooldown by default.

You can change this behavior in the config.


Why are my horses not breeding?

Common reasons:

  • Both horses have the same gender
  • One of the horses is neutered
  • One of the horses is still on breeding cooldown
  • Breeding may be restricted by permissions or config settings

By default, same-gender breeding is disabled.


Does the breeding cooldown also decrease when I despawn my horse?

Yes.

The breeding cooldown continues ticking down even if the horse was converted into an item.


Can neutered horses breed?

No.

Once a horse is neutered, it can no longer breed. Neutering is irreversible.


Are traits inherited from the parent horses?

No.

Traits are not inherited from the parents. Every newly bred horse has its own chance to be born with a random trait.


Traits

What are traits?

Traits are genetic mutations that give horses active or passive abilities.

Examples include movement boosts, special effects, passive bonuses, or unique transformation mechanics.

You can learn more about traits here:
https://discord.com/channels/1364565394345562132/1373765593341100062


Why does my horse not have a trait?

Traits are chance-based.

A horse only receives a trait if:

  • Traits are enabled in the config
  • The specific trait is enabled
  • The horse successfully rolls a trait chance during breeding
  • The player has the required permissions, if permissions are configured

Can traits be disabled?

Yes.

You can disable the entire trait system or disable individual traits in the config.


Can players be restricted from using traits?

Yes.

BetterHorses has trait permissions such as:

betterhorses.trait.use
betterhorses.trait.receive
betterhorses.trait.*

Individual traits also have their own permissions.


Horse Size & Stats

Why are my horses so big?

By default, BetterHorses can make fully grown horses up to 30% bigger than vanilla horses.

This can be adjusted in the config:

horse-growth-settings:
  max-size: 1.3

Set it to 1.0 if you want vanilla-sized adult horses.


Can I disable custom horse growth?

Yes.

horse-growth-settings:
  enabled: false

Why do speed and jump values look weird?

By default, Minecraft internally stores horse speed and jump strength as raw values.

BetterHorses can display them in two modes:

stats:
  display-mode: RAW

or:

stats:
  display-mode: BLOCKS

BLOCKS converts speed to blocks per second and jump strength to jump height in blocks.


Horse Items

What is a horse item?

A horse item is an item that stores a horse and its data.

It can include:

  • Type
  • Name
  • Gender
  • Health
  • Speed
  • Jump strength
  • Trait
  • Training progress
  • Owner
  • Armor
  • Texture/model data
image

Can I change the horse item material?

Yes.

settings:
  horse-item: SADDLE

You can replace SADDLE with another valid Bukkit material.


Can horse items have custom textures?

Yes.

BetterHorses supports:

  • CustomModelData
  • Item model
  • CIT string
  • Model string

These can be configured in the settings.texture section.


Can players spawn horses by right-clicking horse items?

Yes, if enabled:

settings:
  allow-rightclick-spawn: true

Players also need the required permission:

betterhorses.spawn.rightclick

Commands & Permissions

Why can’t a player use a BetterHorses command?

They may be missing the required permission.

Common permissions:

betterhorses.spawn.command
betterhorses.despawn
betterhorses.info
betterhorses.neuter
betterhorses.reload
betterhorses.create

Admins can use:

betterhorses.*

Why is /horse info not available?

/horse info is mainly a debug command.

It becomes available when debug mode is enabled:

debug:
  enabled: true

Mount Protection

Can players ride other players' horses?

By default, this depends on your config.

If owner restriction is enabled:

settings:
  restrict-mounting-to-owner: true

only the owner can ride their horse.

Players with the bypass permission may still be able to ride other players' horses:

betterhorses.bypass

Can riders be made invulnerable?

Yes.

settings:
  rider-invulnerable: true

Players also need the related permission if permissions are used:

betterhorses.rider.invincible

Training

What is horse training?

Training allows horses to improve over time through:

  • Riding
  • Brushing
  • Feeding

Each training category can increase a different stat.


Can training be disabled?

Yes.

training:
  enabled: false

Why does training progress not show on horse items?

Check if training lore is enabled:

training:
  lore:
    enabled: true

Also make sure the horse item lore layout includes training entries.


Trample

What is trample?

Trample allows mounted horses to damage and knock back entities they run through.


Why does trample not work?

Check:

  • trample.enabled is set to true
  • The mount type is enabled under trample.mount-types
  • The player has betterhorses.trample
  • The horse is moving fast enough
  • The target type is allowed by affect-players or affect-mobs

Compatibility

Does BetterHorses work on Paper and Spigot?

BetterHorses is designed to support both Paper and Spigot where possible.

Some features may require Paper or newer Minecraft versions, such as custom growth scaling.


Why does a feature work on Paper but not on Spigot?

Some Bukkit/Paper APIs are different.

If a feature depends on newer or Paper-specific API behavior, it may not work the same way on Spigot.

Check the console for errors and make sure you are using a compatible server version.


Troubleshooting

My horse item does not spawn a horse. What can I do?

Check:

  • The item is a valid BetterHorses item
  • Right-click spawning is enabled
  • The player has permission
  • The spawn location is allowed
  • The item data was not manually edited or corrupted

My horse disappeared. What can I do?

If the horse was despawned, it should be stored in the horse item.

If it died, it may be gone permanently unless a trait or feature prevented death.

Use /horse info with debug enabled to inspect horse items.


Should I restart or reload after changing the config?

A restart is safest.

If you use the reload command, make sure the config has no YAML formatting errors.

/horse reload
c32a426d-6cdf-4a62-8ea0-025f5afa7006-removebg-preview


Setup


Features


Commands


Developer API


Clone this wiki locally