MineZCore - MineZ Survival Framework

# MineZCore - MineZ Survival Framework

MineZCore is a Bukkit/Spigot/Paper plugin that turns selected worlds into a MineZ-style survival experience. It is designed for servers that want hardcore zombie survival, loot progression, medical systems, world-only gameplay, and anti-combat-log protection.

The plugin can be enabled only in specific configured worlds, making it safe to run on network servers with lobby, survival, creative, or minigame worlds.

## Features

### Per World Support
- Enable MineZCore only in selected worlds
- Other server worlds remain untouched
- Configurable enabled world list

### Player Survival Systems
- Thirst system
- Actionbar HUD
- Dehydration damage
- Bleeding status
- Infection status
- Persistent player data saved to `players.yml`

### Medical Items
- Bandages stop bleeding
- Antibiotics cure infection
- Custom named medical items
- Medical loot support

### Loot Chest System
- Manual static loot chests
- Random world loot chests
- Configurable loot tables
- Civilian, medical, and military loot
- Military loot tiers
- Configurable item chances
- Min/max loot rolls per chest
- Chests never spawn empty
- MineZ-style chest behavior
- Right-click opens chest normally
- Left-click breaks chest and drops contents
- Empty chests disappear
- Static chest locations saved separately in `loot-chests.yml`
- Random chests tracked separately for cleanup

### Zombie System
- MineZ world can be restricted to zombies only
- Stronger and faster infected zombies
- Zombies do not burn in daylight
- Configurable extra zombie spawning
- Configurable horde spawning
- Zombies can cause bleeding
- Zombies can cause infection
- Zombies can spawn with gear
- Zombie gear can drop
- Rare zombie loot drops

### Player Death Zombies
- Players who die in MineZ can spawn an infected player zombie
- Killing the player zombie drops the dead player’s inventory
- Supports LibsDisguises for player-style infected visuals

### Spawn System
- Admins can create MineZ spawn points
- Players respawn at random configured MineZ spawns
- Spawn points saved to `spawns.yml`

### Combat Logging Protection
- `/minez logout` safe logout system
- Unsafe logout creates a Citizens NPC
- NPC can be killed by players
- NPC drops the combat logger’s inventory
- If the player rejoins before the NPC dies, the NPC is removed

### World Protection
- Prevent block breaking in MineZ worlds
- Prevent block placing in MineZ worlds
- Admin permission bypass

### Configurable Permissions
- Bukkit/LuckPerms-compatible permissions
- Optional custom permission node config through `permissions.yml`

## Dependencies

Required:
- Paper

Optional but recommended:
- Citizens
- ProtocolLib
- LibsDisguises
- PacketEvents

## Commands

| Command | Description

`/minez` | Shows command help
`/minez addchest <table>` | Adds a static loot chest
`/minez spawnrandom` | Spawns a random test loot chest near you
`/minez addspawn` | Adds a MineZ respawn point
`/minez logout` | Starts safe logout countdown

## Permissions

| Permission | Description |

`minez.admin` | Full admin access
`minez.addchest` | Allows adding loot chests
`minez.spawnrandom` | Allows spawning test random chests
`minez.addspawn` | Allows adding MineZ spawn points
`minez.logout` | Allows safe logout command

## Planned Features

- Broken legs and splints
- Combat timer before safe logout
- Safe zones and town regions
- Region-based loot tables
- Backpacks
- Water purification
- Canteens
- More medical items
- Boss infected
- Better horde events
- Admin GUI
- Reload command
- Database support
- Advanced player zombie skins

## Support Development

If you like the plugin and want to support development, donations are appreciated:

Donate: https://revolut.me/jonaths0c

## Notes

This plugin is still in active development. Please report bugs, balance issues, and feature suggestions.