---

🆕 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

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

Author: Duong2012G License: Apache 2.0

Open source — contributions welcome.