ZombieApocalypseSSS

---

📖 Table of Contents

* ✨ Features * 📦 Requirements * 🚀 Installation * ⌨️ Commands & Permissions * 🔧 Configuration * 🔫 CombatGunSSS Integration * 🧩 Developer API * 🔍 Troubleshooting * ❓ FAQ * 📄 Credits

---

✨ Features

🧠 Advanced Zombie AI

* Sun weakness (Tank, Screamer, Assassin, Boss, etc.) * Sun weakness — group aggro behavior * Sun weakness — blocks, gunshots, explosions attract zombies * Sun weakness — sneak < walk < sprint * Sun weakness zombies revive after a delay * Sun weakness — destroy doors and blocks * Sun weakness (burn or slow)

---

🎯 Tier Evolution System

| Tier | Multiplier | Speed | Knockback | | -------- | ---------- | ----- | --------- | | Primal | ×1.0 | — | 0 | | Adapted | ×1.2 | +0.1 | 0 | | Mutated | ×1.5 | +0.2 | 0.2 | | Aberrant | ×2.5 | +0.3 | 0.5 |

---

📈 Progressive Difficulty

| Phase | Days | Spawn Rate | Unlock | | ----- | ----- | ---------- | --------------- | | 1 | 0–5 | 40% | Basic zombies | | 2 | 6–15 | 70% | Status zombies | | 3 | 16–30 | 90% | Special zombies | | 4 | 31+ | 100% | All types |

⚠️ Fixed in 4.4.0: Phase-based spawning now works correctly.

---

🧬 Infection System

* 0–100 infection points * Effects scale with level * +5 per hit (30% chance) * Natural decay (~1 point / 30s, faster in safe zones)

---

🧠 Psychological Horror (Sanity)

* BossBar display (green → purple) * Hallucinations, fake sounds, fake messages * Drains in darkness, near zombies, when alone

⚠️ Fixed in 4.4.0: All sanity multipliers now apply correctly.

---

🔥 Campfire Safe Zones

* Prevent zombie spawning * Heal players and reduce infection * 3 upgrade tiers * Zombies can destroy them

---

🩹 Survival Items

* Radio — stop bleeding * Radio — reset infection * Radio — temporary boost with crash * Radio — ignored by zombies * Radio — locate supply drops

---

🌙 Blood Moon

* Random night event (default 5%) * Increased spawn rate and stronger zombies * API events available

---

📦 Supply Drops

* Random drops near players * Fully configurable loot table * Optional coordinate broadcast

⚠️ Fixed in 4.5.0: Tier 3 campfire radius now correctly blocks zombie spawns.

---

🔫 Sentry Turrets

* Auto-target zombies * Multiple ammo types * Persistent across restarts

⚠️ Fixed in 4.4.0: Data loss issue resolved.

---

🌍 World Structures

* Military Checkpoint * Crashed Plane * Hospital * Survivor Camp * Outpost

✔️ Scale with difficulty ✔️ No ocean spawning

---

📖 Survival Guide GUI

* Interactive in-game guide * Covers all systems and mechanics

---

📦 Requirements

| Component | Version | | ----------- | -------- | | Java | 21+ | | Paper | 1.21+ | | WorldGuard | Optional | | ProtocolLib | Optional |

---

🚀 Installation

1. Download the `.jar` 2. Place it in `plugins/` 3. Start the server 4. Edit configs 5. Use `/zapoc reload`

---

⌨️ Commands

| Command | Description | | ------------------- | ------------- | | `/zapoc reload` | Reload config | | `/zapoc summon` | Spawn zombie | | `/zapoc infect` | Infect player | | `/zapoc cure` | Cure | | `/zapoc panic` | Spawn horde | | `/zapoc bloodmoon` | Toggle event | | `/zapoc supplydrop` | Force drop | | `/zapoc stats` | View stats |

---

🔐 Permissions

| Permission | Description | | -------------- | ------------------- | | `zapoc.admin` | Full access | | `zapoc.use` | Use features | | `zapoc.immune` | Immune to infection |

---

🔧 Configuration

Config files:

* `config.yml` * `zombies.yml` * `items.yml` * `events.yml` * `mechanics.yml` * `turrets.yml` * `sun-effect.yml` * `spawn-control.yml` * `messages_en.yml` * `messages_vi.yml`

---

🔫 CombatGunSSS Integration

👉 https://modrinth.com/plugin/combatgunsss

* 30+ guns * Full compatibility * Optional but recommended

---

🧩 Developer API

```java ZombieApocAPI api = ZombieApocAPI.getInstance();

api.isInfected(player); api.getInfectionPoints(player); // raw 0–100 api.getSanity(player); // new in 4.5.0 api.isBleeding(player); // new in 4.5.0 api.spawnZombie(world, location, "tank"); api.isInSafeZone(location); ```

Events:

* BloodMoonStartEvent * BloodMoonEndEvent * SupplyDropEvent * ZombieInfectEvent

---

🔍 Troubleshooting

Zombies not spawning

* Check `spawn-control.enabled` * Ensure world is enabled * Use Paper (not Spigot) * Test with `/zapoc summon`

Zombies spawning inside Tier 3 campfire zones

* Fixed in 4.5.0 * The spawn-block check now uses a 5×5 chunk search to cover the full 40-block radius

API zombie has wrong / mixed type after spawnZombie()

* Fixed in 4.5.0 * Previous builds applied a random type first then the requested type, leaving stale PDC keys

Spawn phases not working

* Fixed in 4.4.0 * Update plugin

Sanity system not working

* Fixed in 4.4.0 * Check `mechanics.yml`

Infection not disabling

* Fixed in 4.4.0

Turrets disappearing

* Fixed in 4.4.0

Recipes not showing

* Fixed in 4.3.3

Zombie names broken

* Fixed in 4.3.3

Structures spawning in ocean

* Fixed in 4.3.1+

/reload breaks plugin

* Always restart server

---

❓ FAQ

Does this replace vanilla zombies?

Optional — configurable.

Does it support multiple worlds?

Yes.

Is it laggy?

Optimized, but depends on config.

Can I disable infection?

Yes (`config.yml`).

Do I need CombatGunSSS?

No, but recommended.

Does it support Spigot?

No — Paper only.

---

📄 Credits

License: Duong2012G License: Apache 2.0

*Open source — contributions welcome.*