Caves is a packet-based regenerating mine system built for prison servers running PinnaPrison. Players mine ore veins that only they can see, earn per-ore currencies, and unlock progressively richer caves as they rank and rebirth — all without a single real block ever changing in the world.
Fully Packet-Based Mining
- Ores are sent as per-player packets — the real world is never modified, so there is no block lag, no world edits, and no cleanup
- Mined ores instantly become a packet placeholder block (bedrock by default) and regenerate on a timer you control
- Per-player overlays with chunk-load-aware sending and configurable packet batch sizes for smooth performance
- Optional per-player break particles and sounds
- PinnaPrison pickaxe required for mining, with an admin sneak-bypass for building
Caves, Regions & Regeneration
- Unlimited caves — each cave supports multiple regions, so one cave can span several mine areas
- Selection wand and commands to create regions, set spawns, rescan, and remove regions
- Configure regen time (seconds), the placeholder block, and which real-world materials convert into packet ores
- Weighted ore chances per cave — richer caves roll better ores more often
Rank & Rebirth Progression
- Every ore has its own rank and rebirth unlock requirement from PinnaPrison (e.g. iron at rank 250, diamond at rank 750 + rebirth 1)
- Caves themselves can be gated behind rank/rebirth requirements
- Ore chances are rolled only from the ores the player has unlocked — early ranks see coal, later ranks see diamonds and debris
- Permission bypass for staff
Cave Time Economy
- Players earn cave time by mining ores inside cave regions
- Entering a cave consumes a configurable amount of time (3 minutes by default) — an entry cost that keeps players mining to keep playing
- Admins can grant cave time directly with a command
Per-Ore Currency
- Mining an ore grants that ore's currency instead of vanilla drops — mine coal ore, gain coal currency
- Balances are tracked per player and only counted inside cave regions
- Admins can give any ore currency with a command
/caves GUI
- Clean menu showing every cave, its lock status, and one-click teleporting
- Fully customizable cave lore per cave — each cave defines its own colors, requirement lines, and per-ore balance placeholders like {coal_ore}
- Per-ore lore templates with per-cave colors, showing the player's balance or "Locked" with the unlock requirement
- Wallet panel showing the player's PinnaPrison rank and rebirth
- Configurable GUI size, slots, and filler material
Commands
- /caves — open the menu | /caves time — check cave time | /caves tp <id> — travel to a cave
- Admin: wand, pos1/pos2, create, setregion, removeregion, setspawn, scan, delete, list, give, givetime, reload
Permissions
- caves.use — open /caves and mine in unlocked caves (default: everyone)
- caves.admin — create, edit and manage caves (default: op)
- caves.reload — reload configuration (default: op)
- caves.bypass — bypass cave and ore rank/rebirth unlocks (default: op)
Requirements
- PinnaPrison (hard dependency) — pickaxe detection, rank and rebirth checks
- Paper 1.20+
Everything is configurable: regen timings, ore tables, chances, entry costs, every message, and every piece of GUI text. Drop it in your plugins folder, set up your first region, and start mining.