EnderSurfer

Introduction
Welcome to the official page of my (first) plugin, EnderSurfer! This plugin features live ender pearl teleportation. This means that, instead of throwing an ender pearl and waiting for it to hit the ground, it makes it as if you are the ender pearl and you travel just like it would travel. And, trust me, it's a lot of fun.

Notes

1. Before running your server with this plugin, make sure to set allow-flight to true in your server.properties file to avoid player kicks for no reason.
2. Should you find any bugs, please let me know as soon as possible so I can deal with them . Otherwise they will remain there until someone else points them out or I discover them!
3. If you make any changes to the config.yml file (either via in game commands, or by editing the file itself) , those changes will take place after you reload or restart the server! (v1.10 and up)
4. The endersurfer.elytra permission is set to false by default because if abused, the server will lag a lot due to high speeds, meaning too fast world generation.

Features

• Ender pearl teleportation on-the-go - aka Ender Surfing !
  
• Particles behind the player while flying with an ender pearl
• Custom heart loss when the shooter hits the ground.
• Sneaking before throwing the ender pearl will make it be thrown in the usual way.
• Auto-completion for the commands.
• Can be disabled for certain worlds (v1.9 and up)

Commands
Instead of /endersurfer , you can do /es

• /endersurfer setHearts : Sets the the number of half hearts that will be lost when someone hits the ground after throwing an ender pearl. Insert integers only
• /endersurfer setVelocityMultiplier : Sets the velocity multiplier (ender pearl's velocity times the number you put here). Insert integers only
• /endersurfer setDamageOnAir : If set to true, the player will be damaged by the hearts specified in the setHearts command. Insert boolean values only
• /endersurfer showParticles : If set to true, the player will leave a trail of Enderman particles behind them. Insert boolean values only

Permissions

• endersurfer.utilize : Check if a player is able to utilize EnderSurfer. Default: True
  
• endersurfer.defyfalldamage : Check if a player is able to defy the fall damage he gets after throwing an ender pearl. Default: False
  
• endersurfer.showparticles : Check if particles can be displayed at a player when they throw an ender pearl. Default: True
  
• endersurfer.defydamageonair : Check if a player is able to defy the damage he gets while on air, after throwing an ender pearl. Default: False
• endersurfer.elytra : If the player has this permission, they can use both the elytra and EnderSurfer for super high gliding speeds! (I definitely recommend trying it!) . If not, throwing an ender pearl while gliding will make the pearl be thrown in the vanilla way Default: False

Disabling the plugin for a certain world

1. To add a world, first of all add a new line
2. Then, add a hyphen (the following sign: "-", without the quotes of course)
3. After that, add the exact name of the world.
4. Save the config and reload or restart the server.
   
5. The plugin is now properly disabled for the world(s) you typed.
6. See the example configuration file for which format to use

Example configuration file
half-hearts: 2
vel-mult: 3
dmg-on-air: false
show-particles: true
disabled-for-worlds:
- WORLD1
- WORLD2
- WORLD3

By myself

By MusicTechnician

By Numero Uno


Credits

• To aegisjester for suggesting the plugin name and the setDamageOnAir command.
• To Eegah123 for suggesting the sneaking-cancelling idea.
• To mash1928 for making the thumbnail.
• To MusicTechnician and Numero Uno for making a video showcase.

Source code
URL: https://github.com/Lazini/EnderSurfer.git

Feedback
Leave some feedback if possible! If not, then great! It means a lot to me knowing what you think!