SporeWithin

By
starlings_s

SporeWithin turns Spore into a tactical biological horror: track hidden parasites buried right under your feet by sound, burn infected remains, and fight surface defense waves before the Proto-Brain awakens.

The Genesis of Infection: When an infected carrier dies, it leaves behind pulsing organic remains. You have a limited 30–180 second window to break or incinerate the corpse with flint and steel before it dissolves into the ground to seed a subterranean ne

Burrowed mounds leave clear surface clues! Look for the corrupted mycelium patch and floating green spore particles on the ground, then listen closely for the ominous throbbing heartbeat under your feet. Dig it up and strike it to drain its Bio-Points bef

This is how it ends: If a 4th-stage Mound survives its 7-day maturation, it awakens the dreaded Proto-Brain! The collective Hivemind takes full control of the world, permanently unlocking natural parasite spawns and converting nighttime monsters into infe

Description

# 🦠 SporeWithin: The Enemy Within

🧱 **Platform:** Minecraft 1.20.1 (Forge) | 🦠 **Dependency:** Requires Spore Mod | 🌐 **Multiplayer:** Dedicated Server Ready

> *"The danger is no longer creeping from distant caves... It walks among your villagers, dies in your fields, and burrows directly beneath your feet."*

**SporeWithin** is a deep tactical biological horror expansion and ecosystem overhaul for the **Spore** mod on Minecraft 1.20.1 (Forge).

In vanilla Spore, infection often begins with chaotic entity spawns in deep underground caverns where players rarely tread. **SporeWithin completely redesigns this progression into an insidious, stealth-driven biological invasion.** The parasite infiltrates surface humanoids, secretes embryonic organoids right beneath the surface soil, and challenges players to actively track, excavate, and eradicate nests before the hive mind awakens on **Day 7**.

---

### ⚙️ Development & Transparency Note
> **Code Assistance:** Parts of this mod's code and mathematical systems were developed with the assistance of AI tools.
> **Quality Assurance:** Every single mechanic, event hook, and tick loop has been extensively playtested in real in-game survival scenarios, profiled for performance (no TPS drops / memory leaks), and manually debugged.
>
> If you encounter any bugs or edge cases, please report them on the Issues page — they will be investigated and fixed promptly!
---

## 🧬 Core Features & Mechanics

### 💀 1. The Parasitic Vessel Outbreak
* **Stealth Infection**: Starting on the first night, living humanoids (Zombies, Villagers, Pillagers, Players) have a daily scaling chance (**1.0%** on Day 0, increasing by **+0.2%** each in-game day up to a hard cap of **5.0%**) to spawn as hidden carriers of the **Spore Infection**.
* **Aggressive Vessel AI**: Infected vessels become hyper-aggressive, hunting down players, villagers, and monsters.
* **Persistent Hostiles**: Infected mobs never naturally despawn — they will live out the infection until their vital organs fail.
* **The Death Event**: When a vessel perishes, its corpse collapses into a **Human Remains** block while the embryonic parasite burrows underground.

---

### 🔨 2. Destroy or Burn the Remains!
* **Race Against the Clock**: Upon a vessel's death, players have a brief window (**30 to 180 seconds**) to locate and destroy the **Human Remains**.
* **Flexible Neutralization**: You can **break the remains with any tool or bare hands, burn them with Flint & Steel, or destroy them with lava/explosives** to permanently neutralize the parasite before it establishes a nest.
* **Dynamic Relief Period**: Neutralizing the remains pacifies the local territory for **10–15 minutes** (this cooldown decreases by 1 minute for every elapsed game day, with a minimum 2-minute safety floor).

---

### 🕳️ 3. Subterranean Mounds & Acoustic Surface Tracking
* **Buried Organoids**: If remains are not destroyed in time, the parasite establishes a sealed 3x2x3 subterranean burrow **just 2–3 blocks directly beneath the surface terrain**.
* **Sound Tracking (Madness Heartbeat)**: You don't need X-Ray or cave expeditions. Walking across the ground above a buried Mound produces an ominous, muffled **heartbeat of Madness** (`ambient.madness`), alerting players to start digging!
* **Surface Vegetation**: By Stage 2, the soil directly above the mound begins rotting into fungal mycelium and parasitic growths.

---

### 🛡️ 4. Tiered Defensive Squads & Boss Waves
Mounds accumulate **Bio-Points** (1 pt/sec) to fuel their evolution and actively defend themselves if players approach their detection perimeter or attack them.
*Defenders burst out **strictly on the surface above the mound** with dirt explosions, spore geysers, and shrieking alarms!*

> [!TIP]
> **Evolution Penalties**: Attacking a mound directly drains its Bio-Points, and 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)
* **Threshold**: Accumulating **8400 Bio-Points** (~7 in-game days of undisturbed growth) causes the Stage 4 Mound to undergo violent metamorphosis into the **Proto-Brain**.
* **The Global Awakening**: When the Proto-Brain awakens, the global containment is broken, unlocking unrestricted natural Spore spawns worldwide and unleashing the full planetary apocalypse.

---

## ⚙️ Configuration & Customization
Every aspect of **SporeWithin** is fully balanced out of the box but completely configurable in `config/sporewithin-common.toml`:
* Starting & daily scaling infection chances (and max caps).
* Bio-Point thresholds for stages and 7-day evolution timer.
* Defense squad compositions, costs, and cooldowns.
* Territory relief/calm cooldown durations and daily reductions.

---

## 📦 Requirements & Installation
1. Install **Minecraft Forge 1.20.1** (Recommended 47.3.0+).
2. Download and install the **Spore** mod for 1.20.1.
3. Place `sporewithin-1.0.0.jar` into your `.minecraft/mods` folder.
4. Fully compatible with Singleplayer, LAN, and Dedicated Multiplayer Servers!

---

## 👁️ What Lies Ahead... (Upcoming Updates)

> *"You may have survived the first outbreaks, but do not be fooled: the Hivemind is watching, learning, and adapting to your presence."*

**SporeWithin** is actively evolving. Here is a glimpse of what is currently in development:

* 🧠 **Adaptive Hive Intelligence**: The parasite will soon begin recognizing human resistance. The more nests you burn, the more aggressively and strategically the Hive will retaliate.
* 🧪 **Decontamination & Medical Tech**: Specialized field serums, chemical containment devices, and experimental vaccines to cleanse infected territories.
* 🌪️ **Atmospheric & World Anomalies**: Unpredictable biological climate events when regional infection levels reach critical mass.
* 🕳️ **Subterranean Research Relics**: Abandoned bio-laboratories with forgotten lore, blueprints, and high-risk extraction zones.

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

The SporeWithin Team

1
Projects
11
Downloads

I really love parasite mods