Catacombs - 随机地牢探险

Catacombs 是一款地下城生成插件，它能在玩家脚下构建可配置的随机多层地牢，供玩家探索和寻宝。管理员可以创建地牢，玩家则需准备好装备与补给才能挑战其中的危险与奖励。

💡版本信息

• Catacombs - Random Dungeon Generator: 主版本，构建可配置的地下城。
• 适用于 1.8 - 1.10: Labyrinth Generator。
• 适用于 1.0 - 1.6: Original Catacombs。
• One Floor Labyrinth (无屋顶): 由 BlockHead2 制作。

🎮主要特性

• 生成随机的多层地下城。
• 默认仅在被视为“自然”的固体区域（如石头、泥土）中建造，可通过在配置中添加 AIR 实现在任何地方建造。
• 管理员负责建造，玩家负责探索。
• 所有命令均与权限系统集成。
• 通过 Vault 支持大多数经济系统（可选）。
• 秘密门功能（默认禁用）。
• 使用 sqlite 数据库保存信息，无需额外设置。
• 地牢充满挑战，玩家需要盔甲、武器、食物和火把才能生存。
• 在战略位置设有特殊宝箱，提供额外战利品。
• 可配置的地牢布局和内容。
• 地牢大小/配置可调整，以适应玩家团队。
• 管理员可以轻松取消保护、重置、暂停、启用或填充地牢。
• 支持多个世界。

🔧命令列表

核心命令

• /catacombs 或 /cat

列出游戏内所有命令，是访问其他命令的主要入口。

规划与建造

• /cat plan <name> <depth> 或 /cat plan <name> <depth> <radius>

测试地牢的潜在建造位置。

• 小屋：你站立的位置将成为地牢入口小屋的中心，请确保周围有足够空间。
• 楼梯：检查你脚下两格开始，向下直到第一层底部（默认深度9格）是否有连续的“自然”材料垂直通道。
• 层级：从楼梯向东西南北方向检查，寻找足够的“自然”空间以构建地牢层级，最大范围由配置文件或命令中的 <radius> 参数决定。
• 更深层：规划多层地牢时，上述过程会重复，直到达到指定层数或遇到基岩。如果空间不足，规划将失败。
• 规划成功后，会收到包含每层大小和房间数的消息。未建造的规划在服务器重启后会被遗忘。

• /cat unplan <name>

删除一个已规划但未建造的地牢。常用于处理规划重叠的情况。

• /cat build <name>

将一个成功的规划转化为真实的 Minecraft 方块。必须在规划后使用。建议建造时远离规划点，以免被嵌入小屋墙壁。

• /cat scatter <name> <depth> <radius> <distance>

在当前位置随机方向、指定最大距离（<distance>）内，尝试规划并直接建造一个地牢。会尝试多次（30次）以寻找合适位置。

地牢管理

• /cat time <time> 或 /cat time <name> <time>

设置指定地牢（或你所在的地牢）的重置计时器。时间格式为数字加字母（s=秒, m=分, h=时, d=天），例如 5h30m。可设置为范围，如 5h30m-6h30m。设为 0s 可禁用自动重置。重置前5分钟开始对地牢内玩家发出警告。

• /cat when 或 /cat when <name>

查询指定地牢（或你所在/所看的地牢）的下次重置时间。

• /cat delete <name>

用普通石头填充地牢并移除保护。地牢内的玩家会被传送到入口小屋。此操作不可逆。

• /cat reset <name> 或 /cat reset

将地牢重置到初始状态：踢出所有玩家、清除怪物、关闭所有门、移除火把、重新填充宝箱。未指定名称则重置你所在的地牢。

• 限制：目前不会重建蜘蛛网、蘑菇和刷怪笼，建议用火把保护刷怪笼而非摧毁它。

• /cat resetall

重置所有世界中的所有地牢。

• /cat unprot <name>

保留地牢结构，但移除所有保护并忘记该地牢。此操作不可逆。

• /cat suspend <name> 或 /cat suspend

暂停指定地牢（或你所在的地牢）：打开灯光、停止怪物生成、禁用保护，以便管理员进行修改。

• /cat enable <name> 或 /cat enable

启用指定地牢（或你所在的地牢），是 suspend 的逆操作。

传送与信息

• /cat recall

单词召回。当玩家在最终层地牢宝箱附近（4格内）时，可将自己传送回地牢入口。适用于玩家。

• /cat goto <name> 或 /cat goto

将你传送到指定地牢（或你所在的地牢）的入口。适用于管理员。

• /cat end <name> 或 /cat end

将你传送到指定地牢（或你所在的地牢）的最终宝箱处。适用于管理员。

• /cat which 或 /cat ?

告诉你你所在（或所看）的地牢名称。如果地牢已取消保护或你不在任何地牢中，会相应提示。

• /cat list

按字母顺序列出游戏中所有已识别的地牢名称。

样式与杂项

• /cat style 或 /cat style <style>

查询或设置当前使用的地牢建造/战利品生成样式。例如，在 config.yml 中添加自定义样式（如 grand）后，使用 /cat style grand 切换。样式是服务器全局的，目前登出后会重置为 catacomb。

• /cat gold

查询你通过击杀地牢怪物获得了多少金币（需要经济系统支持）。

• /cat iron 或 /cat iron <name>

将你所在（或指定）地牢中的所有木门替换为铁门。

• /cat ironall

将所有地牢中的木门替换为铁门。

✨权限节点

管理员权限

• catacombs.admin - 授予所有命令的访问权限。
• catacombs.plan - 仅授予 /cat plan 命令权限。
• catacombs.build - 仅授予 /cat build 命令权限。
• catacombs.scatter - 仅授予 /cat scatter 命令权限。
• catacombs.delete - 仅授予 /cat delete 命令权限。
• catacombs.reset - 仅授予 /cat reset 命令权限。
• catacombs.unprot - 仅授予 /cat unprot 命令权限。
• catacombs.goto - 仅授予 /cat goto 命令权限。
• catacombs.end - 仅授予 /cat end 命令权限。
• catacombs.which - 仅授予 /cat which 命令权限。
• catacombs.suspend - 仅授予 /cat suspend 命令权限。
• catacombs.enable - 仅授予 /cat enable 命令权限。
• catacombs.style - 仅授予 /cat style 命令权限。
• catacombs.when - 仅授予 /cat when 命令权限。
• catacombs.list - 仅授予 /cat list 命令权限。

玩家权限

• catacombs.gold - 仅授予 /cat gold 命令权限。
• catacombs.recall - 仅授予 /cat recall 命令权限。

❓注意事项

• 此插件是原版的一个分支，可能存在一些错误，请在讨论区报告问题。
• 地牢地图信息会输出到服务器控制台和 plugins/Catacombs/maps 目录下。
• 规划时，你面朝的方向决定了入口小屋门的位置。