TeleportEffects v3.0

A Bukkit Plugin created to intercept every teleport in the server and add a cooldown with effects.
TeleportEffects is a Bukkit plugin that intercepts every teleport and re-schedules it while creating some particle effects on the start and destination points.

Version3.0.png

Before continuing, this page is a presentation with minimal information of the plugin. If you want a more complete explanation, you are encouraged to check out the GitHub Wiki page.
Commands
The plugin offers only one command: /toggleteleporteffects

/toggleteleporteffects
Permission: teleporteffects.toggle
Aliases
: [toggleteleporte, togglete, tte]
Having tested TeleportEffects on a real server, what most people found annoying (for visual or performance reasons) were the effects themselves. Even though this kind of defeats one of the main features of the plugin, the ToggleTeleportEffects command was implemented, and it does exactly that: it hides every effect created from the plugin for the player that uses it. This option is saved for every user, meaning that it is not required to execute the command at every login.


Permissions

teleporteffects.bypass: All the users that have this permission will automatically bypass the teleport cooldown. This is advised for admin or staff users.
teleporteffects.toggle: The permission required to execute the command /toggleteleporteffects.


Configuration
Every teleport is composed of four stages of particles spawning. Each one of them is characterized by some of the parameters of the config.yml and changing these, will change the stages themselves.

Stage1
The Stage1 is the first stage that appears. This stage lasts for 1/3 of the total duration, so, by default, 1 seconds.

Stage1.png
X points will be equally divided along a circle that will be translated by initial-offset degrees starting from the position of the player eyes and of radius initial-distance. Then, every tick (duration between an iteration and another), those particles will be rotated by rotation-angle, their height will be +height-increment blocks from their previous value, and they will be closer to the player. After 1/3 duration seconds, the particles will have reached final-distance, they will stop spawning and Stage2 will begin.

Stage2
Stage2 will be the followup to Stage1, starting off right from where the first stage finished. This stage lasts for 2/3 of the total duration, so, by default, 2 seconds.

Stage2.png
So, this stage takes directly from Stage1 the last position of the particles and from there it starts spawning particles both above and below that level, at height-increment blocks of distance from the previous iteration. All the other options are inherited and continued from the first stage, but do note that in this case final-distance will actually be the initial and final distance from the player.

Stage3
While the previous two stages are sequential, the third stage happens simultaneously as the Stage2. This means that it starts after 1/3 of the total duration, and it has the same duration as the second stage. However, Stage3 spawns particles not around the player, as previously seen, but at the teleport destination.

Stage3.png
The Stage3 starts spawning particles 2.5 blocks higher than the final destination in a circular radius. It will spawn 360° / distance-angle points at a radius of initial-distance blocks. Then, these particles will descent by height-decrement blocks every tick (duration between an iteration and another) until they reach the final-distance distance in blocks from the destination location. At that point, Stage4 will commence.

Stage4
Stage4 is the last and less important stage. It is directly linked to Stage3 ending, but it happens after the teleport happened (so past the duration seconds).

Stage4.png
So, Stage4 particles will be spawned at the player's feet in a circular radius, similar to Stage3 particles, using the same numbers of points as the previous stage. They will move in a straight line until stage4-duration seconds will have passed, then they will be removed.

API

TeleportEffects is a relatively small plugin, and some may want to integrate it in their custom mode core (for example a FactionCore) or in their teleportation plugin. In any case, achieving this goal is trivial.
To further know how to use TeleportEffects API and more information about the plugin, check out the Wiki at the GitHub page.
EULA: Standard EULA
230 Views
12 Downloads
Oct 5, 2023 Published
Nov 5, 2023 Updated
Not yet rated
232.4 KB File size
Type
  1. Gameplay
Supported software
  1. Bukkit
  2. Spigot
  3. Paper
Supported versions
  1. 1.8
  2. 1.9
  3. 1.10
  4. 1.11
  5. 1.12
  6. 1.13
  7. 1.14
  8. 1.15
  9. 1.16
  10. 1.17
  11. 1.18
  12. 1.19
  13. 1.20
Creator
Recommended for you
Prevents your server from crash packet exploits
5.00 star(s) 83 ratings
1,994 purchases
Elite formatting and filtering plugin. Can replace 200+ plugins. High-performance. Folia supported.
5.00 star(s) 102 ratings
1,977 purchases
High Performance | Customizable | Cross-Version | GeyserMC | Folia Support
5.00 star(s) 54 ratings
1,709 purchases
Premium mobcoins plugin
5.00 star(s) 26 ratings
1,136 purchases
Easily add new mobs & AI to Minecraft (without datapacks or scripts).
5.00 star(s) 43 ratings
906 purchases
230 Views
12 Downloads
Oct 5, 2023 Published
Nov 5, 2023 Updated
Not yet rated
232.4 KB File size
Type
  1. Gameplay
Supported software
  1. Bukkit
  2. Spigot
  3. Paper
Supported versions
  1. 1.8
  2. 1.9
  3. 1.10
  4. 1.11
  5. 1.12
  6. 1.13
  7. 1.14
  8. 1.15
  9. 1.16
  10. 1.17
  11. 1.18
  12. 1.19
  13. 1.20
Creator
Recommended for you
Prevents your server from crash packet exploits
5.00 star(s) 83 ratings
1,994 purchases
Elite formatting and filtering plugin. Can replace 200+ plugins. High-performance. Folia supported.
5.00 star(s) 102 ratings
1,977 purchases
High Performance | Customizable | Cross-Version | GeyserMC | Folia Support
5.00 star(s) 54 ratings
1,709 purchases
Premium mobcoins plugin
5.00 star(s) 26 ratings
1,136 purchases
Easily add new mobs & AI to Minecraft (without datapacks or scripts).
5.00 star(s) 43 ratings
906 purchases
Top
You need to upgrade!
Our dark style is reserved for our Premium members. Upgrade here.