language.yml

Language Configuration

The language.yml file controls all player-facing text inside BetterHorses.

This includes:

• Command messages
• Horse item names
• Horse lore
• Trait names
• Trait activation messages
• Training progress displays
• Cooldown messages
• Debug output (/horse info)

This file is fully customizable and supports:

• MiniMessage formatting
• PlaceholderAPI placeholders
• Built-in BetterHorses placeholders

---

File Structure

The file is split into several sections:

• prefix → Global plugin prefix
• messages → General messages and command feedback
• horse-info → Debug formatting for /horse info
• traits → Trait names and trait activation messages
• training-lore → Training lore formatting and progress bars

---

Prefix

The prefix is added to most plugin messages.

Example:

prefix: "&7[&6BetterHorses&7] "

Output:

[BetterHorses] Your horse has been despawned.

You can completely customize this.

---

Messages Section

The messages: section contains all standard plugin messages.

Example:

horse-despawned: "Your %mount% has been successfully despawned."

This allows full customization of wording.

Examples:

horse-despawned: "Your loyal %mount% has returned to your inventory."
cant-spawn: "You cannot summon your %mount% here."

---

Horse Item Display

BetterHorses uses the language file for horse item names and lore.

Example:

horse-item-name: "<gold>%name% %gender%</gold>"
lore-speed: "Speed: %value%"
lore-jump: "Jump: %value%"
lore-health: "Health: %value% / %max%"

This means you can fully redesign the horse item appearance.

Example:

horse-item-name: "<gradient:gold:yellow>%name%</gradient> %gender%"
lore-speed: "<gray>⚡ Speed:</gray> <white>%value%</white>"
lore-jump: "<gray>⬆ Jump:</gray> <white>%value%</white>"
lore-health: "<gray>❤ Health:</gray> <red>%value%</red>/<dark_red>%max%</dark_red>"

---

Trait Names & Messages

Traits can be renamed here.

Example:

traits:
  hellmare: "Hellmare"
  dashboost: "Dash Boost"

You can rename them:

traits:
  hellmare: "Infernal Steed"
  dashboost: "Burst Sprint"

Trait activation messages can also be customized:

dashboost-message: "Dash Boost activated!"

---

Training Lore

This controls the horse training progress display.

Example:

training-lore:
  title: "&6Training"

Progress bar customization:

progress-bar:
  filled-char: "■"
  empty-char: "■"
  filled-color: "&b"
  empty-color: "&8"

You can completely redesign this.

Example:

filled-char: "▰"
empty-char: "▱"
filled-color: "&a"
empty-color: "&7"

Result:

▰▰▰▱▱▱▱▱

---

Horse Info Debug

The /horse info command is fully customizable.

There are multiple debug views:

• Item debug
• Mounted horse debug
• No target message

Example:

horse-info:
  mounted-horse:
    - "&eHealth: &f%health%"
    - "&eSpeed: &f%speed%"

You can add or remove lines as you like.

---

MiniMessage Integration

BetterHorses fully supports MiniMessage formatting.

This allows advanced formatting far beyond normal & color codes.

Example:

horse-item-name: "<gold>%name%</gold>"

---

MiniMessage Examples

Colors

"<red>Red Text</red>"
"<gold>Gold Text</gold>"
"<green>Green Text</green>"

---

Gradients

"<gradient:red:gold>Legendary Horse</gradient>"

Result:

Smooth gradient text.

---

Rainbow

"<rainbow>Epic Horse</rainbow>"

---

Decorations

"<bold>Bold</bold>"
"<italic>Italic</italic>"
"<underlined>Underlined</underlined>"
"<strikethrough>Striked</strikethrough>"

---

Combined formatting

"<bold><gradient:gold:yellow>%name%</gradient></bold>"

---

Hover text

"<hover:show_text:'A mighty horse'>%name%</hover>"

Hovering over the text shows additional info.

---

Click events

"<click:run_command:'/horse info'>Click here</click>"

Clicking executes a command.

---

MiniMessage can be used in all messages.

This allows highly advanced UI customization.

---

PlaceholderAPI Integration

BetterHorses supports PlaceholderAPI.

This allows you to inject placeholders from:

• Other plugins
• Economy plugins
• LuckPerms
• Player stats
• Custom PlaceholderAPI expansions

Example:

horse-item-name: "<gold>%player_name%'s Horse</gold>"

Result:

Luis's Horse

---

PlaceholderAPI Examples

Player name

%player_name%

---

Player health

%player_health%

---

Economy balance

%vault_eco_balance%

---

LuckPerms prefix

%luckperms_prefix%

---

Playtime

%statistic_hours_played%

---

Combined example:

horse-item-name: "<gold>%player_name%'s %name%</gold>"

---

BetterHorses Built-in Placeholders

BetterHorses has many built-in placeholders:

Placeholder	Description
%name%	Horse name
%gender%	Horse gender
%mount%	Horse type
%trait%	Current trait
%speed%	Speed value
%jump%	Jump value
%health%	Current health
%max%	Maximum health
%growth_stage%	Growth progress
%owner%	Horse owner
%neutered%	Neutered state

These can be used everywhere where supported.

---

Notes

• You can use both & color codes and MiniMessage together.
• MiniMessage is recommended for modern formatting.
• PlaceholderAPI placeholders work only if PlaceholderAPI is installed.
• Invalid placeholders will simply display as raw text.
• Incorrect MiniMessage syntax may break formatting.