promotional bannermobile promotional banner

TioBreeding

TioBreeding adds a configurable animal breeding system for Hytale servers. Players use a breeding item on two domesticated animals of the same species to produce a baby. Babies grow into adults over time.

Features

  • Breeding workflow — Activate two parents with a breeding item; they breed when close enough or after both enter breeding mode.
  • Vanilla-style hearts — Love-heart particles appear above parent mobs when breeding mode is activated (same style as feeding animals in vanilla).
  • Baby growth — Babies spawn as domesticated (Tamed_*) and automatically grow into adults after a configurable time.
  • Domestication support — Optionally require parents to be tamed via vanilla Hytale domestication (Tamed_Cow, Tamed_Sheep, etc.).
  • Configurable mob registry — Define which parent mobs can breed and which baby mob ID they produce.
  • Breeding cooldown — Per-mob cooldown after a successful breed.
  • Custom chat messages — Fully editable messages with legacy color codes (&a, &c, &l, etc.) and hex colors (&#55FF55).
  • Bundled breeding item — Includes Concentrated Life Essence (Ingredient_Life_Essence_Concentrated) with a crafting recipe.
  • Admin tools — Reload config without restarting the server; optional debug command for troubleshooting.

Installation

  1. Download TioBreeding-1.2.0.jar (or the latest release).
  2. Place the JAR in your Hytale server's mods folder (next to other server plugins/mods).
  3. Start the server once. The mod will create its configuration folder automatically.
  4. Edit TioBreeding/config.json if you want custom settings (see below).
  5. Restart the server, or run /breed reload (admin) to apply config changes without a full restart.

Note: This mod ships with IncludesAssetPack: true, so the breeding item and its assets are bundled inside the JAR. No separate resource pack install is required on the server.


How Breeding Works

Requirements

  1. Both animals must be listed in allowedMobsRegistry.
  2. If requireDomestication is true (default), both parents must be domesticated in vanilla Hytale (their role must be Tamed_*, e.g. Tamed_Cow).
  3. Neither parent may be on breeding cooldown.
  4. You must hold the configured breeding item in your hand.

Steps

  1. Hold the breeding item (default: Ingredient_Life_Essence_Concentrated).
  2. Look at the first parent and activate breeding:
    • Press F (Use interaction), or
    • Right-click the mob while holding the item.
  3. Hearts appear above the mob. It enters breeding mode for breedingWindowSeconds.
  4. Use the breeding item on the second parent of the same species.
  5. Breeding completes when:
    • Both parents are in breeding mode and within maxBreedingDistance blocks, or
    • Both are in breeding mode and move close enough (automatic pairing via server ticker).
  6. A baby spawns between the two parents, already domesticated, and begins its growth timer.
  7. One breeding item is consumed per successful activation.

Default Breeding Item

Property Value
Item ID Ingredient_Life_Essence_Concentrated
Craft 100× Ingredient_Life_Essence → 1× Concentrated Life Essence
Bench Farming Bench (Essence category)

You can change breedingItemId in the config to any vanilla or mod item ID if you prefer a different item.


Baby Growth

  • Babies spawned by the mod are tracked and grow into their adult parentMobId after babyGrowthTimeGameMinutes (in-game minutes).
  • Growth is checked every growthCheckIntervalSeconds.
  • Naturally spawned domesticated babies (already Tamed_* in the world) are also detected and tracked for growth once domesticated.
  • When growth completes, the baby entity is replaced with the adult version at the same position.

Commands

Command Permission Description
/breed reload Admin (hytale:Admin) Reloads config.json from disk without restarting the server.
/breeddebug Any player Shows diagnostic info about the mob you are looking at (registry match, domestication status, simulated breeding result). Does not consume items.

Server Configuration

Config file location

After the first server start:

<server>/mods/TioBreeding/config.json

On first launch, the mod copies defaults from the bundled config.json inside the JAR. The file is also saved when the server shuts down.

Use /breed reload to apply edits without restarting.

Full config reference

{
  "breedingItemId": "Ingredient_Life_Essence_Concentrated",
  "maxBreedingDistance": 5,
  "breedingWindowSeconds": 15,
  "breedingCooldownMinutes": 10,
  "babyGrowthTimeGameMinutes": 40,
  "growthCheckIntervalSeconds": 30,
  "requireDomestication": true,
  "allowedMobsRegistry": [ ... ],
  "messages": { ... }
}

General settings

Key Type Default Description
breedingItemId string Ingredient_Life_Essence_Concentrated Item ID required in hand to activate breeding.
maxBreedingDistance int 5 Maximum block distance between two parents for breeding to succeed.
breedingWindowSeconds int 15 How long a mob stays in breeding mode after activation.
breedingCooldownMinutes int 10 Cooldown per parent after a successful breed. Set to 0 to disable.
babyGrowthTimeGameMinutes int 40 In-game minutes until a baby grows into an adult.
growthCheckIntervalSeconds int 30 How often the server checks baby growth (and ready breeding pairs).
requireDomestication boolean true If true, parents must have a Tamed_* role. If false, any mob in the registry can breed.

Mob registry (allowedMobsRegistry)

Each entry maps a parent species to its baby mob ID:

{
  "parentMobId": "Cow",
  "babyMobId": "Cow_Calf"
}
  • parentMobId — Adult mob role/type ID (e.g. Cow, Sheep, Pig). Matching is case-insensitive and also works with Tamed_* roles.
  • babyMobId — NPC ID spawned as the offspring.

Default supported species (16):

Parent Baby
Cow Cow_Calf
Sheep Sheep_Lamb
Pig Pig_Piglet
Bison Bison_Calf
Boar Boar_Piglet
Camel Camel_Calf
Goat Goat_Kid
Horse Horse_Foal
Mouflon Mouflon_Lamb
Ram Ram_Lamb
Pig_Wild Pig_Wild_Piglet
Chicken Chicken_Chick
Chicken_Desert Chicken_Desert_Chick
Turkey Turkey_Chick
Skrill Skrill_Chick
Rabbit Bunny

To add a custom mob, append a new entry with the correct Hytale NPC role IDs. Both parents must share the same parentMobId entry.

Chat messages (messages)

Key Placeholders When shown
enabled true / false — toggle all mod chat messages.
defaultColor Fallback hex color (e.g. #CCCCCC) when no & code is used.
breedingActivated {windowSeconds} First parent entered breeding mode.
breedingWaitingApproach {maxDistance} Second parent activated; waiting for parents to get close.
breedingCompleted Baby successfully spawned.
noBreedingItem {breedingItemId}, {heldItem} Wrong or missing item in hand.
notInRegistry Target mob is not in allowedMobsRegistry.
notTamed Mob is not domesticated (when requireDomestication is true).
cooldownActive {cooldown} Parent is on breeding cooldown.
distanceTooFar {maxDistance} Parents too far apart.
spawnFailed Baby NPC failed to spawn.
failed Generic activation failure.
noTargetInView No valid mob in view (F key).
invalidTarget Invalid breeding target.
playerNotFound Internal player lookup failure.
internalError Unexpected server error.

Message color codes

Messages support Minecraft-style formatting:

Code Effect
&0&9, &a&f Legacy colors (e.g. &a = green, &c = red, &e = yellow)
&#RRGGBB Hex color (e.g. &#55FF55)
&l Bold
&o Italic
&r Reset formatting

Example:

"breedingCompleted": "&b&l[TioBreeding] &r&aBaby spawned successfully!"

Tip: Use & directly in your config file. The mod writes configs without escaping & as \u0026.


Example: Minimal custom config

{
  "breedingItemId": "Ingredient_Hay",
  "maxBreedingDistance": 8,
  "breedingWindowSeconds": 30,
  "breedingCooldownMinutes": 5,
  "babyGrowthTimeGameMinutes": 20,
  "growthCheckIntervalSeconds": 15,
  "requireDomestication": true,
  "allowedMobsRegistry": [
    { "parentMobId": "Cow", "babyMobId": "Cow_Calf" },
    { "parentMobId": "Sheep", "babyMobId": "Sheep_Lamb" },
    { "parentMobId": "Pig", "babyMobId": "Pig_Piglet" }
  ],
  "messages": {
    "enabled": true,
    "defaultColor": "#AAAAAA",
    "breedingActivated": "&a[Farm] &fBreeding mode ON! Use the item on the second animal within {windowSeconds}s.",
    "breedingCompleted": "&a[Farm] &fA baby was born!",
    "notTamed": "&c[Farm] &fTame this animal first."
  }
}

After saving, run /breed reload or restart the server.


Troubleshooting

Problem What to check
Nothing happens when using the item Hold the correct breedingItemId. Look directly at the mob. Ensure the mob is in allowedMobsRegistry.
"Not tamed" message Domesticate the animal in vanilla Hytale first, or set requireDomestication to false.
"Cooldown" message Wait for breedingCooldownMinutes to expire on that parent.
Parents won't breed Both must be the same species, both in breeding mode, and within maxBreedingDistance. Check breedingWindowSeconds hasn't expired.
Baby doesn't grow Confirm babyGrowthTimeGameMinutes and growthCheckIntervalSeconds. Baby must be in the registry as a babyMobId.
Config changes ignored Run /breed reload or restart. Edit the file at mods/TioBreeding/config.json, not the copy inside the JAR.
Diagnose a specific mob Run /breeddebug while looking at the animal.

Technical notes

  • Server-only: Players do not need to install anything; the server loads the mod and asset pack.
  • Thread safety: Breeding activation and spawning run on the world thread to avoid desync issues.
  • Pairing ticker: Ready breeding pairs are evaluated on the same interval as baby growth checks (growthCheckIntervalSeconds).
  • Dependencies: None required. Works with ServerVersion:*.

Support

For issues, feature requests, or updated builds, refer to the mod page or project repository linked on CurseForge.


❤️‍🔥 Sponsored by Vanguard Server

Vanguard

Join Vanguard!

Server IP: vanguard.vgh.com.br
Website: https://vgh.com.br
Discord: https://discord.gg/Q53GmaeAyB

The TioBreeding Team

profile avatar
  • 2
    Projects
  • 243
    Downloads

More from TioOdair

  • TioPvPTime project image

    TioPvPTime

    TioPvPTime turns PVP on or off on your server based on in-game day/night time (per world). Players see a small corner icon when PVP is on or off on configured worlds.

    • 196
    • June 21, 2026
  • TioPvPTime project image

    TioPvPTime

    TioPvPTime turns PVP on or off on your server based on in-game day/night time (per world). Players see a small corner icon when PVP is on or off on configured worlds.

    • 196
    • June 21, 2026