ZombieApocalypseSSS

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

📖 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

📈 Progressive Difficulty

⚠️ 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

🚀 Installation

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

⌨️ Commands

🔐 Permissions

🔧 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.