Lift - 简易电梯插件

💡简介

Lift 是一个简单易用的电梯插件，无需命令或复杂配置即可运行。它通过扫描方块结构来动态创建电梯，支持多楼层、多乘客运输，甚至可运送生物和掉落物。

🎮核心特性

• 无需命令：完全通过放置方块来创建和管理电梯。
• 零配置开箱即用：提供默认配置，满足大多数服务器需求，同时也支持自定义。
• 无需数据库：电梯结构不会被保存，每次使用时动态扫描，节省资源。
• 多楼层电梯：可轻松构建连接多个楼层的电梯系统。
• 多乘客运输：可同时运送玩家、生物以及掉落在电梯内的物品。
• 灵活电梯井形状：电梯井结构不受严格限制。
• 红石触发：可通过红石信号激活电梯按钮。
• 地毯兼容：现在可以在任何电梯楼层放置地毯，无需再使用玻璃。
• 铁轨兼容：所有铁轨现可置于电梯井中，矿车可随电梯上下并保持原有速度（此功能测试有限，欢迎反馈）。

❓工作原理

插件不存储任何电梯结构数据。当玩家使用电梯时，插件会实时扫描周围的方块布局来识别电梯。默认配置下，此过程快速高效，通常耗时少于 20 毫秒。这使得添加、移除或修改楼层变得非常简单，只需放置或破坏方块即可。

🔧安装与权限

安装

直接将插件 JAR 文件放入服务器的 plugins 文件夹，然后重启服务器即可。

权限节点

默认情况下所有玩家均可使用电梯。若使用权限管理插件，可能需要手动添加以下节点：

• lift：允许玩家作为乘客使用电梯。
• lift.change：允许玩家修改任何电梯的楼层目标（即修改楼层标志）。

注意：某些权限管理器存在 Bug，可能需要您手动添加这些权限。插件无法为单个电梯设置独立权限。

✨默认配置说明

以下是默认配置文件内容，您可以根据需要调整

# 注意：较小的值可减少延迟。对于非 Spout 服务器，电梯速度低于 0.4 可能运行不佳。
maxLiftArea: 16
maxHeight: 256
debug: true
autoPlace: false
preventEntry: false
preventLeave: true
checkFloor: false
liftMobs: true
floorBlocks:
- GLASS
- '*_STAINED_GLASS'
redstone: false
STRING_oneFloor: There is only one floor.
STRING_currentFloor: Current Floor
STRING_dest: §1Dest
STRING_cantEnter: Can't enter elevator in use
STRING_cantLeave: Can't leave elevator in use
baseBlockSpeeds:
  IRON_BLOCK: 0.5

关键配置项说明

• maxLiftArea：电梯的最大连接方块数。值越大，电梯启动时的扫描时间越长，极端情况可能导致服务器短暂卡顿。
• maxHeight：电梯的最大高度限制。
• debug：启用调试模式，输出额外信息以帮助排查错误。
• autoPlace：自动将实体定位在电梯基座方块中心，防止其卡在边缘。
• preventEntry：阻止玩家进入运行中的电梯。
• preventLeave：阻止玩家离开运行中的电梯。
• checkFloor：设置为 false 可提升繁忙服务器的性能，但不会检查各楼层玻璃地板是否完整（可能防止玻璃复制漏洞）。
• redstone：允许通过向电梯按钮后的方块发送红石信号来启动电梯。在红石脉冲频繁的服务器上可能产生延迟。
• floorBlocks：定义可用作楼层地板的方块列表。 是通配符，例如 _STAINED_GLASS 匹配所有染色玻璃。
• baseBlockSpeeds：定义可用作电梯基座的方块及其对应的上升/下降速度。您可以添加多种方块，例如：

    baseBlockSpeeds:
      IRON_BLOCK: 0.5
      GOLD_BLOCK: 0.75
      DIAMOND_BLOCK: 1.0

这允许使用三种不同成本的基座方块，钻石块速度最快。请确保使用两个空格进行正确的 YAML 格式缩进。

⭐使用教程（默认配置）

• 建造底层基座

用铁块（IRON_BLOCK）建造底层平台。电梯最小可为 1x1，最大面积受 `maxLiftArea` 限制。确保电梯的铁块不与建筑中其他铁块相连，以免插件识别错误。

• 创建底层控制面板

在紧邻底层铁块的墙面上，从下往上放置以下方块（按钮和标志必须“正对”一个基座铁块）：

- 最下层：您刚刚放置的铁块（基座）。

- 往上一格：空气。

- 再往上一格：按钮。

- 最顶层：标志（第一行可留空或填写楼层名称）。

• 建造电梯井及上层楼层

向上建造电梯井。要创建新楼层平台，请使用玻璃块（或配置中允许的方块）代替铁块。在每个楼层的玻璃块旁，重复步骤 2 创建该楼层的控制面板（标志-按钮-空气-玻璃地板）。

• 保持电梯井畅通

确保电梯井内除了楼层玻璃、按钮、标志外，没有其他障碍物。允许放置的物品包括：火把、藤蔓、梯子、地毯、红石、铁轨和水。

• 使用电梯

右键点击按钮上方的标志来选择目标楼层。标志会自动更新显示目的地信息。

💡重要提示

配置文件允许调整电梯最大面积、高度、速度等选项。默认值适用于大多数情况，通常无需更改。

❓常见问题

问：会为单个电梯添加建造权限吗？

答：不会。因为权限依附于玩家，而电梯是由方块布局动态生成的，技术上无法实现。

问：电梯井内可以放哪些方块？

答：除了用作地板的玻璃块外，您还可以放置火把、标志（适合做传感器）、按钮、藤蔓、梯子、地毯、红石、铁轨和水。

问：会添加经济系统吗？

答：不会。请使用其他能为按钮添加收费功能的插件来实现经济系统。