VoidSanctum - Personal Pocket Dimensions

🌌 Overview

VoidSanctum gives every player their own personal pocket dimension - a private, upgradeable space accessible through magical portals. Build alone in complete safety, or invite friends by creating portals for them. You control who enters your Sanctum!

✨ Key Features

🏠 Your Personal Sanctum

Portal-Only Access: Create magical portals with your Sanctum Grimoire
Full Privacy Control: Only you can create portals to your Sanctum
5 Expandable Tiers: Start at 15x15 and upgrade to 55x55
Persistent & Protected: Your dimension is safe from griefing and raids

🔮 Grimoire Controls

Right-Click: Create portal
- Outside Sanctum: Costs 5 Void Essence (entry)
- Inside Sanctum: FREE (exit)
- Portal lasts 10 seconds

👥 Visitor Management

Grimoire Kick: Left-click unwanted visitors
Command Kick: /sanctum kick <player> or /sanctum kick (all visitors)
Emergency Exit: /sanctum escape to return home instantly

🎮 Commands

Player Commands (Everyone)

/sanctum escape              - Return to your previous location
/sanctum kick <player>       - Remove a specific player from your Sanctum
/sanctum kick                - Remove all visitors at once

Admin Commands (OP Only)

/sanctum player <name>       - Teleport to a player's Sanctum
/sanctum slot <number>       - Teleport to Sanctum by slot ID

/sanctum whitelist enable    - Restrict Grimoire to whitelisted worlds only
/sanctum whitelist disable   - Allow Grimoire usage in all worlds
/sanctum whitelist add       - Add current world to Grimoire whitelist
/sanctum whitelist remove    - Remove current world from whitelist
/sanctum whitelist list      - Show all whitelisted worlds
/sanctum whitelist status    - Check current whitelist state

📏 Room Sizes

Upgrade your Sanctum at the Arcanist's Workbench:

Tier	Size
I	15×15×15
II	25×25×25
III	35×35×35
IV	45×45×45
V	55×55×55

🎯 How It Works

Getting Started

Craft a Sanctum Grimoire at the Arcanist's Workbench
Gather 5 Void Essence (cost per entry portal)
Right-click grimoire to create a portal
Step through to claim your Sanctum!

Inviting Friends

Right-click grimoire to create a portal (costs 5 Void Essence)
Friend steps through within 10 seconds
They're in your Sanctum!
Left-click them with grimoire to kick if needed

Upgrading

Craft upgrade items at the Arcanist's Workbench, then use them to expand your room.

🛠️ For Server Admins

Storage: plugins/VoidSanctum/sanctums/ (one JSON per player)
World Whitelist: Restrict Grimoire usage to chosen worlds only
Scalable: All Sanctums in one shared dimension (no world bloat)
Admin Tools: Teleport to any Sanctum, manage offline players

⚙️ Technical Reliability

VoidSanctum handles many edge cases under the hood — safe block detection on teleportation, boundary monitoring to catch players escaping the pocket limits, proper location saving, and dimension existence checks with automatic overworld fallback.

A lot of quiet work went into making sure nothing can go wrong.