TioBreeding

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

Join Vanguard!

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