Enables players to use various abilities in the game.
With this ability players can spread their fall damage to the surrounding entities. The damage spread reaches up to 3 blocks in x and z directions. The damage an entity takes is a percentage of the fall damage based on its distance to the damage dealing player. For example an entity with a distance of 1.5 blocks will receive 50% of the player's fall damage.
It is important to know that the fall damage spreader can deal more damage to surrounding entities than fall damage that should be received by the player. The dealt damage will be subtracted from the player's fall damage. If the damage spreader deals more damage, than the fall damage the player should receive, the player will be unharmed after the fall.
Players can create a tornado around them if they start sneaking. The tornado will show its presence with cloud particles storming around the player. If other entities get to close to a tornado, they will be picked up from the ground and thrown through the air.
This is a more defensive ability as it throws entities away from a player and doesn't deal damage directly. Nevertheless, entities may take damage by falling to the ground after thrown by the tornado.
Crossbows now act as a sort of rocket launcher. Those rockets are not subject to gravity and will fly for around 10 seconds. If they hit something, they will create a small explosion and deal 5 hearts of damage to the hit entity. Otherwise, they will simply vanish.
Right-clicking on water enables players to pick up water and move it around in the air. Another right-click places the water in the air.
This ability is just for fun and has no real use-case (at least I've found none so far).
When aiming with a bow a player can choose a target entity. Possible targets will be marked with an aqua glowing effect. After shooting the arrow, it will be automatically guided to its target. Guided arrows will have a blue flame trail while unguided arrows leave a normal trail. Guided arrows do not automatically avoid obstacles, but can be used to hit targets behind obstacles, for example, by aiming in the air to that the arrow flies over the obstacle.
Since version 1.13 minecraft uses block state ids in its protocol instead of the block id and data. This plugin needs to know block state ids of different blocks in order to create packets to spawn falling blocks for the player. It turns out that it is fairly difficult to obtain the block state id from any block as there is no API to access the registry.
After doing some research I found a helper class built into the original minecraft server located
at net.minecraft.server.data.Main. Using this class it is possible to create a report of all possible block states and
export it to a JSON formatted file. The BlockStateIDLoader then strips this file's content down to only the default
state of each block (I have found rotation and other metadata to be irrelevant for this plugin's purpose) and saves the
compiled result into the Abilities/blocks.json file. This compilation process is only done if the Abilities/blocks.json
file does not exist.
Please note that after a Minecraft version update, in order to use new blocks, the block state ids have to be
re-generated. This is simply done by removing the Abilities/blocks.json file and reload the plugin.