特征
- 建造超过 6 层的电梯，而无需玩家运行命令。Limit 可以全局配置，也可以基于权限配置。
- 无动力电梯，可选择基于许可。
- 可配置的电梯速度，可选加减速。速度可以全局配置，也可以基于权限配置。
- 可以选择将电梯保持在当前位置，因为在其上方添加或删除电梯。
- 可以选择为每个电梯电梯附加一个计数器，该计数器显示当前楼层并允许玩家选择目标楼层。
权限
此插件使用权限系统。要分配权限，请使用 。要删除权限，请使用 。oxide.grant <user or group> <name or steam id> <permission>oxide.revoke <user or group> <name or steam id> <permission>- betterelevators.powerless-- 拥有此权限的玩家部署的电梯不需要电源。
- 如果您在插件配置中设置了权限，则不需要权限。"RequirePermissionForPowerless": false
- betterelevators.liftcounter-- 具有此权限的玩家部署的电梯会自动在电梯上附加一个计数器，该计数器显示当前楼层，并可用于选择目标楼层。
- 如果您在插件配置中设置了权限，则不需要权限。"RequirePermissionForLiftCounter": false
- 由于客户端限制，该计数器不能在建筑物被封锁时使用，也不能用于选择高于 100 的楼层。
最大楼层权限
此插件的默认配置附带以下权限。给玩家一个可以让他们建造最多有那么多楼层的电梯。- betterelevators.maxfloors.10
- betterelevators.maxfloors.15
- betterelevators.maxfloors.20
- betterelevators.maxfloors.100
注意：当您尝试部署电梯时，将检查权限，这意味着您可以在任何电梯的顶部建造到您允许的高度，即使原始所有者没有建造尽可能高的权限。
速度权限
此插件的默认配置附带以下权限。授予玩家一个会改变他们部署的电梯的速度。- betterelevators.speed.2x
- betterelevators.speed.4x
- betterelevators.speed.1x.quadratic
- betterelevators.speed.1.5x.quadratic
- betterelevators.speed.2x.quadratic
- betterelevators.speed.1x.cubic
- betterelevators.speed.2x.cubic
二次 （x²） 和三次 （x³） 预设将加速和减速以更快地长距离行驶。和预设配置为一次只移动一层时花费与原版电梯相同的时间，但是当一次移动多个楼层时（例如，当使用 “To Top” 和 “To Bottom” 按钮时，或者当使用电梯计数器移动到特定楼层时），它们将更加省时。1x.quadratic1x.cubic
注意：速度权限基于顶部升降装置的所有者。建议使用配置选项 （默认打开），以便每个升降装置始终从其下方的升降装置复制所有者，以实现更可预测的行为。EnsureConsistentOwner
配置
默认配置：
- DefaultMaxFloors -- The max number of floors allowed per elevator, unless the player building it has been granted permissions for a different number of max floors.
- MaxFloorsRequiringPermission -- List of numbers used to automatically generate permissions of the format . Granting one to a player allows them to build elevators with at most that many floors.betterelevators.maxfloors.<number>
- RequirePermissionForPowerless (true or ) -- While , players must have the permission for their elevators to not require power. While , no elevators require power.falsetruebetterelevators.powerlessfalse
- RequirePermissionForLiftCounter (true or ) -- While , players must have the permission for their elevators to spawn with a lift counter. While , all player elevator lifts spawn with a counter.falsetruebetterelevators.liftcounterfalse
- Note: Static elevators have a separate option for enabling the lift counter.
- MaintainLiftPositionWhenHeightChanges (true or ) -- While , causes the lift to keeps its position and movement destination when an elevator is added or removed above it. This avoids the annoying vanilla behavior where the lift is destroyed and rebuilt at the top every time the height changes.falsetrue
- Tip: You can combine this behavior with powerless elevators to continuously build upward by alternating between deploying an elevator above you and moving the lift upward.
- EnsureConsistentOwner (true or ) -- While , deploying an elevator on top of another will assign the new elevator's to the same value as the elevator below it, instead of using the deploying player's steam id. This improves the predictability of permission-based features, especially speed, by effectively ensuring that the player who placed the bottom elevator determines the elevator's capabilities.falsetrueOwnerID
- EnableSpeedOptions (true or ) -- Determines whether this plugin controls the speed of player elevators.false
- Set to to use the and options below.trueDefaultSpeedSpeedsRequiringPermission
- Set to to prevent this plugin from controlling the speed of player elevators. This is useful if you want another plugin to control elevator speed.false
- Note: Static elevators have a separate configuration option for controlling speed below.
- DefaultSpeed -- This speed preset applies to all player elevators except those belonging to players that were granted access to presets in .SpeedsRequiringPermission
- BaseSpeed -- See the Speed presets section for details.
- EaseType -- See the Speed presets section for details.
- SpeedsRequiringPermission -- List of speed presets for use with permissions. A permission is automatically generated for each entry using the format . Granting one to a player causes elevators they deploy to move at the configured speed.betterelevators.speed.<name>
- See the Speed presets section for the available options of each speed preset.
- StaticElevators -- Settings for static elevators (the ones for accessing undergorund train tunnels).
- EnableCustomSpeed (true or ) -- Determines whether this plugin controls the speed of static elevators.false
- Set to to use the option below.trueSpeed
- Set to to use vanilla speed.false
- Speed -- Speed preset that will apply to all static elevators if is .EnableCustomSpeedtrue
- BaseSpeed -- See the Speed presets section for details.
- EaseType -- See the Speed presets section for details.
- EnableLiftCounter (true or ) -- Whether static elevators should have attached lift counters.false
- EnableCustomSpeed (true or ) -- Determines whether this plugin controls the speed of static elevators.false
Speed presets
每个速度预设都支持以下选项。- BaseSpeed-- 基础移动速度（原版速度适用于玩家电梯，适用于静态电梯）。如果设置为 或 ，则总旅行时间将除以此数字。1.53.5EaseType"Quadratic""Cubic"
- EaseType ("Linear"或"Quadratic""Cubic")
- 设置为 （vanilla/default） 可使电梯以恒定速度移动（值为 ）。"Linear"BaseSpeed
- 设置为 （recommended） 可使电梯加速/减速 （x² 速度）。"Quadratic"
- 设置为 使升降机加速/减速得更快 （x³ 速度）。"Cubic"
传统速度选项
每个速度预设仍允许以下选项以实现向后兼容性。这些可能会在未来的版本中删除。这些选项仅适用于 EaseType： “Linear”，并且在将来的版本中不太可能更改。- SpeedIncreasePerFloor-- 这会导致电梯在开始移动时根据与目标楼层的距离动态计算电梯速度。这不会导致加速。
- 行驶 1 层将使用 。BaseSpeed
- 一次行驶 2 层将使用 。BaseSpeed + SpeedIncreasePerFloor
- 行驶 3 层将使用 。BaseSpeed + (2 * SpeedIncreasePerFloor)
- 等等......
- MaxSpeed-- 考虑到 时电梯电梯可以达到的最大速度。SpeedIncreasePerFloor
地方化
开发人员 Hook
OnElevatorFloor选择
- 当玩家选择了带有升降计数器的目标楼层时调用。
- 返回将阻止电梯移动。false
- 返回将导致默认行为。null
注意：该 是从 0 开始的，因此如果玩家输入 ，则为 。targetFloor1targetFloor0
