Simple Elevators - 简易电梯

Simple Elevators 是一款名副其实的电梯插件，功能简单且易于使用。只需将插件拖入服务器，根据喜好编辑配置文件，即可轻松搭建各种电梯。电梯由两种方块组合定义，也支持单方块电梯。玩家站在电梯上按空格键上升一层，按潜行键下降一层，就是这么简单！

💡核心特性

• 开箱即用：安装后简单配置即可运行。
• 无限组合：可在配置文件中定义任意数量的方块组合来创建电梯。
• 世界白名单：可指定电梯仅在特定世界生效。
• 粒子箭头：可自定义上升/下降箭头的颜色和大小。
• 多种提示：可配置 BossBar、TitleBar 和 ActionBar 的提示消息。
• 电梯音效：包含标志性的电梯“叮”声，可自定义音效、音高和播放范围。
• 延迟与冷却：支持设置电梯运行延迟和使用冷却时间。
• 广泛兼容：兼容 Essentials 和 CMI 的 /back 命令。
• 交互消息：/elevator 命令提供包含悬停和点击事件的交互式消息。

🎮命令与权限

主命令：/elevator

别名：simpleelevators, elevators, se

所有子命令都需要 elevator.commands 权限以及对应的具体命令权限。

• /elevator [help] (别名: h)
• 打印可点击的帮助菜单，包含操作说明的悬停信息。
• 权限：elevator.commands.help
• /elevator create <组合> [距离] (别名: cr, c)
• 在当前位置创建指定的方块组合电梯。指定距离会在上方相应格数处创建另一个电梯。此命令会生成方块，请注意是否应给予玩家此权限。
• 权限：elevator.commands.create
• /elevator list (别名: li, l)
• 打印所有已配置电梯组合的可交互列表。
• 权限：elevator.commands.list

管理命令：/elevatoradmin

别名：simpleelevatorsadmin, elevatorsadmin, elevatoradmin, sea

所有子命令都需要 elevator.admin 权限。

• /elevatoradmin [help] (别名: h)
• 打印帮助菜单。
• /elevatoradmin info (别名: inf, i)
• 显示版本信息，并提供新版本和支持的快速链接。
• /elevatoradmin reload (别名: rel, r)
• 重新加载所有配置文件。

权限列表

• elevator.use
• 允许使用所有电梯组合。默认所有玩家都拥有此权限。
• elevator.use.<组合>
• 允许使用特定的电梯组合。
• elevator.distance.<距离>
• 为玩家设置独特的最大电梯距离。例如，全局 maxDistance 为 40，但拥有 elevator.distance.60 的玩家可以使用相距 60 格的电梯。
• elevator.bypass.cooldown
• 绕过配置的电梯冷却时间 elevatorCooldown。
• elevator.bypass.distance
• 忽略配置的最大距离 maxDistance。
• elevator.update
• 拥有此权限的玩家会在有新更新时收到通知。

🔧配置详解 (config.yml)

以下为配置文件的核心部分说明。

更新检查与基础设置

# 更新检查器，启用后会在控制台和OP玩家加入时提示新版本。
updateChecker: true

# 电梯方块组合。可以任意添加或修改。
# 语法: '材料:数据, 材料:数据' 或 '材料:数据'。
# 使用 'any' 代表任意方块（仅对底部方块有效），例如 'Quartz_Block, any'。
# 也可以省略第二个方块，效果相同，例如 'Quartz_Block'。
combinations:
  - 'Quartz_Block, Redstone_block'
  - 'Step:7, Iron_Block'
  - 'Carpet:14, Wool:11'
  - 'Stone:1, dirt:1'

# 世界白名单。添加世界名（区分大小写）以仅在这些世界启用电梯。
# 留空则在所有世界启用。
enabledworlds:

# 最大电梯距离。设置为 255 或更高则完全无视距离限制。
maxDistance: 40

# 创建电梯时是否替换目标位置的方块。
createReplace: true

音效、提示与粒子

# 电梯音效设置。支持 1.8 及更高版本的 Sound 枚举。
elevatorSound:
  up:
    enabled: true
    sound: "ORB_PICKUP"
    pitch: 0.5
    world: false # false 表示仅传送玩家可听到，true 表示范围内所有人都可听到
  down:
    enabled: true
    sound: "ORB_PICKUP"
    pitch: 1
    world: false

# ActionBar 设置
actionBarEnabled: true
floorUp: '&e&lYou have been taken one floor &a&lUP'
floorDown: '&e&lYou have been taken one floor &c&lDOWN'

# TitleBar 设置 (1.8+)
titleBarEnabled: true
floorUpTitle: '&a&lUP'
floorUpSubTitle: ''
floorDownTitle: '&c&lDOWN'
floorDownSubTitle: ''
titleBarFadeIn: 5
titleBarStay: 10
titleBarFadeOut: 5

# BossBar 设置 (不支持 1.8)
bossBarEnabled: true
bossBarColor: RED
bossBarStyle: SOLID
bossBarMessage: '&eFloor %floor% of %totalFloors%' # 占位符：%floor% 当前楼层，%totalFloors% 总楼层

# 箭头粒子设置 (不支持 1.8)
arrow_enabled: true
arrow_currentFloor: true
arrow_destinationFloor: true
arrow_color_up: 'green'
arrow_color_down: 'red'
arrow_size: 2.0

高级功能与杂项

# 电梯将忽略检查的物品列表。这些物品可以放置在目标位置。
# 使用有效的 Material 名称。设置为 'all' 则忽略所有物品。
ignoreList: 'air, torch, lever, stone_button, redstone_torch_on, redstone_torch_off, vine, wood_button, banner, sign, sign_post, wall_sign'

# 电梯延迟（单位：刻，20刻=1秒）。玩家在延迟结束前离开电梯则传送取消。
delay: 0
elevatorDelayMessage: '&a&lElevation in %seconds% seconds!' # 延迟倒计时消息
elevatorCanceledMessage: '&c&lElevation canceled!' # 取消传送消息

# 电梯使用冷却时间（单位：刻，20刻=1秒）。
elevatorCooldown: 0
elevatorCooldownMessage: '&cPlease wait %cooldown% seconds before using an elevator again!' # 冷却提示消息，留空则禁用

# 是否在电梯列的上方和/或下方额外检查一个非电梯楼层。
lazyCheck:
  top: false
  bottom: false

✨安装与使用

安装步骤

• 将 Elevator.jar 放入服务器的 plugins 文件夹。
• 启动或重启服务器。
• 根据需求编辑生成的配置文件。

使用方法

• 根据配置，用指定的方块组合搭建电梯（例如，脚下是石英块，头上是红石块）。
• 玩家站在底部方块上。
• 按 空格键 (Space) 上升一层。
• 按 潜行键 (Shift) 下降一层。

支持版本

• 当前支持 Minecraft 1.8 至 1.20。
• 请注意，ActionBar 和 BossBar 功能在 1.8 版本中不可用。

测试服务器

• 地址：66.70.238.175:25596

插件信息

• 开发者：Benz56 (@SoulStriker_ 等)
• 当前文档基于版本：3.5.3 (Spigot 1.13.2) 至 3.10.7