[MECH] Elevators [BukkitDev]

Discussion in 'Archived: Plugin Releases' started by Cybran, Jan 27, 2011.

  1. Offline

    Cybran

    [​IMG]

    The plugin will be continued at dev.bukkit.org!
    Want to help? Sign up as an alpha- or beta-tester!


    What this plugin does:

    It creates vertical moving elevators, which can be controlled by redstone-powered blocks.

    Features (open)

    • Creating elevators with an individual size (square or rectangle shape).
    • Floor-management: define your own floors with their own names, being able to call an elevator on every floor by – per example – pressing a button.
    • Movement-triggers: control the elevator with redstone circuits or buttons or any other redstone-powered block!
    • Elevator movement-controls: have different buttons for moving the elevator up and down, skip floors by pressing a control button several times.
    • Command-queuing: the elevator will move to the different floors one after the other if it gets more than one command at the same time.
    • Build on the elevator whatever you want (nearly ;))
    • Use redstone outputs to link the elevator to iron doors or more complex circuits.
    • Connect the elevator to your minecart system!
    • Use the elevator as something else, like a lava door.
    • Build automtically opening/closing glass doors around or on your elevator!
    • Protect your elevator with a password or user restriction.
    • Permissions support!

    How to install (open)

    • The server mod:
      Just copy the Elevators.jar into your plugins/ folder. That's it. You can modify the config later (See section Tutorials>Configuration).
    • ???

    FAQ (open)

    • Q: I'm completely new to this plugin! What shall I do?
      A: First, install the mod (see How to install), then you can read the basic tutorials in the tutorial section below.
    • Q: I'm sick of using buttons all the time to control the elevator! I want to include my redstone circuits!
      A: You don't have to use buttons! You can right-click any type of redstone-powered block! The buttons are just the easiest way.
    • Q: I want to build several buttons or other blocks for the SAME floor! How to do it?
      A: Have a look at the "direct" command. It links other blocks to an already existing floor.
    • Q: I try to build a lava door, but the lava is transported with the elevator! How can I let displace the lava by the elevator?
      A: At first, build the elevator like it should be later. Then, use the command /elev lock. Now your elevator will not grab any blocks or fluids placed later on it.
    • Q: Is there a size limitation for the elevator's shape?
      A: Yes. Normally, there is a maximum for the area of 25 blocks. But: you can change this limitation in the config.

    Command usage & Permissions (open)

    [...] = optional parameter. ...|... = select ONE of the values, they all mean the same. <...> = put your own values here.

    /elevators|elevator|elev <command from the list below>

    The basic commands:
    • help|? - shows the commands.
    • permission|permissions - shows your current permission level.
    • create - creates a new elevator at your current position.
    • remove - removes an existing elevator from your current position.
    • call|floor <Floorname> - creates a new floor with the given Floorname.
    • up - creates a new UpBlock, right-click to select block after command.
    • down - creates a new DownBlock, right-click to select block after command.
    • go|direct [<Floorname>] - creates a new link to the given floor or the nearest. Toggled by redstone input. Right-click a block.
    • redstoneout [<Floorname>] - creates a redstoneoutput, right-click to select the output block after. Has to be a lever.
    • glassdoor [<Floorname>] - Type command and place glass blocks. A door will be created to the given floor or the nearest. Use /elev finish to finish and disable glass block listener.
    • glassremove [<Floorname>] - Removes all glass blocks linked to the given floor or from the cabin when no floor is specified.
    • finish - Finishes an action (like glassdoor placement).
    • info - creates debugging info file. CONSOLE ONLY.
    • lock - locks the cabin blocks to stop updating before every movement.
    The more advanced ones:
    • help|? - shows the commands.
    • permission|permissions - shows your current permission level.
    • create [password <Password>] [users <Username1> <Username2> <UsernameN>]- creates a new elevator at your current position, optional with password or user whitelist.
    • remove - removes an existing elevator from your current position.
    • call|floor <Floorname> [password <Password>] [users <Username1> <Username2> <UsernameN>] - creates a new floor with the given Floorname, optional with password or user whitelist.
    • up - creates a new UpBlock, right-click to select block after command.
    • down - creates a new DownBlock, right-click to select block after command.
    • go|direct [<Floorname>] - creates a new link to the given floor or the nearest. Toggled by redstone input. Right-click a block.
    • redstoneout [<Floorname>] - creates a redstoneoutput, right-click to select the output block after. Has to be a lever.
    • glassdoor [<Floorname>] [direction <DirectionIdentifier>] - Type command and place glass blocks. A door will be created to the given floor or the nearest. Use /elev finish to finish and disable glass block listener. You can use a DirectionIdentifier (left,right,up,down,splitH,splitV) to set the opening direction manually.
    • glassremove [<Floorname>] - Removes all glass blocks linked to the given floor or from the cabin when no floor is specified.
    • finish - Finishes an action (like glassdoor placement).
    • info - creates debugging info file. CONSOLE ONLY.
    • pw|password [<Floorname>] [password <Password>] - Overrides password protection for the given floor or the whole elevator.
    • user [<Floorname>] [users <Username1> <Username2> <UsernameN>] - Overrides user whitelist for the given floor or the whole elevator.
    • give [<Username>] - changes the owner of the elevator. Once changed, a reset is not possible.
    • lock - locks the cabin blocks to stop updating before every movement.
    Permission nodes:
    • elevators.builder - basic permission level, user can set up elevators.
    • elevators.advancedbuilder - advanced permission level, user can protect elevators with password / user list.
    • elevators.operator - ignores owner, passwords and user restrictions, can modify everything.

    Tutorials (open)

    Basic setup:
    • Prepare a shaft – size can be between 1x1 up to 5x5. There has to be air in the whole shaft(means also no ladders and no torches directly on the wall).
    • Build a plain of any block type in your shaft as the elevator’s ground. (I would recommend to use a block type that is not placed anywhere in the shaft again with the same shape.)
    • Stand on the ground while typing /elevator create
    • A new floor and a new “CallBlock” (to call the elevator later) are created simultaneously by first typing /elevator call <Floorname> and then right-clicking on a (already existing!!) button. The elevator will halt 2 stones below this block
    • You have to create Up- and DownBlocks (to control the elevator) on every floor OR (better) inside the elevator. Type /elevator up or /elevator down , then right-click on a button (again the buttons have to be created BEFORE).
    • Create as many floors as you want. Besides: the control-blocks can be up to 2 blocks away from the elevator
    • Now you are ready to use the elevator!
    • If you want to remove floors or control-blocks, simply destroy the blocks.
    • If you want to remove the whole elevator, stand nearby and type /elevator remove.
    Configuration:
    • After the first server startup with the plugin v1.3+, a new file named Configuration.txt is created in plugins\Elevators\
    • Feel free to modify the values in there. But keep to the given format.
    • restart the server (or use /reload command) to apply the changes.
    Enhanced redstone:
    • If you want, you can extend your calling mechanism, per example by using stone plates connected to redstone wire.
    • To make your elevator moving to a specific floor, type /elevator direct <Floorname> and right-click any redstone wire or button or stone plate...
    • You can also use /elev direct WITHOUT the floorname. This will lead to the next floor in range.
    • If you want, you can add a redstone output to the elevator. Build a LEVER near to the elevator, then type /elev redstoneout and right-click the lever. Connect the lever to your circuit with redstone wire.
    Glass doors for your elevator:
    • Type /elev glassdoor [<Floorname>] [direction <DirectionIdentifier>] to start.
    • You can use a DirectionIdentifier (left,right,up,down,splitH,splitV) to set the opening direction manually. left and right are seen from outside the elevator. splitH and splitV will let the door split horizontally or vertically from the center.
    • Now build glass blocks around the elevator or on the elevator. Use any shape you want.
    • Type /elev finish to stop adding blocks as doors.
    • Call the elevator again to the floor where you built the door. Your created door opens.
    • The door is now activated and will open and close automatically. Have fun!
    Elevator protection (advanced builders):
    • every created elevator has an owner. Only the owner can modify the elevator. To change the owner, type "/elev give <newownername>". To enable modification for every player, type "/elev give". This will remove any owner protection.
    • use the optional parameters to create an elevator/floor with protection, p.e. "/elev floor testing floor password ultimatepassword users NTcomputer Notch" would create a new floor named "testing floor" with the password "ultimatepassword", only available for the users NTcomputer and Notch.
    • modify your protection settings with the commands /elev user and /elev password, p.e.: "/elev user testing floor users Admin" will override the previous settings to only allow user Admin the usage.
    • remove protection settings? Very easy: use /elev password or /elev user without any parameters or floorname only to reset the protection.
    • so far the whitelist, but I want to create a blacklist. How to? Like this: "/elev user testing floor users * -griefer" (no, there isn't any space between the minus and the player - damn line break). * means everybody can use it, the "-" before a name indicates you hate this player and don't want to let him destroy your secret room on the testing floor ;)
    • I have set up the protection, but I'm never asked for a password?! This can have several reasons: 1.) You are an operator. 2.) You have the permission elevators.operator 3.) You are the owner of the elevator. Just let somebody else try, he WILL get a prompt. 4.) You are standing near the elevator while another player tries to use it. He/she won't be blocked.

    Known issues (open)

    • It is difficult to move yourself or turn around while moving with an elevator.
    • Don't use doors on an elevator! They will "clone" items.
    • Pressure plates don't work as Up- /DownBlocks directly. Build at least two redstone to them, type the command and right-click the end of the wire.
    • Avoid using up/down in circuits. This will force any selected redstone-block to remain in off-state. (You can use "direct", though!)

    Future Ideas (open)

    • name elevators - v1.4.4
    • signs with current floor - v1.4.5
    • allow any block type for doors - v1.4.5
    • iConomy support - coming in v1.5

    Changelog (server mod) (open)

    • Version 1.4.3 (RB #740)
      >>Download<<
      -implementation of the secret project (not useable yet)
      -fixed the chest duplication bug
      -fixed the powered/detector rail dropping bug
      -enabled plugin usage for subfolder-worlds
      -fixed some other exceptions
    • Version 1.4.2 (RB #670)
      >>Download<<
      -elevators are now stored in the world folders (-> allow backups)
      -items will drop when moved away from a wall
      -added forbidden blocks to config
      -added command abbreviations to config
      -added glassdoor directions
      -added "lock" for cabin blocks
      -prevent block changes while elevator moves
      -added more config options and messages
    • Version 1.4.1 (RB #602)
      >>Download<<
      -cabin blocks are now searched when initiating movement
      ->WorldEdit & Co for cabin blocks supported!
      -Entities are now moved along, even if they are positioned a greater distance above the ground blocks
      -merged direct and extend commands
      -enabled relative glass doors (=doors in the cabin)
      -glass doors are now "grouped" automatically for a more real opening order
      -redstone outputs floor parameter added.
      -ground blocks pending between grass and dirt are not blocking the elevator anymore
      -wheat, cactus and sugar cane item duplication bug fixed
    • Version 1.4 (RB #556)
      -Permissions support added
      -elevator and floor protection added
      ->many new commands and command parameters
      -command to remove glass doors from a specific floor
      -owner system added
      -individual elevator size support
      -fixed some bugs (can't remember which)
    • Version 1.3.1:
      >>Download<<
      -removed TSLPC
      -added go|direct command
      -improved elevator search
      -improved elevator position search (prevention of loosing the ceiling ;-))
      -storing entity positions when initiating moving - hopefully fixes fall-through bugs
      -added info console command to create debugging info files
      -binds glass doors to a command
      -fixed button and redstone bugs
      -improved storage cleanup
    • Version 1.3:
      -added automatically closing glass doors.
      -added configuration.
      -fixed a fault timing.
      -changed the command handler to onCommand in main file.
    • Version 1.2.3:
      -fixed a block checking bug.
      -redstone on the elevator is now working.
    • Version 1.2.2:
      -chests and dispensers are now working.
      -furnaces are now working.
      -adjacent mine tracks are now working.
      -item orientation bugfix.
    • Version 1.2.1:
      -color of wool is now stored.
      -Signs are now working inside the elevator.
      -orientation of levers, buttons, torches etc. is now stored (can still be glitchy, cause multiplayer servers always have problems with that)
      -fixed many bugs for the blocks built on the elevator
      -elevator blocks can be safely removed by iStick, Superpickaxe and others now
      -improved the movement system for liquids (enables lava doors and more!)
      -improved the movement system for all entities (creatures and minecarts will also be transported now)
      -elevator movement is now much smoother
      -improved floor search for up- and down-blocks when the elevator got stuck
      -changed the entire storage system
    • Version 1.2:
      - enabled building on the elevator.
      - created redstone outputs
      - fixed server crashes
      - made compatible to CraftBukkit 289+
      - improved handling of breaked blocks
      - made plugin thread-secure
      -fixed path problems on mac + linux
      - and maybe some others...
    • Version 1.1:
      - made the creation a bit easier.
      - fixed some bugs
      - increased the maximum size to 5x5
    • Version 1.0:
      - Release
     
  2. Offline

    AnrDaemon

    For each floor you desire, create an "/elev redstoneout" cirquit to the button directing it to the chosen level.
    More about redstone wiring on Minecraft wiki.

    OMGOMGOMG It works like a charm! Now I have a pressure pad calling elevator to the basement level! No more troubles finding a body part to press the button, when your hands full of stuff :D Just walk into it and it'll be there!
    OMG I could even create a plate on the elevator to move it... *gasp* well... There's one problem. It spam "elevator reached <floor>" as long as you standing on pressure pad.
     
  3. Offline

    jimbo8

    Very buggy. Is there any way to fix that? Thanks. - Jimbo8.
     
  4. Offline

    AnrDaemon

    Very stupid comment. Is there any clarification as to what EXACTLY you are trying to do?
     
  5. Offline

    Cybran

    No, it's no bug, but the feature is arriving in v1.4 [​IMG]. Please be patient.

    The pressure plate is sending a repeated signal, so you get repeated messages [​IMG]. To avoid it, a redstone wire (at least 2 length) directing to the pressure plate and mark the end of the wire as your /elev extend or whatever.

    And well, maybe a wiki isn't such a bad idea. There is just too much stuff, like the call block "trick" or the wire workaround, to write everything in this post. Let's see.
     
  6. Offline

    AnrDaemon

    I just don't know. Is the bukkit wiki an appropriate place to document plugins?
    If yes, i could just do it as I received my email confirmation. (omaygad, finally... my mail is damn slow. At times, i think the paper mail is faster.)

    Don't know if it is intentional, but though I'd let you know.
    It is possible to place buttons on the shaft wall, and they will be moved with elevator if placed according to connected block rule. Could even end in the open air. (Button floating unattached... a look you want to see!)
    I'm unsure if it would remain operable if you destroy blocks you placed them onto, when elevator on a different level... Need check.
     
  7. Offline

    ThomasJ

    Just a heads up.

    CB 552 finally fixes issues with CB returning the wrong block id on block.getType()

    This should hopefully resolve a few issues with elevators
     
  8. Offline

    AnrDaemon

    Achtung! (C)
    I just cloned a bunch of stone buttons...
    The way was just as I mentioned earlier: put buttons on the wall of elevator.
    One button directly above platform works fine, but two of them one over another cause both to fall off multiple times when elevator reach open air by that side.
     
  9. Offline

    Raek

    Any help with the jumpy issue I asked about on page 13?

    I have now updated Bukkit once again and still jumpy lifts? is it supposed to be like that? if so I'm ok with it just if there is a chance it should be smoother then I'll take it :)

    Thanks
     
  10. Offline

    mrgreaper

    Jumpiness when on a lift that's moving is unavoidable chap.

    Why has this been put to inactive? It works great on our server one of my top 3 favourite plugins! Falsebook controller blocks and elevators.
     
  11. Offline

    QQCucumber

    It's probably just the [450] in the title. It'll get moved back.
     
  12. Offline

    AnrDaemon

    Two more issues.
    1. Standing on the elevator roof does not prevent it from moving, neither it move you. Instead, you'll be dropped down in to shaft.
    2. I've just lost a redstone torch... >.> And a control console.
    Layout was:
    Code:
    [_][_] (Glass roof)
           (Space intentionally left blank... Fresh air is good, u'know...)
       [^]
       [v] (Sandstone control console with buttons)
    [=][=] (2x3 Sandstone elevator)
    All were working fine, used it multiple times at different floors.
    Now, when I got some redstone torches, I tried to place one on the side of the console.
    Code:
    [_][_]
    
      \[^]
       [v]
    [=][=]
    When I moved the elevator, the torch, console and buttons - all vaporized. Only elevator platform itself and a glass roof survived.
     
  13. Offline

    jimbo8

    Sorry. I'am new to forums. I mean, It is very buggy when I'am in the elevator. (Sorry for bad english)
     
  14. Offline

    Olat

    Code:
    23:58:13 [SEVERE] java.lang.ClassCastException: org.bukkit.craftbukkit.block.CraftBlockState cannot be cast to org.bukkit.block.Sign
    23:58:13 [SEVERE]       at de.NTcomputer.Elevators.Elevators.BlockWrite(Elevators.java:601)
    23:58:13 [SEVERE]       at de.NTcomputer.Elevators.Elevators.DoMoveElevator(Elevators.java:443)
    23:58:13 [SEVERE]       at de.NTcomputer.Elevators.ElevatorsMoveTask.run(ElevatorsMoveTask.java:62)
    23:58:13 [SEVERE]       at org.bukkit.craftbukkit.scheduler.CraftScheduler.mainThreadHeartbeat(CraftScheduler.java:122)
    23:58:13 [SEVERE]       at net.minecraft.server.MinecraftServer.h(MinecraftServer.java:345)
    23:58:13 [SEVERE]       at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:272)
    23:58:13 [SEVERE]       at net.minecraft.server.ThreadServerApplication.run(SourceFile:366)
    23:58:13 [SEVERE] Unexpected exception
    java.lang.ClassCastException: org.bukkit.craftbukkit.block.CraftBlockState cannot be cast to org.bukkit.block.Sign
            at de.NTcomputer.Elevators.Elevators.BlockWrite(Elevators.java:601)
            at de.NTcomputer.Elevators.Elevators.DoMoveElevator(Elevators.java:443)
            at de.NTcomputer.Elevators.ElevatorsMoveTask.run(ElevatorsMoveTask.java:62)
            at org.bukkit.craftbukkit.scheduler.CraftScheduler.mainThreadHeartbeat(CraftScheduler.java:122)
            at net.minecraft.server.MinecraftServer.h(MinecraftServer.java:345)
            at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:272)
            at net.minecraft.server.ThreadServerApplication.run(SourceFile:366)
    
    Crashes my server
    CB 531jnkins
     
  15. Offline

    Dreadreaver

    wtf why is this in INACTIVE?!?!?!

    Last post from the author was THIS MONDAY and this plugin runs PERFECTLY fine on my server CB #556!
    Whats going on?
     
  16. Offline

    Olat

    Because the Forum mods are being dumb... plugins that havent updated the 'Title' and or other things get called 'INACTIVE' even though they work fine.
     
  17. Yeah, this new inactive business isn't very smart.
     
  18. Offline

    AnrDaemon

    That's what documentation said. It's normal.
     
  19. Offline

    mrgreaper

    another example of using an elevator for something other then miner elevation and de-elevation :)



    it would be really handy to be able to name the elevators when you create them so you can have /elev create george and then have /elev up george. so that buttons etc dont have to be so close to the elevator (well help majorly with a small home defense project i have in mind with 5 arrow turrets coming out of the ground and firing when player that is not me is detected heading for my vault
     
  20. Offline

    AnrDaemon

    We already used elevators for "something different". Project is in preparation stage, and we're experiencing some issues with elevators setup, but they were mostly worked out, and only wiring is left to go.
    Then I expect to make some video.
     
  21. Offline

    mrgreaper

    i very much look fwd to seeing them :)
    love how versitile this plugin is (as i say enabling us to name elevators would help much more though :) )

    the other use i mentioned :) (have posted this a while back)

     
  22. Offline

    AnrDaemon

    Creative thinking is creative :)
     
  23. Offline

    Dragondj0

    Simply amazing never knew you could do that with them. I was only using em as a standard run of the mill elevator
     
  24. Offline

    mrgreaper

    trick is to make sure the base of your elevator is a different material to the rest of it, that seems to stop any errors i have had, got in the habbit of using stone slaps 2 high as a base
     
  25. Offline

    AnrDaemon

    You could build a whole elevator of the same material, only make sure it does not looose connection to the base while building. You have to move elevator once to save the shape, then you could dig any holes in it (not sure if you could destroy carrying platform, though) and Elevator will still be functional...
    I have a cabin with glass roof in my little house, which (roof) does not have any links to the cabin ceiling now.
     
  26. Offline

    chernobyl360

    it wont work on CB 556. it seems like it wont even save the info. none of the buttons and calls work...
     
  27. Offline

    Shenlong


    Could you not do that with this plugin: XSigns? I'm actually just curious as I haven't played around with XSigns yet, so I'm not sure how well it would work.
     
  28. Offline

    AnrDaemon

    You haven't played with Elevators yet... Naming elevators have nothing to do with putting signs on them. I'ts purely technical request, to simplify management.
     
  29. Offline

    Dreadreaver

    I have one problem, maybe you guys can help me:

    I was thinking of a nice elevator that leaves no "holes" behind it so I figured I just dig a hole down to the bedrock, fill it 3x3 with cobble or something and then build on it as much blocks as needed until I reached anything of importance. working fine so far, looks really great, only issue is that passangers will fall right through the elevator now. every other elevator still works just fine but if I stand on this huge elevator I will just fall through it when it starts moving. any ideas on what I could do to prevent this bug?
     
  30. Offline

    Cybran

    I am sorry I have to tell you that this a bug you can't prevent yet - I know it and will fix it in v1.4.1 (cause 1.4 is ready now). Please just be patient and keep your elevator how it is ...
     
  31. Offline

    Dreadreaver

    alright, thank you so much!
    all guests keep dying cuz they think this elevator is safe ^^ so ... need that update asap =)
    but great you already know about this bug and know how to fix it =)
     

Share This Page