02 — Creating & Managing Lifts (Wizards & Commands)

Lift includes an interactive, step-by-step in-game Setup Wizard that builds an entire elevator system (Platform, Teleport Region, Animated Gate, Outer Call Hologram, and Inner Call Hologram) automatically in seconds.

Required Permission: krapple.lift.admin (or Server Operator op)

---

1. Quickest Way: The Elevator Setup Wizard (/lift wand)

Run the following command in-game:

/lift wand

You will receive the Lift Wizard Wand (GOLD_BLOCK) in your inventory, and the wizard will automatically name your new elevator (Lift1, Lift2, Lift3, etc.).

Follow the 5 steps shown on your Action Bar and in chat:

Step 1: Select the Lift Platform (Lift<N>)

1. Left-Click the first corner block of your elevator floor with the wand (Pos 1).
2. Right-Click the opposite corner block of your elevator floor with the wand (Pos 2).
   • The physical platform is automatically registered!

Step 2: Select the Teleport Region (Lift<N>TpRegion)

1. Left-Click the first corner block of the upper teleport region (Pos 1).
2. Right-Click the opposite corner block of the upper teleport region (Pos 2).
   • After creation, set the region's actionCommand (e.g., /server lifesteal) inside plugins/Lift/regions.yml under Lift<N>TpRegion.

Step 3: Select the Animated Gate (Lift<N>Gate)

1. Left-Click the bottom-left corner of the elevator entrance gate (Pos 1).
2. Right-Click the top-right corner of the elevator entrance gate (Pos 2).
   • All blocks inside the gate selection are saved and will smoothly animate upward/downward when the lift is called!

Step 4: Place the Outer Call Hologram (Lift<N>OuterCallHolo)

• Left-Click or Right-Click the block outside the elevator where players should look and click to call the elevator & open the gate.
• An interactive 3D floating call button hologram is spawned automatically.

Step 5: Place the Inner Call Hologram (Lift<N>InnerHologram)

• Left-Click or Right-Click the block inside the elevator where players should click to close the gate and ride the lift upward.
• Setup is now complete!

---

2. Creating a LifeSteal Elevator (/lift lifestealcreate)

If you want a pre-configured LifeStealLift whose LifeStealLiftTpRegion is automatically pre-bound to /server lifesteal:

/lift lifestealcreate

You will receive the LifeSteal Wizard Wand (GRASS_BLOCK). Complete the 5 steps shown on your Action Bar:

1. Lift Platform: Left-click corner 1, Right-click corner 2.
2. TpRegion: Left-click corner 1, Right-click corner 2 (the zone at the top where players step off to trigger the connecting sequence).
3. Gate: Left-click corner 1, Right-click corner 2.
4. Outer Call Hologram: Click the block outside the lift for the outer call button.
5. Inner Call Hologram: Click the block inside the lift for the inner button.

---

3. Adjusting Lift Travel Height (Stopping Blocks)

By default, a newly created lift travels 5.0 blocks upward. To customize how many blocks a lift travels upward before stopping:

/lift wand startingposblocks <lift_name> <number_of_blocks>

Examples:

/lift wand startingposblocks Lift1 20
/lift wand startingposblocks LifeStealLift 15

---

4. Deleting an Elevator System

To completely delete an elevator along with its associated Gate, Outer/Inner Call Holograms, and TpRegion in one command:

/lift wand delete <lift_name>

Examples:

/lift wand delete Lift1
/lift wand delete LifeStealLift

---

5. Manual & Administrative Lift Commands

Command	Description
/lift help	Displays the in-game command reference guide.
/lift wand	Gives the Lift Wizard Wand and starts the 5-step elevator setup wizard (Lift1, Lift2, ...).
/lift lifestealcreate	Starts the 5-step LifeSteal elevator wizard with automatic /server lifesteal transfer region.
/lift wand startingposblocks <name> <blocks>	Sets the travel height (in blocks) for <name>.
/lift wand delete <name>	Deletes <name> and its gate, holograms, and region.
/lift start <name>	Manually sends <name> upward from the bottom.
/lift return <name>	Manually returns <name> downward from the top.
/lift reload	Reloads config.yml, gates.yml, lifts.yml, regions.yml, and holograms.json from disk.
/lift purge	Opens an interactive [ ACCEPT PURGE ] / [ REJECT ] prompt to clean up all floating display entities, seats, and holograms.