❖ What is AutoBreeding?

AutoBreeding is a lightweight farming plugin designed to make animal farms feel more natural and less repetitive.

Instead of players having to manually feed every cow, sheep, pig, chicken, goat, fox, bee, or other breedable mob, AutoBreeding scans nearby animals and automatically places them into love mode when the correct conditions are met.

Animals can use nearby food sources such as crops, flowers, bamboo, cactus, fungus, hay blocks, sweet berry bushes, and more depending on the mob.

The plugin is designed to be simple for players, configurable for server owners, and safe for survival servers.


❖ Why Use AutoBreeding?

• Stops players from needing to manually feed every animal
• Makes farms feel more alive and natural
• Keeps survival farming useful without being too overpowered
• Adds configurable mob limits to prevent overpopulation
• Only processes animals when conditions are met
• Works well for SMP, survival, farming, RPG, and economy servers

❖ Main Features

• Automatic Animal Breeding - Animals can automatically enter love mode when the plugin finds valid conditions.
• Nearby Food Source Detection - Mobs can use nearby crops, flowers, bamboo, cactus, fungus, hay blocks, sweet berry bushes, and more.
• Full Breedable Mob Support - Supports a wide range of breedable mobs instead of only basic farm animals.
• Admin GUI - Easily enable or disable mobs through an in-game menu.
• Per-Mob Configuration - Each mob has its own food, taming, consuming, and growth settings.
• Cooldown System - Prevents the same animal being triggered too often.
• Mob Limit Protection - Stops farms from growing out of control.
• Player Nearby Check - Prevents empty loaded chunks from wasting server resources.
• World Whitelist - Choose which worlds AutoBreeding is allowed in.
• Particles and Sounds - Optional heart particles and eating sounds when animals are auto-fed.
• Stats Command - View scan totals, bred animals, skipped animals, and scan time.
• Reload Support - Reload config and restart the breeding task without restarting the server.

❖ Supported Mobs

AutoBreeding supports all major breedable mobs, including:

• Armadillo
• Axolotl
• Bee
• Camel
• Cat
• Chicken
• Cow
• Donkey
• Fox
• Frog
• Goat
• Hoglin
• Horse
• Llama
• Mooshroom Cow
• Mule
• Ocelot
• Panda
• Pig
• Rabbit
• Sheep
• Sniffer
• Strider
• Trader Llama
• Turtle
• Wolf

❖ Food Source System

AutoBreeding supports both block-based and item-based breeding logic.

Block-Based Food Sources

Some mobs use nearby blocks as their food source.

Examples:

• Cow - Wheat crop
• Sheep - Wheat crop
• Goat - Wheat crop
• Pig - Carrots, potatoes, or beetroot
• Chicken - Wheat crop
• Fox - Sweet berry bush
• Bee - Nearby flowers
• Panda - Bamboo
• Camel - Cactus
• Hoglin - Crimson fungus
• Strider - Warped fungus
• Turtle - Seagrass

Item-Based Food Mobs

Some mobs use food items in vanilla Minecraft, not placeable food blocks.

Examples:

• Wolf - Meat items
• Cat - Cod or salmon
• Horse - Golden carrot or golden apple
• Donkey - Golden carrot or golden apple
• Mule - Golden carrot or golden apple
• Axolotl - Tropical fish bucket
• Frog - Slime ball

For these mobs, AutoBreeding can be configured with:

This means the plugin does not try to find an impossible food block such as beef, fish, slime balls, or golden carrots in the world.


❖ Admin GUI

AutoBreeding includes an admin GUI for easy mob management.

Open it with:

The GUI allows you to toggle mobs on or off without manually editing the config every time.

Each mob button can show useful information such as:

• Mob name
• Entity type
• Enabled or disabled status
• Food source settings
• Whether the mob requires a food source
• Whether the mob requires taming
• Whether the food block is consumed
• Whether the food source must be fully grown

This makes it much easier to manage the plugin directly in-game.


❖ Commands

• /ab gui - Opens the AutoBreeding admin GUI.
• /ab menu - Alias for opening the AutoBreeding admin GUI.
• /ab reload - Reloads the config, rebuilds the mob registry, and restarts the breeding task.
• /ab rl - Short alias for /ab reload.
• /ab stats - Shows plugin scan statistics, including animals scanned, skipped, bred, and scan time.
• /ab list - Lists all registered breedable mobs and whether they are enabled or disabled.

❖ Permissions

Players do not need any permission to benefit from automatic breeding.

Only admin commands require permission.

• Allows access to /ab gui
• Allows access to /ab reload
• Allows access to /ab stats
• Allows access to /ab list
• Default: OP

