Better Elevators

Elevators deployed by players with this permission do not require power.Permission not required if you have set "RequirePermissionForPowerless": false in the plugin configuration.

Elevators deployed by players with this permission automatically have a counter attached to the lift which shows the current floor and can be used to select a destination floor.Permission not required if you have set "RequirePermissionForLiftCounter": false in the plugin configuration.The counter cannot be used while building blocked, or used to select a floor higher than 100, due to client-side limitations.

Permission not required if you have set "RequirePermissionForPowerless": false in the plugin configuration.

Permission not required if you have set "RequirePermissionForLiftCounter": false in the plugin configuration.

The counter cannot be used while building blocked, or used to select a floor higher than 100, due to client-side limitations.

The following permissions come with this plugin's default configuration. Granting one to a player allows them to build elevators with at most that many floors.

betterelevators.maxfloors.10

betterelevators.maxfloors.15

betterelevators.maxfloors.20

betterelevators.maxfloors.100

You can add more max floor presets in the plugin configuration (MaxFloorsRequiringPermission), and the plugin will automatically generate permissions of the format betterelevators.maxfloors.<number> when reloaded. If a player has permission to multiple max floor presets, only the last one will apply (based on the order in the config).

Note: The permission is checked when you try to deploy the elevator, meaning you can build on top of any elevator to your allowed height, even if the original owner did not have permission to build as high as you can.

The following permissions come with this plugin's default configuration. Granting one to a player alters the speed of elevators they deploy.

betterelevators.speed.2x

betterelevators.speed.3x

betterelevators.speed.4x

betterelevators.speed.1x.quadratic

betterelevators.speed.1.5x.quadratic

betterelevators.speed.2x.quadratic

betterelevators.speed.1x.cubic

betterelevators.speed.2x.cubic

You can add more speed presets in the plugin configuration (SpeedsRequiringPermission), and the plugin will automatically generate permissions of the format betterelevators.speed.<name> when reloaded. If a player has permission to multiple speed presets, only the last one will apply (based on the order in the config).

The quadratic (x²) and cubic (x³) presets will accelerate and decelerate to travel long distances more quickly. The 1x.quadratic and 1x.cubic presets are configured to take the same amount of time as vanilla elevators when moving only one floor at a time, but they will be much more time efficient when moving multiple floors at once (e.g., when using the "To Top" and "To Bottom" buttons, or when using the lift counter to move to a specific floor).

Note: Speed permissions are based on the owner of the top elevator. It's recommended to use the EnsureConsistentOwner configuration option (on by default) so that each elevator always copies the owner from the one below it for more predictable behavior.

Default configuration:

{ "DefaultMaxFloors": 6, "MaxFloorsRequiringPermission": [ 10, 15, 20, 100 ], "RequirePermissionForPowerless": true, "RequirePermissionForLiftCounter": true, "MaintainLiftPositionWhenHeightChanges": false, "EnsureConsistentOwner": true, "EnableSpeedOptions": true, "DefaultSpeed": { "BaseSpeed": 5.0, "EaseType": "Linear" }, "SpeedsRequiringPermission": [ { "Name": "2x", "BaseSpeed": 10.0, "EaseType": "Linear" }, { "Name": "3x", "BaseSpeed": 15.0, "EaseType": "Linear" }, { "Name": "4x", "BaseSpeed": 20.0, "EaseType": "Linear" }, { "Name": "1x.quadratic", "BaseSpeed": 0.86, "EaseType": "Quadratic" }, { "Name": "1.5x.quadratic", "BaseSpeed": 1.29, "EaseType": "Quadratic" }, { "Name": "2x.quadratic", "BaseSpeed": 1.72, "EaseType": "Quadratic" }, { "Name": "1x.cubic", "BaseSpeed": 0.72, "EaseType": "Cubic" }, { "Name": "2x.cubic", "BaseSpeed": 1.44, "EaseType": "Cubic" } ], "StaticElevators": { "EnableCustomSpeed": false, "Speed": { "BaseSpeed": 3.5, "EaseType": "Linear" }, "EnableLiftCounter": false } }

The max number of floors allowed per elevator, unless the player building it has been granted permissions for a different number of max floors.

List of numbers used to automatically generate permissions of the format betterelevators.maxfloors.<number>. Granting one to a player allows them to build elevators with at most that many floors.

RequirePermissionForPowerless (true or false) -- While true, players must have the betterelevators.powerless permission for their elevators to not require power. While false, no elevators require power.

RequirePermissionForLiftCounter (true or false) -- While true, players must have the betterelevators.liftcounter permission for their elevators to spawn with a lift counter. While false, all player elevator lifts spawn with a counter.Note: Static elevators have a separate option for enabling the lift counter.

MaintainLiftPositionWhenHeightChanges (true or false) -- While true, 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.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 false) -- While true, deploying an elevator on top of another will assign the new elevator's OwnerID 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.

EnableSpeedOptions (true or false) -- Determines whether this plugin controls the speed of player elevators.Set to true to use the DefaultSpeed and SpeedsRequiringPermission options below.Set to false to prevent this plugin from controlling the speed of player elevators. This is useful if you want another plugin to control elevator speed.Note: Static elevators have a separate configuration option for controlling speed below.

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.

List of speed presets for use with permissions. A permission is automatically generated for each entry using the format betterelevators.speed.<name>. Granting one to a player causes elevators they deploy to move at the configured speed.See the Speed presets section for the available options of each speed preset.

Settings for static elevators (the ones for accessing undergorund train tunnels).EnableCustomSpeed (true or false) -- Determines whether this plugin controls the speed of static elevators.Set to true to use the Speed option below.Set to false to use vanilla speed.Speed -- Speed preset that will apply to all static elevators if EnableCustomSpeed is true.BaseSpeed -- See the Speed presets section for details.EaseType -- See the Speed presets section for details.EnableLiftCounter (true or false) -- Whether static elevators should have attached lift counters.

Note: Static elevators have a separate option for enabling the lift counter.

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.

Set to true to use the DefaultSpeed and SpeedsRequiringPermission options below.

Set to false to prevent this plugin from controlling the speed of player elevators. This is useful if you want another plugin to control elevator speed.

Note: Static elevators have a separate configuration option for controlling speed below.

See the Speed presets section for details.

See the Speed presets section for details.

See the Speed presets section for the available options of each speed preset.

EnableCustomSpeed (true or false) -- Determines whether this plugin controls the speed of static elevators.Set to true to use the Speed option below.Set to false to use vanilla speed.

Speed preset that will apply to all static elevators if EnableCustomSpeed is true.BaseSpeed -- See the Speed presets section for details.EaseType -- See the Speed presets section for details.

EnableLiftCounter (true or false) -- Whether static elevators should have attached lift counters.

Set to true to use the Speed option below.

Set to false to use vanilla speed.