AnziZiplines

Price Free · apply on DiscordVersion 1.0.0Platform Paper 26.2+Optional LuckPerms · Vault

AnziZiplines adds rideable ziplines to your server. Pick two points with a wand, add bends if you want them, and the plugin strings a particle rope between them. Players right click the rope and glide along it, hanging underneath. Every rope has its own speed, look, price and permission, all set from an in-game menu.

AnziZiplines is free, but you have to apply for it. It is not on a marketplace. Ask for it in the Discord server. See How to Get It.

Overview

Built with a wand. Left click sets point A, right click sets point B, and shift-clicks add bends (waypoints) in between. A preview line shows the route while you hold the wand.
Smooth, locked-on rides. The rider sits on an invisible carrier that the server moves along the rope every tick. They cannot walk off the line or get knocked off it.
Ropes that hang. Ropes sag like a cable or arch like a bridge. Riders follow the same curve the particles draw.
Slopes matter. A steep drop speeds riders up and a climb slows them down, and you choose how much. When they let go, they keep their momentum.
One menu per rope. Speed, particles, colour, arch, cooldown, price, permission, dismount point and more are set per zipline in a chest menu. Nothing needs a restart.
Permissions per rope. Each zipline gets its own node, ziplines.ride.<id>. With LuckPerms installed, these nodes show up in /lp tab completion.
Paid rides. With Vault and an economy plugin, a rope can cost money. Riders confirm in chat before they pay.
Cleans up after itself. A carrier left behind by a crash or a /reload is removed on startup and whenever its chunk loads.

Requirements

Paper 26.2 or newer
Optional: LuckPerms, which adds tab completion for each rope's permission node and checks nodes that have contexts
Optional: Vault and an economy plugin, needed for paid ziplines

How to Get It

AnziZiplines costs nothing, but it is not a public download. To get it:

Join the Discord server.
Apply for AnziZiplines there. Say which server it is for.
Once you are approved, you get the jar.

Installation

Put AnziZiplines-1.0.0.jar in your server's plugins/ folder.
Optional: install LuckPerms and/or Vault with an economy plugin.
Start the server. plugins/AnziZiplines/config.yml is created on the first start.
Run /zipline wand in-game and build your first rope.

Building a Zipline

Run /zipline wand to get the Zipline Wand (a blaze rod by default).
Pick the route with the clicks below. All points must be in the same world.
Run /zipline create <name>. The rope appears and its editor opens.

Wand click	Effect
Left click a block	Sets point A
Right click a block	Sets point B
Shift + left click	Adds a waypoint (a bend in the rope)
Shift + right click	Removes the last waypoint

The name can contain spaces. The id used in commands is made from it and never changes, even if you rename the zipline later. The route must be at least 2 blocks long. Ziplines are saved in plugins/AnziZiplines/ziplines.yml.

To move an existing rope, make a new selection with the wand and click Move the route in its editor.

Riding

Right click the rope to grab it. You can be up to 5 blocks away (the grab reach) and your crosshair has to be close to the rope.
/zipline ride [name] grabs the nearest rope without aiming. It works within 5 blocks of the rope itself, so standing anywhere under a long line is enough.
Press shift to let go mid-ride, unless the rope has Let go mid-ride turned off.
You ride in the direction you are facing along the rope. If you grab it at one end, you ride towards the other. A one-way rope only runs from A to B.
A paid rope asks for confirmation first. Type yes in chat to pay and ride.
With fall protection on, you take no fall damage for a moment after the ride ends. You are set down in open space, never inside a block.

The Editor

Open it with /zipline edit <name>, or with /zipline (or /zipline list) and a click on the rope. Number buttons go up with a left click and down with a right click. Shift changes the value faster, and a middle click lets you type an exact value in chat.

Defaults come from the defaults section of config.yml. Each zipline keeps its own copy of these settings, so changing the config later does not affect ziplines that already exist.

Button	Default	What it does
Speed	12 blocks/s	How fast riders move along the rope.
Slope influence	0.35	0 keeps the speed constant. 1 roughly doubles it on a steep drop and nearly stops riders on a steep climb.
Exit launch	1.0	How much momentum riders keep when they let go. 0 drops them straight down.
Ride cooldown	0 s	Seconds before the same player can ride this rope again.
Ride price	Free	Cost per ride, through Vault. Without an economy plugin, a priced rope refuses every rider instead of letting them ride for free.
Required permission	None	Shift click to use `ziplines.ride.<id>`, left click to type any node, right click to clear it.
Fall protection	On	No fall damage right after the ride.
Ride sounds	On	Plays sounds while riding.
Let go mid-ride	On	When off, riders stay on until the end of the rope.
Two-way	On	When off, the rope can only be ridden from A to B.
Grab reach	5 blocks	How far away a player can right click the rope.
Enabled	On	A disabled rope cannot be ridden.
Rope visible	On	Turns the particles off while keeping the rope rideable.
Rope particle	`END_ROD`	Opens a particle picker.
Dust colour	120, 220, 255 · size 1.0	Only for dust particles. Click to cycle presets, shift click to change the size, middle click to type `r,g,b`.
Particle spacing	0.5 blocks	Distance between particles along the rope.
Refresh interval	10 ticks	How often the particles are redrawn. Lower is smoother but costs more.
View range	32 blocks	Players further away do not receive the rope's particles.
Rope arch	0.4	How far the middle of the rope sits from a straight line. Positive sags down, negative arches up.
Arch shape	1.0	1 is a plain curve. Below 1 the rope rounds off across the top, above 1 it peaks in the middle.
Ghast offset (forward / up / side)	0 / −2.3 / 0	Where the rider hangs compared to the rope. A negative "up" hangs them below it.
Ghast size	0.5	Fine-tunes how high the rider sits. The carrier is invisible either way.
Dismount offset (forward / up / side)	0 / 0 / 0	Where riders are set down when the ride ends.
Display name	—	Renames the zipline. The id stays the same.
Teleport to point A / B	—	Takes you to either end.
Move the route	—	Replaces A, B and every waypoint with your current wand selection.
Clear waypoints	—	Makes the rope a straight line from A to B again.
Test ride	—	Closes the menu and puts you on the rope at point A.
Delete zipline	—	Shift + right click to delete. This cannot be undone.

