🌿 Autonomous Wild Breeding & Species Habitats
NOTE
📌 代码仓库源码状态免责声明：本 Wiki 文档反映了代码仓库中的当前源码状态（v1.3.4+26.2）。可能包含领先于 CurseForge 与 Modrinth 公开发布版本的最新未发布提交或开发特性。
📋 System Infobox
| Property | Value |
|---|---|
| Namespace | natural-reproduction |
| Master Toggle | natural-reproduction:enabled (Default: true) |
| Base Breeding Rate | natural-reproduction:rate (Default: 24000 ticks / 1 MC Day) |
| Density Check Radius | 16 blocks horizontal |
| Population Density Cap | natural-reproduction:density_cap (Default: 10 entities) |
| Staggered Evaluation Cycle | (entityId + gameTime) % 100 == 0 |
| Supported Animal Species | 27 vanilla species (All passive livestock, wild beasts, amphibians) |
| Primary Helper Class | AnimalHabitatHelper.java, SpatialBreedingCacheHelper.java |
🎮 Player & Survival Gameplay Workflow
- Environmental Flora Alignment: Animals will only enter Love Mode autonomously if suitable food or habitat blocks exist within a 4-block radius.
- Health & Age Check: Both potential parents must be fully grown adults (
age == 0) and possess healthy vitality (health > maxHealth * 0.5). - Density Cap Safety: If the number of same-species animals within 16 blocks reaches or exceeds
density_cap(default: 10), wild breeding is suppressed to prevent runaway server lag. - Autonomous Love State: When all checks pass, both parents enter Love Mode concurrently with heart particle feedback (
HEART), seeking each other out to mate naturally.
🧮 Mathematical Formalization & Algorithmic Flow
1. Staggered Cycle Distribution
To eliminate tick spikes, autonomous checks do NOT run on every tick. Instead, evaluations are distributed across 100-tick time slices:
$$\text{isEvaluationTick} \iff (\text{entityId} + \text{level.getGameTime()}) \pmod{100} = 0$$
2. Autonomous Breeding Probability
On every evaluation tick ($5\text{ seconds}$), the probability $P_{\text{breed}}$ of an individual animal attempting reproduction is governed by:
$$P_{\text{breed}} = \frac{100}{\text{rate}} \times \text{biomeMultiplier} \times \text{nourishmentMultiplier}$$
- Base rate $= 24,000\text{ ticks} \implies P_{\text{breed}} \approx 0.416%$ per 100 ticks.
- Native Biome bonus $= 2.0\text{x} \implies P_{\text{breed}} \approx 0.833%$.
- Well-Nourished bonus $= 1.25\text{x} \implies P_{\text{breed}} \approx 1.042%$.
[Server Tick Loop]
│
▼
(id + time) % 100 == 0? ──No──► [Fast-Fail Return]
│ Yes
▼
Is Master Enabled & Species Allowed? ──No──► [Abort]
│ Yes
Local Same-Species Density < density_cap (16 blocks)? ──No──► [Abort]
│ Yes
Nearby Food/Habitat Blocks Present (4 blocks)? ──No──► [Abort]
│ Yes
Roll Breeding Probability (P_breed)? ──Fail──► [Abort]
│ Pass
Partner in Range? ──Yes──► [Both Enter Love Mode + Emit Hearts]🐾 Species Habitat Block Trigger Matrix (27 Species)
| Species | Primary Habitat Blocks | Special Environmental Triggers |
|---|---|---|
| Cow & Mooshroom | GRASS_BLOCK, SHORT_GRASS, TALL_GRASS, HAY_BLOCK | Mooshrooms also accept MYCELIUM |
| Sheep | GRASS_BLOCK, SHORT_GRASS, TALL_GRASS, HAY_BLOCK | Prefers un-sheared wool state |
| Pig | MUD, FARMLAND, CARROTS, POTATOES, BEETROOTS | Mud blocks grant +10% love speed |
| Chicken | WHEAT_SEEDS, HAY_BLOCK, SHORT_GRASS, FARMLAND | Rolls for Fertilized Eggs |
| Horse, Donkey, Mule | GRASS_BLOCK, SHORT_GRASS, HAY_BLOCK | Requires open sky clearance |
| Llama & Trader Llama | GRASS_BLOCK, HAY_BLOCK, SAND, GRAVEL | Mountain biomes grant native boost |
| Camel | SAND, RED_SAND, CACTUS, DEAD_BUSH | Desert climate native |
| Wolf | PODZOL, SPRUCE_LEAVES, SNOW_BLOCK, COARSE_DIRT | Variant-specific biome checks |
| Cat & Ocelot | GRASS_BLOCK, JUNGLE_LEAVES, MOSS_BLOCK | Village or Jungle proximity |
| Fox | SWEET_BERRY_BUSH, PODZOL, SNOW_BLOCK | Taiga / Snowy Taiga flora |
| Rabbit | CARROTS, DANDELION, SAND, SNOW | Desert & Tundra adapted |
| Frog | WATER, LILY_PAD, MUD, MANGROVE_ROOTS, DRIPLEAF | Temperature controls variant offspring |
| Turtle | SAND, WATER, SEAGRASS | Beach biome nesting |
| Axolotl | WATER, CLAY, DRIPLEAF | Lush Caves / dark water |
| Goat | STONE, SNOW_BLOCK, PACKED_ICE, POWDER_SNOW | High altitude ($Y \ge 90$) |
| Panda | BAMBOO, BAMBOO_SAPLING | Bamboo Jungle native |
| Polar Bear | ICE, PACKED_ICE, BLUE_ICE, SNOW_BLOCK | Frozen Oceans & Snowy Plains |
| Bee | BEE_NEST, BEEHIVE, FLOWERS | Requires active pollination |
| Armadillo | SAND, RED_SAND, TERRACOTTA, DEAD_BUSH | Savanna & Badlands flora |
| Sniffer | MOSS_BLOCK, TORCHFLOWER, PITCHER_PLANT | Ancient flora enrichment |
| Strider | LAVA, WARPED_NYLIUM, CRIMSON_NYLIUM | Nether lava seas |
| Hoglin | CRIMSON_NYLIUM, CRIMSON_FUNGUS | Crimson Forest native |
💻 Developer & Addon Extension Hooks
Checking Environmental Conditions Programmatically
java
// Check if an entity has valid habitat conditions
boolean canBreed = AnimalHabitatHelper.hasEnvironmentalBreedingConditions(animal, level);Spatial Cache Optimization
java
// SpatialBreedingCacheHelper caches chunk density counts for 100 ticks
int localCount = SpatialBreedingCacheHelper.getDensity(level, animal.blockPosition(), animal.getType());☕ 支持模组开发：如果您喜欢本模组，欢迎前往 Ko-fi 支持作者获取最新开发测试构建！