虚空圣所

VoidSanctum - 私人口袋维度

🌌 概述

VoidSanctum 为每位玩家提供专属的私人口袋维度——一个可通过魔法传送门进入的私有、可升级空间。在绝对安全的环境中单独建造，或为朋友创建传送门邀请他们进入。你的圣域由你做主！

---

✨ 主要特性

🏠 你的专属圣域

• 仅限传送门出入：使用你的圣域魔典创建魔法传送门
• 完全隐私控制：只有你能创建通往自己圣域的传送门
• 5个可扩展等级：从15x15起步，可升级至55x55
• 持久且受保护：你的维度免受破坏和袭击

🔮 魔典操作

• 右键点击：创建传送门
  • 圣域外：消耗5虚空精华（进入）
  • 圣域内：免费（离开）
  • 传送门持续10秒

👥 访客管理

• 魔典驱逐：左键点击不受欢迎的访客
• 命令驱逐：/sanctum kick <玩家> 或 /sanctum kick（所有访客）
• 紧急离开：使用 /sanctum escape 立即返回家园

---

🎮 命令

玩家命令（所有人）

/sanctum escape              - 返回你之前的位置
/sanctum kick <玩家>        - 从你的圣域中移除特定玩家
/sanctum kick                - 立即移除所有访客

管理员命令（仅OP）

/sanctum player <名称>       - 传送到玩家的圣域
/sanctum slot <编号>         - 根据槽位ID传送到圣域

/sanctum whitelist enable    - 将魔典限制在白名单世界内
/sanctum whitelist disable   - 允许在所有世界使用魔典
/sanctum whitelist add       - 将当前世界添加到魔典白名单
/sanctum whitelist remove    - 从白名单中移除当前世界
/sanctum whitelist list      - 显示所有白名单世界
/sanctum whitelist status    - 查看当前白名单状态

---

📏 房间尺寸

在奥术师工作台升级你的圣域：

等级	尺寸
I	15×15×15
II	25×25×25
III	35×35×35
IV	45×45×45
V	55×55×55

---

🎯 工作原理

快速入门

1. 在奥术师工作台制作圣域魔典
2. 收集5个虚空精华（每次进入传送门的消耗）
3. 右键点击魔典创建传送门
4. 走进去，认领你的圣域！

邀请朋友

1. 右键点击魔典创建传送门（消耗5虚空精华）
2. 朋友在10秒内踏入传送门
3. 他们就在你的圣域里了！
4. 必要时可用魔典左键点击他们将其驱逐

升级

在奥术师工作台制作升级物品，然后使用它们扩展你的空间。

---

🛠️ 服务器管理员指南

• 存储路径：plugins/VoidSanctum/sanctums/（每位玩家对应一个JSON文件）
• 世界白名单：将魔典使用限制在选定的世界内
• 可扩展性：所有圣域共享一个维度（不会造成世界膨胀）
• 管理工具：可传送至任意圣域，管理离线玩家

---

⚙️ 技术可靠性

VoidSanctum 内部处理了许多边缘情况——传送时的安全方块检测、防止玩家越出维度边界的边界监控、正确的位置保存，以及维度存在性检查（带自动主世界回退）。

大量的幕后工作确保一切万无一失。