❖ Performance Protection

AutoBreeding includes several safety options to prevent large farms from becoming a problem.

• Cooldowns stop the same animal from being triggered repeatedly.
• Mob limits stop breeding if too many of the same mob are nearby.
• Max breeds per cycle limits how many animals can breed in one scan.
• Player nearby checks prevent empty areas from being processed.
• World whitelist allows you to restrict the plugin to certain worlds only.
• Disabled mobs are skipped early for better performance.

❖ Example Config


❖ Example Mob Config

Cow Example

This means:

• Cows are enabled.
• The plugin looks for nearby wheat crops.
• The wheat crop must be fully grown.
• The crop is reset after being used.
• The mob does not need to be tamed.
• The GUI icon is beef.

Bee Example

This means:

• Bees require a nearby flower.
• Flowers are not consumed.
• Bees do not need to be tamed.
• The GUI icon is honeycomb.

Wolf Example

This means:

• Wolves are enabled.
• Only tamed wolves can be auto-bred.
• The plugin does not search for a food block.
• No food block is consumed.
• The GUI icon is a bone.

❖ Config Option Descriptions

• Enabled - Turns the whole plugin or a specific mob on or off.
• Cooldown-Minutes - How long an animal must wait before being auto-bred again.
• Task-Delay-Ticks - How often the plugin scans for animals.
• Crop-Search-Radius - How far around each animal to search for food blocks.
• Mob-Limit-Radius - Radius used when checking nearby mobs of the same type.
• Mob-Limit - Maximum amount of the same mob allowed nearby before breeding is skipped.
• Max-Breeds-Per-Cycle - Maximum animals that can be bred during one scan.
• Require-Player-Nearby - If true, animals only process when a player is nearby.
• Player-Range - Distance used for the nearby player check.
• Ignore-Named-Animals - If true, named animals are ignored.
• Ignore-Tamed-Animals - If true, tamed animals are ignored globally.
• Particles - Enables or disables heart particles.
• Sound - Enables or disables eating sounds.
• Enabled-Worlds - List of worlds where the plugin is allowed to run.
• Food-Blocks - List of valid food blocks or reference foods for the mob.
• Require-Food-Source - If true, a nearby food block must be found.
• Require-Tamed - If true, the mob must be tamed.
• Consume-Food-Block - If true, the food block is consumed or reset.
• Require-Fully-Grown - If true, crop food sources must be fully grown.
• Icon - Item shown in the admin GUI.

❖ Example World Whitelist

Allow all worlds:

Only allow the main world:

Allow multiple worlds:


❖ Statistics System

Use:

This command shows useful information such as:

• Animals scanned during the last scan
• Animals bred during the last scan
• Last scan duration
• Total animals scanned
• Total animals skipped
• Total animals bred
• Total crops or food blocks used
• Current task delay
• Max breeds per cycle

This is useful for testing, balancing, and checking whether the plugin is actively working.


❖ Recommended Settings

Testing Settings

Use these while testing:

Live Server Settings

Use these for normal survival gameplay:


❖ Current Version

AutoBreeding v1.5.0

This version includes:

• Full plugin structure rebuild
• All major breedable mob support
• Dynamic admin GUI
• Per-mob config options
• Improved reload handling
• Better performance protection
• Stats command
• World whitelist
• Mob limit system
• Player nearby checks
• Particles and sound effects

❖ Download Goals

• ✅ 10 Downloads
• ✅ 50 Downloads
• ✅ 75 Downloads
• ✅ 100 Downloads
• ✅ 150 Downloads
• ✅ 250 Downloads
• 500 Downloads
• 750 Downloads
• 1,000 Downloads
• 2,000 Downloads
• 5,000 Downloads
• 7,500 Downloads
• 10,000 Downloads

❖ To Do / Planned Features

• ✅ Add configuration options
• ✅ Add new mobs
• ✅ Add admin GUI
• ✅ Add stats command
• Add feeding trough system for item-based foods
• Add per-mob cooldown overrides
• Add breed chance percentages
• Add PlaceholderAPI support
• Add more GUI setting controls

❖ Requirements

• Spigot or Paper
• Java 17+
• Minecraft 1.20+ recommended

❖ Support

For support, suggestions, or bug reports, join the Discord server:

https://discord.gg/HxMp5ejvKU

When reporting an issue, please include:

• Your server version
• Your AutoBreeding version
• Any console errors
• Your config section if related
• Steps to reproduce the issue

❖ Disclaimer

• You may not redistribute this plugin as your own.
• You may not sell this plugin.
• You may not decompile or modify the plugin for redistribution.
• You may use the plugin on your own server.