Описание
# ZombieApocalypseSSS
**A full-featured zombie apocalypse survival plugin for Paper 1.21+**
[](https://modrinth.com/plugin/zombieapocalypsesss)
[](https://papermc.io)
[](https://adoptium.net)
[](LICENSE)
*Turn your Minecraft server into a post-apocalyptic nightmare — one corpse at a time.*
[📥 Download](https://modrinth.com/plugin/zombieapocalypsesss) • [🐛 Report a Bug](https://modrinth.com/plugin/zombieapocalypsesss) • [💬 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
| 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
```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
**Author:** Duong2012G
**License:** Apache 2.0
*Open source — contributions welcome.*