ZombieApocalypseSSS

A full-featured zombie apocalypse survival plugin for Paper 1.21+

Turn your Minecraft server into a post-apocalyptic nightmare — one corpse at a time.

📥 Download • 🐛 Report a Bug • 💬 Discord

🆕 What's new in 4.5.1 — Critical Bug Purge III

This patch fixes 11 bugs found during deep code review, including two that rendered
entire gameplay systems non-functional and one that could cause permanent zombie immortality
after a server restart.

| # | Severity | Summary |
|---|----------|---------|
| BF-16 | 🔴 Critical | Turret system was completely broken — crafted turrets could never be placed as actual turrets due to an Adventure vs. Legacy API mismatch in isTurretItem() |
| BF-17 | 🔴 Critical | Turret data loss on server restart — onDisable() never called turretManager.cleanup(), skipping the final save |
| BF-19 | 🔴 Critical | All zombie custom AI lost after /zapoc reload — trackedZombies was cleared but never rescanned; behavior task saw an empty collection |
| BF-18 | 🔴 Critical | Turret config changes had no effect after reload — TurretManager was never recreated; range/damage/fire-rate kept stale values |
| BF-20 | 🔴 Critical | Feign-Death zombie permanently invulnerable after restart — invulnerable=true + AI=false persisted in NBT but the revive task was lost on shutdown |
| BF-21 | 🟡 Medium | Campfire I/O spam on main thread — saveCampfires() was called on every zombie hit; replaced with a dirty-flag + 5-second flush cycle |
| BF-23 | 🟡 Medium | Screamer: 6 YAML reads per zombie per 0.5 s — all screamer config values now cached with the sun-effect values |
| BF-24 | 🟡 Medium | Breaker: success-chance YAML read per zombie per 2 s — now cached |
| BF-25 | 🟡 Medium | Hallucination map used reusable int entity ID as key — changed to UUID |
| BF-22 | 🟢 Minor | Campfire heal loop used 3×3 chunk scan — expanded to 5×5 to match tier-3 radius |
| BF-26 | 🟢 Minor | handleBreaker() repeated the enabled check already performed by the caller |

No config changes required. All existing data.yml, campfires.yml, and
turrets_data.yml are fully compatible.

📖 Table of Contents

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

✨ Features

🧠 Advanced Zombie AI

• 15+ configurable zombie types (Tank, Screamer, Assassin, Boss, etc.)
• Hive Mind — group aggro behavior
• Noise system — blocks, gunshots, explosions attract zombies
• Scent detection — sneak < walk < sprint
• Feign Death zombies revive after a delay
• Breaker AI — 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

• Bandage — stop bleeding
• Antivirus — reset infection
• Adrenaline — temporary boost with crash
• Zombie Camo — 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

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

❓ 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

Author: Duong2012G
License: Apache 2.0

Open source — contributions welcome.