Commands

Aliases: /zl, /ziplines. Running /zipline with no arguments opens the zipline list for admins and shows help for everyone else.

Command	Description	Permission
`/zipline ride [name]`	Grab the nearest rope, or the named one, without aiming.	`ziplines.use`
`/zipline help`	Show the commands you can use.	—
`/zipline wand`	Get the selection wand.	`ziplines.admin`
`/zipline create <name>`	Create a rope along your selection and open its editor.	`ziplines.admin`
`/zipline list`	Browse every zipline in a menu (a text list from the console).	`ziplines.admin`
`/zipline edit <name>`	Open one zipline's editor.	`ziplines.admin`
`/zipline tp <name> [a\|b]`	Teleport to point A (default) or B.	`ziplines.admin`
`/zipline delete <name>`	Delete a zipline.	`ziplines.admin`
`/zipline reload`	Reload `config.yml` and `ziplines.yml`. Rides in progress end.	`ziplines.admin`

Permissions

Node	Default	Grants
`ziplines.use`	Everyone	Ride ziplines.
`ziplines.ride.<id>`	No one	Ride one zipline that requires its permission.
`ziplines.ride.*`	No one	Ride every zipline that requires a permission.
`ziplines.admin`	OP	Create, edit and delete ziplines. Includes `ziplines.use` and `ziplines.ride.*`, so admins can ride every rope. Paid ropes still charge them.

A rope only needs a permission if one is set in its editor. To lock a rope to a rank, shift click Required permission and grant the node, for example /lp group vip permission set ziplines.ride.canyon.

Configuration

plugins/AnziZiplines/config.yml. Everything under defaults only applies to new ziplines. Change existing ones in their editor.

messages:
  prefix: '&8[&bZipline&8] &r'

wand:
  material: BLAZE_ROD
  name: '&b&lZipline Wand'
  lore:
    - '&7Left click a block &8» &fpoint A'
    - '&7Right click a block &8» &fpoint B'
    - '&7Shift + left click &8» &fadd a waypoint'
    - '&7Shift + right click &8» &fundo last waypoint'
    - '&7Then &f/zipline create <name>'
  # Draws a preview line through every selected point while the wand is held.
  preview: true

render:
  # Resolution of the shared particle timer, in ticks.
  tick-interval: 2
  # Hard cap on particles per zipline per refresh.
  max-points: 400

ride:
  # Removes carriers left behind by a crash or a /reload.
  cleanup-orphans: true
  # How far /zipline ride reaches for a rope, in blocks.
  command-range: 5.0

defaults:
  speed: 12.0               # blocks per second
  slope-influence: 0.35     # 0 = constant speed
  exit-launch: 1.0          # momentum kept when letting go
  cooldown-seconds: 0
  fall-protection: true
  ride-sound: true
  allow-early-exit: true    # shift lets go mid-ride
  price: 0.0                # through Vault, 0 = free

  rope:
    visible: true
    particle: END_ROD
    spacing: 0.5            # blocks between particles
    interval: 10            # ticks between refreshes
    view-range: 32.0
    sag: 0.4                # positive sags, negative arches
    arch-power: 1.0
    dust:
      red: 120
      green: 220
      blue: 255
      size: 1.0

  mount:                    # where the rider hangs
    forward: 0.0
    up: -2.3
    side: 0.0
    scale: 0.5

  dismount:                 # where the rider is set down
    forward: 0.0
    up: 0.0
    side: 0.0

  grab:
    reach: 5.0              # right click distance
    tolerance: 0.8          # how close the crosshair must be
    two-way: true

FAQ

Q: Right clicking the rope does nothing

A: Get closer (within the grab reach) and aim straight at the particles, or use /zipline ride. Also check that the rope is enabled and that you have its permission, if it needs one.

Q: Riders end up inside the ground

A: They should not. Riders are always moved up out of solid blocks when they get off. If the drop-off point is in a bad spot, change the Dismount offset in the editor.

Q: The rope is not drawn

A: Some particles need block or item data and cannot be used. The editor warns you about this. Pick another particle and check that Rope visible is on.

Q: A paid rope refuses everyone

A: That happens when no economy plugin is installed. Install Vault and an economy plugin, or set the price back to 0.

Q: Does it run on Folia?

A: No. It is made for Paper 26.2 and newer.