Overview

This document summarizes research on animal defensive strategies including physical protection, chemical defenses, distraction techniques, and threat assessment. Better Ecology implements several species-specific defensive behaviors based on real animal research.

Key Behavioral Patterns

Threat Assessment

Animals continuously evaluate threats before initiating defensive responses.

Assessment Factors:

• Predator proximity (distance threshold triggers)
• Health status (injured animals more defensive)
• Escape route availability
• Predator type and behavior

Defense Strategy Selection

Armadillo Defensive Curl

Implementation: ArmadilloDefensiveCurlGoal

Three-banded armadillos curl into a complete defensive ball when threatened, providing significant protection at the cost of mobility.

Trigger Conditions

All three conditions must be met for curl activation.

Defensive Parameters

Behavior Sequence

1. Threat Detection: Predator detected within 4 blocks
2. Escape Assessment: Check if escape path exists
3. Health Check: Verify health below 50% threshold
4. Curl Initiation: Stop movement, enter defensive position
5. Damage Reduction: Apply 60% damage reduction
6. Safety Monitoring: Check for threats every tick
7. Uncurl Decision: Safe for 3 seconds OR max duration reached

Scientific Basis

Based on research on three-banded armadillos (Tolypeutes), which are unique among armadillo species in their ability to roll into a complete defensive ball. This behavior:

• Protects vulnerable underbelly
• Renders predator bites ineffective
• Trades mobility for protection
• Relies on robust shell armor

Squid Ink Cloud Defense

Implementation: SquidInkCloudDefenseGoal

Squid and glow squid eject ink clouds to blind predators while escaping.

Trigger Conditions

Either condition triggers the defense (OR logic).

Defense Parameters

Behavior Sequence

1. Threat Detection: Health low OR predator nearby
2. Ink Ejection: Create particle cloud explosion
3. Speed Boost: Apply Speed II effect
4. Cloud Maintenance: Spawn particles every 5 ticks
5. Blindness Application: Blind entities in cloud every second
6. Escape: Use speed boost to flee while predators are blinded
7. Cooldown: Wait 20-30 seconds before next use

Effects on Predators

• Blindness I: Applied for 3 seconds to entities in cloud
• Visual Obstruction: Dense squid ink particles reduce visibility
• Pursuit Disruption: Predators lose target while blinded

Scientific Basis

Based on real cephalopod ink defense:

• Squid and octopuses eject melanin-based ink
• Ink creates visual screen obscuring the animal
• Some species create ink “pseudomorphs” (decoys)
• Chemical components may irritate predator senses
• Coupled with jet propulsion for rapid escape

Pufferfish Flash Expansion

Implementation: FlashExpansionFleeGoal

Pufferfish inflate rapidly when threatened, increasing their apparent size and exposing defensive spines.

Defense Parameters

Scientific Basis

Based on pufferfish (family Tetraodontidae) defensive inflation:

• Rapid water/air intake expands body
• Spines become erect and dangerous
• Tetrodotoxin provides additional chemical defense
• Dramatic size increase deters many predators

Defense Integration with Other Behaviors

Priority System

Defensive behaviors have high priority to ensure survival:

Coordination with Fleeing

Defensive behaviors activate when fleeing is not viable:

if (threatDetected) {
    if (canEscape) {
        -> FleeFromPredatorGoal
    } else if (hasDefense) {
        -> DefensiveBehaviorGoal
    } else {
        -> ThanatosisGoal (play dead)
    }
}

Species-Specific Behaviors

Armadillo

Squid / Glow Squid

Pufferfish

Turtle

Implementation Notes

Configuration Parameters

Performance Optimizations

• Threat caching: Cache detected predators for 10 ticks
• Escape path check: Only compute when threat detected
• Effect application: Apply blindness every 20 ticks, not every tick
• Particle spawning: Interval-based spawning reduces overhead

Key Academic References

Foundational Papers

1. Superina, M. & Aguiar, J.M. (2006). “A reference list of common names for the armadillos”
2. Bush, S.L. (2006). “Defensive ink ejection in octopus”
3. Hanlon, R.T. & Messenger, J.B. (1996). “Cephalopod Behaviour”

Recent Research

4. Harismendy, O. et al. (2019). “Evolution of defensive strategies in Tolypeutes”
5. Derby, C.D. (2014). “Cephalopod ink: Production, chemistry, functions and applications”
6. Jiang, Y. et al. (2020). “Pufferfish inflation mechanics and defensive behavior”

See Also

• Fleeing Research - Escape behaviors
• Hunting Research - Predator behaviors
• Armadillo - Defensive curl implementation
• Fish - Pufferfish and squid behaviors