DashAPI

Help me maintain DashAPI!: https://ko-fi.com/lichenaut

DashAPI is a Spigot / (preferrably) Paper plugin that adds a function for setting the velocity of entities in terms of blocks rather than a vector.

To add to your project, you can add this dependency to your pom.xml.

    <dependency>
        <groupId>io.github.lichenaut</groupId>
        <artifactId>DashAPI</artifactId>
        <version>1.0.8</version>
    </dependency>
    

For tools other than Maven: https://central.sonatype.com/artifact/io.github.lichenaut/DashAPI/1.0.8

Then, add this as a dependency in your "plugin.yml" file.

To get an instance of this API for use, define a "DashFunctions" object with "DashAPI.getInstance()":

Example #1 (base function):

When a player interacts with an entity, the entity will be dashed 10 blocks forward, 10 blocks up, and 10 blocks left on Minecraft's x, y, and z axes, respectively.

Example #2 (adjustments):

When a player crouches or uncrouches, they will be dashed forward relative to their looking direction due to "adjustHorizontal" being true, and the player's current velocity will be added to the dash due to "additive" being true. Additionally, as the maximum number of blocks an entity can be dashed vertically is 60 (43 horizontally), the plugin reduces the value 100 to 60 and dashes the player up 60 blocks. Finally, because "adjustVertical" is set to true, the player's looking up or down affects the y of the dash.

Example #3 (int and Double inputs):

Int values for block distance and Double values for velocity can be used in any combination, and in this example it is (int, Double, int). In this example, when a player interacts with an entity, the y value of that player's looking direction is multiplied by -4, which means that if a player looks down to click an entity, they will be dashed with a high positive y velocity.

Example #4 (multipliers):

The first dash is applied to the entity interacted by the player, based off of the direction the player is facing, creating a knockback effect. The second dash is applied to the player, based off of the velocity of the clicked entity, creating a pull effect. Additionally, the pull effect is halved with the x, y, and z multiplers, meaning that, if repeated, the interacted entity will eventually be too far away for the player to interact with.