This API allows developers to simply convert all blocks in a cuboid of any size into falling sand entities, allowing any blocks in said cuboid to appear to fall out of the sky. It can also be added to a server and used via command blocks to eliminate the need for custom coding.
The falling sand entities will act as they normally would, however, they don't drop any item entities if they get destroyed.
There are three basic commands for the functionality of the plugin: /sand <pos1/pos2>, /sand <pos1/pos2> [x] [y] [z] and /sand start [time].
The first command creates a cuboid with the corners at the foot position of the player that activated them.
The second command can be used with command blocks to create the cuboid between any two coordinates.
On the usage of the start command, the selected cuboid will be converted into falling sand entities. If you include a number with the start command, that determines the time the plugin waits between creating each entity (in milliseconds), effectively controlling the speed of the falling. 5 milliseconds is the recommended speed to create realistic looking falling.
To use these commands, the player will need the permission: sand.sand
To use this API, all you need to do is add the jar as an external jar to your project.
There are four methods in the SandAPI class that you can use. The first two take two Location objects and a World object. The second two take two sets of coordinates instead of Location objects. One method will default to waiting 10 milliseconds between creating each new falling sand entity. The other method takes an Integer that defines how long the plugin should wait in milliseconds before creating each new falling sand entity.
