ElytraFly

Simple One-time-use elytra Plugin offering multiple elytra zones

Table of contents

• Setup
• Zones
  • Creating Zones
  • Deleting Zones
  • Restricting Zones
• Configuration
• Boost Designs
  • Colors
• Permissions
• Plugin Integrations
  • Luckperms Integration
  • PlaceholderAPI Integration
• License

Setup

Download the Plugin, put it in plugins/ and restart the server

Zones

Note
Zone define the areas in which Players get the elytras.

Creating Zones

To create a Zone, open the GUI with /elytrafly and click on New Zone. Follow the Instructions in the Chat to create
the Zone

Deleting Zones

To delete a Zone, simply right-click the Zone in the Zone GUI, opened with /elytrafly, to delete it.

Caution!
Deleted zones are not recoverable!

Restricting zones

Zones can be restricted to specific players/permission groups

• Every Zone has a unique Permission attached to it specifying what players are allowed to use the zone
• The permission is constructed from elytrafly.zone. and the unique name of the zone, lowercase and with whitespaces
  replaced with -
  • Example: Zone Test Zone has the permission elytrafly.zone.test-zone

Note
ElytraFly only enforces the Permissions when the restricted flag of the zone is set to true
This can be done in the Zone GUI

Configuration

Warning
Do not edit the config while the server is running!
The plugin will simply overwrite the config on shutdown!

Everything there is to configure about this Plugin is done in the GUI opened with /elytrafly

To open the Settings, click on the Workbench in the lower left corner of the GUI

| Setting | Description |
|----------------|------------------------------------------------------------------------------------------------------------------------|
| Boost | If boost is activated, Player with the elytrafly.boost permission can use the F key to boost themselves in mid-air |
| Boost Strength | Boost Strength defines how long the Boost will last. every level is approximately half a second of boost |
| Max Boosts | How many boosts a Player can use per flight. -1 for infinite, 0 for none |
| Boost Delay | How many seconds player have to wait until they can boost again |
| Prefix | Changes the Prefix of the Plugin |

Boost Designs

ElytraFly offers an extensive Design builder to customize the boosts to your liking. The Builder offers functionality to
change colors, add fades, flickers and trails to your boosts.

Colors

You can easily define the colors of your elytra just by clicking items!

Permissions

| Permission | Description |
|----------------------------|---------------------------------------------------------------------------------------------------------------------------|
| elytrafly.gui | Allows to access the GUI and other admin functionality |
| elytrafly.boost | Allows Players to boost themselves in mid-air using their off-hand swap key |
| elytrafly.boost.bypass | Allows Players to bypass the boost limit |
| elytrafly.delay.bypass | Allows Players to bypass the delay for boosts |
| elytrafly.zone.bypass | Allows Players to use all zones, even if they are restricted |
| elytrafly.zone.ZONE_NAME | Allows players to use a zone if it's restricted (The zones name is fully lowercase and Whitespaces are translated to -) |

Integrations

Elytrafly offers first-class Support for multiple popular plugins, like Luckperms
or PlaceholderAPI

Luckperms

You can use Luckperms Meta Variables to fine-tune specific
Settings of Elytrafly per player. Refer to the wiki for a guide
how to use them

| Variable name | Description |
|-------------------------|-----------------------------------------------------------|
| elytrafly.max-boosts | How many boosts a Player/Group can use per Flight |
| elytrafly.boost-delay | How long the delay between boosts is for the Player/Group |

PlaceholderAPI

ElytraFly offers an expansion for PlaceholderAPI to display
additional information to Players

Note
You do not need to worry about enabling the Placeholders, ElytraFly will register them automatically when
PlaceholderAPI is being detected on the Server

| Placeholder | Description |
|----------------|---------------------------------------------------------------------------------------|
| zones_count | The total of zones set on the server |
| current_zone | The name of the zone in which the Player is standing (null if not standing in a zone) |
| allow_boosts | If the Player is allowed to boost himself |
| max_boosts | The maximum boosts the Player is allowed to use |
| delay | The delay that is set for the Player between boosts |

License

This Repository is licensed under GPL v3