Animal Genetics Engine

Animal Genetics Engine

Property	Value
Core Package	net.dasik.social.api.genetics
Attachment Identifier	dasik-library:genetics
Scale Bounds	0.1x to 3.0x (Default: 0.5x - 2.0x)
Runt Threshold	Scale $< 0.85x$ (or Inbred)
Giant Threshold	Scale $> 1.15x$
Data Codec	EntityGenetics.CODEC

---

🧬 Overview & DNA Structure

The Animal Genetics Engine provides an entity-agnostic persistent genetics system backed by Fabric's AttachmentType. Every genetic entity stores an EntityGenetics record:

1. parent1Uuid (Optional<UUID>): Primary parent UUID if born via breeding.
2. parent2Uuid (Optional<UUID>): Secondary parent UUID if born via breeding.
3. inbred (boolean): Flag indicating whether parents shared lineage.
4. traitsRolled (boolean): Flag indicating initial random stat rolling completed.
5. traits (Map<String, Float>): Dynamic trait values (scale, max_health, attack_damage, movement_speed).

 ┌────────────────────────────────────────────────────────────────────────┐
 │                           EntityGenetics                               │
 ├───────────────────────────────────┬────────────────────────────────────┤
 │ parent1Uuid: Optional<UUID>       │ inbred: boolean                    │
 │ parent2Uuid: Optional<UUID>       │ traitsRolled: boolean              │
 │ traits: Map<String, Float>        │ Codec: EntityGenetics.CODEC        │
 └───────────────────────────────────┴────────────────────────────────────┘

---

📐 Inheritance & Mutation Math

When two entities breed, offspring genetics are calculated via GeneticsEngine.calculateOffspringGenetics:

1. Scale Inheritance Formula

The offspring's baseline scale $S_{\text{offspring}}$ is derived from the mid-parent average plus a triangular Gaussian mutation delta $\Delta_{\text{mutate}}$:

$$S_{\text{offspring}} = \operatorname{clamp}\left( \frac{S_{\text{parent1}} + S_{\text{parent2}}}{2} + \Delta_{\text{mutate}}, , 0.1, , 3.0 \right)$$

Where $\Delta_{\text{mutate}}$ is sampled from a triangular distribution bounded by $\pm \text{mutationRate}$.

2. Inbreeding Penalty Formula

If parents share lineage ($F > 0$), an inbreeding health/scale penalty $\text{Penalty}_{\text{inbreeding}}$ is applied:

$$\text{Penalty}_{\text{inbreeding}} = 1.0 - (F \times \text{penaltyFactor})$$

$$\text{Offspring Health} = \text{Base Health} \times \text{Penalty}_{\text{inbreeding}}$$

---

💻 Developer Code Example

// Accessing genetics on an entity
EntityGenetics genetics = EntityGeneticsRegistry.getGenetics(livingEntity);
float scale = genetics.getScale();
boolean isRunt = scale < 0.75f;

// Applying genetics modifier
GeneticsEngine.applyGeneticsModifiers(livingEntity);

---

🔗 Related Pages

• Genetics API & Pedigree
• Stale Attribute Purging & Scale