SporeWithin

SporeWithin

SporeWithin is a coded tactical expansion for the "Fungal Infection: Spore" mod, designed from the ground up to deliver perfect server TPS and FPS by strictly confining the early outbreak to the surface.

Unlike other addons that overload memory with hidden underground spawns, SporeWithin tracks entities within a tight 12-chunk radius and cleans up memory properly, eliminating late-game lag entirely.

---

⚡ Key Features

* **Zero Underground Lag**: All initial infection mechanics and hive generation occur strictly on the surface. Active memory cleanups ensure that entities do not clog your server's RAM.

* **Surface Outbreak Markers**: Infected entities carry a custom rendering marker visible from 28 blocks away. They spread the virus to other humanoids, die, and leave behind remains with distinct smoke and audio effects.

* **The Hive Cycle**: If remains are not destroyed by the player, they rot and release a Stage 1 Mound. Players must locate it using visual particles and an audible heartbeat pulse within a 3x3 radius.

* **Advanced Config**: A fully detailed configuration file allows you to customize hive points, evolution speed, chunk limits, and spawn caps to fit your modpack's balance perfectly.

---

🛡️ Mound Evolution & Tactical Defense

Mounds accumulate Bio-Points over time. To fuel their evolution, they automatically expend points to summon defense squads if a player attacks them or enters their detection perimeter.

*Defenders burst out strictly on the surface above the mound accompanied by dirt explosions and spore geysers.*

| Mound Stage | Detection Area | Full Squad Defense (Bulk Discount) | Single Defender (Fallback) |

| :--- | :---: | :--- | :--- |

| **Stage 1** (Day 0–1) | 3x3 / 5x5 blocks | 3 Basic Infected (100 pts) | 1 Basic (35 pts) |

| **Stage 2** (Day 1–2.5) | 3x3 / 5x5 blocks | 4 Parasites (2 Evolved + 2 Basic) (200 pts) | 1 Evolved (70 pts) |

| **Stage 3** (Day 2.5–5) | 10x10 blocks | 5 Parasites (1 Hyper + 2 Evolved + 2 Basic) (380 pts) | 1 Hyper (150 pts) |

| **Stage 4** (Day 5–7) | 20x20 blocks | Boss Wave: 8 Parasites in 2 timed waves (650 pts) | 1 Hyper (150 pts) |

> [!IMPORTANT]

> **Evolution Penalties**: Attacking a mound directly drains its Bio-Points. Eliminating its defenders inflicts an additional **-25 Bio-Point penalty**, physically knocking the hive's evolution backward.

---

⏳ 5. The 7-Day Evolution Timeline (Proto-Brain Metamorphosis)

If a Stage 4 Mound is left undisturbed for **7 in-game days** (accumulating **8400 Bio-Points**), it will undergo a complete metamorphosis into a **Proto-Brain**.

* **The Global Awakening**: Once the Proto-Brain forms, the local containment phase ends. This triggers unrestricted, natural Spore entity spawns globally, advancing your world into a terminal, full-scale apocalypse.

---

⚙️ Configuration & Customization

Every aspect of **SporeWithin** is fully balanced by default but provides a highly detailed configuration file located in config/sporewithin-common.toml. Pack makers can easily customize:

* Base infection rates, daily scaling multipliers, and hard caps.

* Bio-Point thresholds for each evolution stage and the 7-day Proto-Brain timer.

* Defense squad compositions, point costs, and trigger cooldowns.

* Territory alert states, recovery cooldown durations, and daily point reductions.

---

📦 Requirements & Installation

1. Install **Minecraft Forge 1.20.1** (Version 47.3.0 or higher recommended).

2. Download and install the original **Fungal Infection: Spore** mod.

3. Drop the sporewithin-1.0.1.jar (make sure to use v1.0.1+ to avoid the Glow Squid crash bug) into your mods folder.

4. Fully optimized for Singleplayer, LAN, and Dedicated Servers.

---

👁️ Future Roadmap (Upcoming Updates)

The mod is actively developed. Here is what is currently planned for future releases:

* 🧠 **Adaptive AI (Player Aggression Tracking)**: The Hivemind will track your efficiency. The more mounds you destroy, the more aggressively and strategically the infection will fight back.

* 🧪 **Bio-Laboratories & Cures**: Experimental field serums, containment tech, and craftable vaccines using endgame materials (Nether Star, Netherite, Dragon's Breath) to actively cleanse infected territories.

* 🌪️ **Regional Anomalies**: Biological weather and atmospheric events that trigger when local infection levels reach critical mass.

* 🕳️ **Subterranean Research Relics**: Abandoned underground facilities featuring forgotten lore, blueprints, and high-risk extraction zones.

---

💬 *Leave your feedback in the comments and stay tuned — the infection has only begun to evolve!*