A simple elevator plugin. Primary features:
- Command free
- No configuration needed (but there if you want it!)
- Database free (Lifts are determined by block arrangements, nothing more)
- Multi floor elevators
- Multi passenger elevators, including mobs and dropped items
- Abstract elevator shaft shapes
- Redstone triggers
- Carpets can now be placed in any elevator floor. No more unsightly glass!
- All rails can now be put in shafts. Minecarts will now go up and down lifts and resume their previous speed upon arrival (this is largely untested, more feedback here is needed!)
How it works
No commands! No save file to worry about! It is easy to add, remove, or change floors. Just place or remove blocks! Lifts are made by scanning block arrangements are not saved or stored in memory after they are used. With the default configuration this is a fast process, less than 20 milliseconds.
Just drop the plugin in the plugin folder and play! No permissions to set up and the configuration is set up with defaults that will work for most servers. If you use a permission manager you might have to add add the permission "lift" and "lift.change" This is a bug in some managers
Here is the default configuration if you wish to play with the settings or language:
# Note: Smaller values result in less lag. Lift speed less than 0.4 may not work well for non spout servers. maxLiftArea: 16 maxHeight: 256 debug: false autoPlace: false preventEntry: false preventLeave: false checkGlass: false floorBlock: GLASS baseBlockSpeeds: IRON_BLOCK: 0.5 redstone: false STRING_oneFloor: "There is only one floor silly." STRING_currentFloor: "Current Floor:" STRING_dest: "Dest:" STRING_cantEnter: "Can't enter elevator in use" STRING_cantLeave: "Can't leave elevator in use"
- maxLiftArea is the number of connected blocks the lift can be. Larger values will result in a longer start up time when using a lift. Super large values can even freeze your server for a moment.
- maxHeight limits how tall an elevator can be.
- debug prints out extra information that can help me track down errors
- autoPlace will automatically position entities over the center of the base blocks which can prevent them from hitting edges and getting stuck
- preventEntry blocks players from entering moving lift.
- preventLeave blocks players from leaving a moving lift.
- checkGlass prevents glass duping. With it false the plugin will NOT check to make sure all the floors have all the glass blocks filled it, but will have better performance for busy servers.
- redstone can start a lift by using a redstone signal to the block behind the lift button. This can result in some lag on servers with a lot of pulsing redstone signals.
- baseBlockSpeeds is a list of blocks you wish to use in the elevator base and how fast they make the lift. Multiple block types can be added. For example:
baseBlockSpeeds: IRON_BLOCK: 0.5 GOLD_BLOCK: 0.75 DIAMOND_BLOCK: 1.0
This example has three different blocks that can be used as a base, with faster lifts being more expensive. Make sure there are two spaces for proper yaml formatting!
There are two permission nodes. By default both are set to true allowing anyone to use lifts right away:
- "lift" allow players be passengers and use lifts. To not let players use the lift, set lift to false in your permission plugin of choice.
- "lift.change" allow players to change destination floors of any lift. To not allow players to change the floor signs, set lift.change to false in your permission plugin of choice.
I will not be adding permissions to individual lifts. It is not possible with how the code works.
Usage With Default Config
1) Create the bottom floor with iron blocks. An elevator can be as small as 1 block or as big as 15 blocks in any shape. Smaller areas will have less lag. Make sure the lift iron blocks don't touch any other iron in the building
the plugin doesn't know the difference!
2) Next create the floor's control panel. On a wall place the following blocks. The signs and buttons must be "over" one of the iron base blocks.
- Required sign, leave blank for now
- Optional sign with floor name on first or second line
- Iron floor block you just placed.
3) Create the elevator shaft. To create a new floor platform use glass blocks instead of iron. Like the first floor over one of the glass blocks create the floor interface.
- Required sign, leave blank for now
- Optional sign with floor name on second line
4) Make sure the shaft is clear of all obstructions except for floor glass, buttons and signs. Torches and vines are also allowed in the elevator shaft.
5) To use your elevator right click the sign above the button to select a destination floor. The sign will automatically add the correct information.
If you find a bug or a feature not working as advertised please report to the ticket page. Bug reports in the comments will (probably) be ignored.
There is a config to adjust max lift area, lift height, lift speed, and a few other options. The defaults are sane and most people wont need to change them.
This plugin uses Hidendra wonderful MCStats library - a fantastic tool that shows plugin authors how their plugin is being used. Here is Lift's page so you can review what data has been collected, which is small compared to what the NSA probably has! You can opt of of the entire mcstats system by setting opt-out to true in plugins/PluginMetrics/config.yml
Q: Will you add build permissions?
A: No. Permissions are attached to players. An elevator is created by scanning a chunk for specific blocks in specific places. There is no easy way to stop a player from finishing an elevator without doing expensive, lag-causing calculations. To prevent a player from building an elevator you must prevent them from placing one of the elevator block types (iron block, sign, glass, or button). There are other plugins with this functionality.
Q: What are valid blocks to use inside the shaft?
A: Other than the glass blocks for the lift floors you play places torches, signs (ideal for sensors), buttons, vines, ladders, carpets, redstone, rails, and water.
Q: Will you add economy?
A: No. There are too many variations on how to do this and I want to keep the plugin focused and simple. There are other plugins you can use to add economy. One example is charging for button pressing:
You are getting errors with block X473 like:
1:34:32 [INFO] [Lift] [DEBUG] Starting elevator gen caused by: MXPLRS_Kirill v42 21:34:32 [INFO] ==Unknown Error== 21:34:32 [INFO] Yscan: 64 21:34:32 [INFO] Block: X473 21:34:32 [INFO] Is Valid Block: false 21:34:32 [INFO] Is Base Block: false 21:34:32 [INFO] [Lift] Player elevator generation returned a null object. Please report circumstances that generated this error.
The issue you are having is exceptionally likely to be due to Railcraft's tracking block (visible with the goggles as the tracking aura), you can disable it by setting block.hidden to 0 in Railcraft's config. The default ID of this block is 473.
- Date created
- Dec 01, 2011
- Last update
- Apr 06, 2014
- Development stage
- MIT License
- Curse link
- Recent files