Animal Breeding
breeding, mutation, and population control plugin for Unturned rocketmod servers
Players can feed wild and domestic animals using customizable interaction methodsβincluding dropping food on the ground, direct hand-feeding with food in hand, or gestures. Animals enter an "In-Love" state, pathfind toward eligible mates, produce offspring, trigger rare genetic mutations, grant experience rewards, and roll custom item drops upon birth. Built with server performance at the forefront, it features configurable proximity density caps to prevent overpopulation lag farms.
π Features
- Multiple Configurable Feeding Methods (
FeedingInteractionMethod):DropItem(Default): Animals detect dropped food items on the ground within a configurable radius, pathfind towards them, play eating animations, consume the item, and enter Love Mode.HitWithItem: Players left-click/punch an animal while holding a configured food item. The plugin intercepts the hit, cancels all damage to the animal, deducts 1 food item from the player, and triggers Love Mode.Gesture: Pointing or punching towards an animal feeds it directly from the player's inventory or hands.All: Enables all feeding methods simultaneously.
- Love Mode & Mating Behavior:
- Fed animals emit visual particle effects (
LoveEffectId), become passive towards players (CalmAnimalsInLoveMode), and actively seek out and pathfind towards compatible mates withinMateSearchRadius.
- Fed animals emit visual particle effects (
- Genetic Mutations:
- Configurable mutation chances per breeding profile to spawn rare animal variants (e.g., Wolf -> Husky, Bear -> Panda, Cat -> Tiger Cub, Crocodilian -> Ancient Dragon, Green Dragon -> Apex Red Dragon).
- Mutations can award bonus XP, trigger distinct visual effects (
MutationEffectId), and broadcast server-wide or personal announcements.
- Custom Drops & Experience Rewards:
- Award server XP directly to the breeder upon successful mating.
- Roll custom item drops upon birth with custom drop chances and quantities (e.g., Milk, Leather, Bones, Snakeskin, Snake Venom, Bamboo, Dragon Scales, and Dragon Eggs).
- Anti-Lag Population Density Caps:
- Local area density limit (
MaxAnimalsInAreawithinDensityCheckRadius, default: max 15 animals per 20m) prevents players from creating massive breeding lag pens. - Optional global server-wide animal cap (
GlobalMaxAnimals).
- Local area density limit (
- Comprehensive Administration Commands:
- Live inspection of animals, density statistics, live cooldown resets, forced love state, live reloading, and radius animal culling.
- Native GGAnimals Mod Support:
- Pre-configured profiles for Vanilla Unturned Animals (
1β7) and all animals from the GGAnimals Workshop Mod (2514838172) (1500β1524).
- Pre-configured profiles for Vanilla Unturned Animals (
β‘ Commands
| Command | Aliases | Syntax | Description |
|---|---|---|---|
/breed info | /abreed info, /animalbreeding info | /breed info | Inspect the animal you are looking at (Profile, Breeding Status, Remaining Cooldown, and Diet). |
/breed list | /abreed list | /breed list | View all active breeding profiles and accepted food items. |
/breed stats | /abreed stats | /breed stats | Display local area animal density and server-wide population stats. |
/breed spawn | /abreed spawn | /breed spawn <animalId> [count] | (Admin) Spawn one or more animals directly at your crosshair. |
/breed resetcooldown | /abreed resetcd | /breed resetcooldown [radius|all] | (Admin) Reset breeding cooldowns for animals in a radius or across the entire server. |
/breed forcelove | /abreed love | /breed forcelove [radius] | (Admin) Force the animal you are looking at (or all nearby animals within [radius]) into Love Mode. |
/breed cull | /abreed cull | /breed cull [radius] | (Admin) Kill / remove animals within a specified radius (default: 20m). |
/breed reload | /abreed reload | /breed reload | (Admin) Reload configuration and breeding profiles live without restarting the server. |
π Permissions
| Permission Node | Type | Description |
|---|---|---|
animalbreeding.command | Player | Allows access to player informational commands (/breed info, /breed list, /breed stats). |
animalbreeding.breed | Player | Required to feed and breed animals when RequirePermissionToBreed is set to true in config (Default: false). |
animalbreeding.admin | Admin | Grants access to all administrative commands (spawn, resetcooldown, forcelove, cull, reload). |
animalbreeding.admin.spawn | Admin | Allows using /breed spawn. |
animalbreeding.admin.resetcooldown | Admin | Allows using /breed resetcooldown. |
animalbreeding.admin.forcelove | Admin | Allows using /breed forcelove. |
animalbreeding.admin.cull | Admin | Allows using /breed cull. |
animalbreeding.admin.reload | Admin | Allows using /breed reload. |
βοΈ Configuration (AnimalBreeding.configuration.xml)
Located in your server's Rocket/Plugins/AnimalBreeding/AnimalBreeding.configuration.xml directory:
<?xml version="1.0" encoding="utf-8"?>
<AnimalBreedingConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<!-- Chat icon displayed next to in-game messages -->
<ChatIconUrl>https://www.unturnedforge.com/favicon.ico</ChatIconUrl>
<!-- Feeding method: DropItem, HitWithItem, Gesture, or All -->
<FeedingInteractionMethod>DropItem</FeedingInteractionMethod>
<!-- Require "animalbreeding.breed" permission node to feed animals -->
<RequirePermissionToBreed>false</RequirePermissionToBreed>
<!-- Radius (in meters) around animals to search for dropped food items on the ground -->
<FoodDetectionRadius>6</FoodDetectionRadius>
<!-- Maximum distance (in meters) for hand-feeding via HitWithItem or Gesture -->
<HandFeedMaxDistance>4.5</HandFeedMaxDistance>
<!-- Duration (in seconds) an animal stays in Love Mode searching for a mate -->
<LoveModeDurationSeconds>45</LoveModeDurationSeconds>
<!-- Distance between two In-Love animals required to mate -->
<MatingProximityRadius>3.5</MatingProximityRadius>
<!-- Search radius for an In-Love animal to find and walk towards a partner -->
<MateSearchRadius>20</MateSearchRadius>
<!-- Default cooldown (in seconds) before parents can breed again -->
<DefaultBreedingCooldownSeconds>180</DefaultBreedingCooldownSeconds>
<!-- Population & anti-lag density settings -->
<EnablePopulationDensityCap>true</EnablePopulationDensityCap>
<MaxAnimalsInArea>15</MaxAnimalsInArea>
<DensityCheckRadius>20</DensityCheckRadius>
<GlobalMaxAnimals>0</GlobalMaxAnimals>
<!-- Stop aggressive animals from attacking players while in Love Mode -->
<CalmAnimalsInLoveMode>true</CalmAnimalsInLoveMode>
<!-- Visual particle effect IDs -->
<LoveEffectId>123</LoveEffectId>
<BirthEffectId>126</BirthEffectId>
<MutationEffectId>132</MutationEffectId>
<LoveEffectRepeatIntervalSeconds>3</LoveEffectRepeatIntervalSeconds>
<!-- Animal Breeding Profiles -->
<BreedingProfiles>
<!-- Example Vanilla Profile: Cows -->
<Profile Name="Cow" Enabled="true">
<AnimalIds>
<AnimalId>6</AnimalId>
</AnimalIds>
<FoodItemIds>
<ItemId>342</ItemId> <!-- Wheat -->
<ItemId>336</ItemId> <!-- Corn -->
<ItemId>338</ItemId> <!-- Lettuce -->
</FoodItemIds>
<OffspringAnimalIds>
<AnimalId>6</AnimalId>
</OffspringAnimalIds>
<MinOffspring>1</MinOffspring>
<MaxOffspring>2</MaxOffspring>
<CooldownSeconds>180</CooldownSeconds>
<ExperienceReward>25</ExperienceReward>
<Mutations />
<CustomDrops>
<Drop ItemId="462" ChancePercent="35" MinAmount="1" MaxAmount="1" /> <!-- Milk Box -->
<Drop ItemId="515" ChancePercent="25" MinAmount="1" MaxAmount="2" /> <!-- Leather -->
</CustomDrops>
</Profile>
<!-- Example Workshop Profile: Cats with Rare Tiger Mutation -->
<Profile Name="Cats" Enabled="true">
<AnimalIds>
<AnimalId>1500</AnimalId>
<AnimalId>1501</AnimalId>
<AnimalId>1502</AnimalId>
<AnimalId>1503</AnimalId>
<AnimalId>1504</AnimalId>
</AnimalIds>
<FoodItemIds>
<ItemId>504</ItemId> <!-- Trout -->
<ItemId>505</ItemId> <!-- Salmon -->
<ItemId>1347</ItemId> <!-- Minnow -->
<ItemId>462</ItemId> <!-- Milk -->
<ItemId>18600</ItemId><!-- Raw Small Meat -->
</FoodItemIds>
<OffspringAnimalIds>
<AnimalId>1500</AnimalId>
<AnimalId>1501</AnimalId>
<AnimalId>1502</AnimalId>
<AnimalId>1503</AnimalId>
<AnimalId>1504</AnimalId>
</OffspringAnimalIds>
<MinOffspring>1</MinOffspring>
<MaxOffspring>3</MaxOffspring>
<CooldownSeconds>150</CooldownSeconds>
<ExperienceReward>30</ExperienceReward>
<Mutations>
<Mutation Name="Tiger Cub Mutation" OffspringAnimalId="1517" ChancePercent="3.5" BonusExperience="150" AnnounceInChat="true" />
</Mutations>
<CustomDrops />
</Profile>
</BreedingProfiles>
</AnimalBreedingConfiguration>
π Localization (Translations)
Customize in-game chat messages in Rocket/Plugins/AnimalBreeding/AnimalBreeding.en.translation.xml:
| Key | Default Text |
|---|---|
animal_fed_love | <color=#75ff19>You fed the {0}!</color> It is now in love and searching for a mate. |
already_in_love | <color=#ffcc00>This {0} is already in love</color> and looking for a mate. |
on_cooldown | <color=#ff6b6b>This {0} cannot breed yet.</color> Cooldown remaining: <color=#ffffff>{1}s</color>. |
love_expired | <color=#ffcc00>Your {0} could not find a mate in time</color> and is no longer in love. |
breeding_success | <color=#75ff19>Breeding successful!</color> Spawned <color=#ffffff>{0}x {1}</color> (+<color=#19d4ff>{2} XP</color>). |
mutation_broadcast | <color=#ff66ff>[Rare Mutation]</color> <color=#ffffff>{0}</color> triggered <color=#ffea00>{1}</color> and bred a <color=#75ff19>{2}</color>! |
mutation_personal | <color=#ff66ff>[Rare Mutation]</color> You triggered <color=#ffea00>{0}</color> and bred a <color=#75ff19>{1}</color>! |
custom_drop_obtained | <color=#19d4ff>Bonus Drop:</color> The breeding animals produced <color=#ffffff>{0}x {1}</color>! |
area_density_limit | <color=#ff3c19>Overpopulation Limit:</color> Too many animals nearby (<color=#ffffff>{0}/{1}</color> within {2}m). |
global_population_limit | <color=#ff3c19>Server Animal Cap Reached:</color> Maximum of {0} animals are already alive on the map. |
missing_food_item | <color=#ffcc00>{0} requires food to breed:</color> {1}. |
no_permission | <color=#ff3c19>You do not have permission to perform this action.</color> |
π Powered by UnturnedForge
Developed for high performance Unturned servers. Visit UnturnedForge for additional plugins, updates, and community support.
Animal Breeding
Required Workshop
Latest Changes
v1.0.0