LightAPI 3.2.9

Tested Minecraft Versions:

• 1.8
• 1.9
• 1.10
• 1.11

Source Code:

https://github.com/BeYkeRYkt/LightAPI

RESOURCE IS INACTIVE! SWITCH TO THIS FORK BY @bottomdumber !​

Description:
This small library help you to create an invisible light sources.

Features:
- Create/Delete invisible light source.

Support CraftBukkit implements :
- CraftBukkit/Spigot (1.8.8 - 1.10)
- PaperSpigot (Only 1.8.8)
- Paper (1.9+)
- TacoSpigot (1.9+)
- Cauldron (1.7.10) <Experimental Support>

Basic methods:
- LightAPI

• createLight(World, blockX, blockY, blockZ, lightLevel, async); - Creates light on this location and the level of light. If async state is set to "true", then the request will be created and added to the processing queue.

Code (Text):

LightAPI.createLight(location.getWorld(), location.getBlockX(), location.getBlockY(), location.getBlockZ(), 15, true);

If you have Location, you can use this:

Code (Text):

LightAPI.createLight(location, 15, true);

• deleteLight(World, blockX, blockY, blockZ, async); - delete light on this location. If async state is set to "true", then the request will be created and added to the processing queue.

Code (Text):

LightAPI.deleteLight(location.getWorld(), location.getBlockX(), location.getBlockY(), location.getBlockZ(),  true);

If you have Location, you can use this:

Code (Text):

LightAPI.deleteLight(location,  true);

• collectChunks(Location loc); - Collects and returns a list of changed chunks.

Code (Text):

LightAPI.collectChunks(player.getLocation());

• updateChunk(ChunkInfo info); - It sends the modified chunk players.

Code (Text):

LightAPI.updateChunk(info);

Advanced Methods:
- ServerModManager

• registerServerMod(ServerModInfo info); - Registration of the new platform. ServerModInfo contains a map with classes for initialization NMSHandler under the version of CraftBukkit implementation.

Code (Text):

// Example code from LightAPI 3.0.0
ServerModInfo spigot = new ServerModInfo("Spigot");
spigot.getVersions().put("v1_8_R3", CraftBukkit_v1_8_R3.class);
spigot.getVersions().put("v1_9_R1", CraftBukkit_v1_9_R1.class);
spigot.getVersions().put("v1_9_R2", CraftBukkit_v1_9_R2.class);
spigot.getVersions().put("v1_10_R1", CraftBukkit_v1_10_R1.class);
ServerModManager.registerServerMod(spigot);

• unregisterServerMod(String modName); - Unregistration of CraftBukkit implementation.

Code (Text):

ServerModManager.unregisterServerMod("Spigot");

• getNMSHandler(); - initialized NMSHandler after enable main plugin.

Code (Text):

ServerModManager.getNMSHandler();

Events:
- SetLightEvent
- DeleteLightEvent
- UpdateChunkEvent

Commands:
- /lightapi - main command
- /lightapi update - connect to GitHub and check update

Configuration:

Code (Text):

# LightAPI v3.2.0-dev Configuration
# by BeYkeRYkt
version: 3 //version config
update-delay-ticks: 2 //frequency processing query in ticks
max-iterations-per-tick: 400
updater:
  enable: true
  repo: BeYkeRYkt/LightAPI
  update-delay-ticks: 40
  view-changelog: false
 

Example code:

• BeYkeRYkt's example gist (1.4.1)
• BeYkeRYkt's example gist (1.4.2)
• BeYkeRYkt's example gist (2.0.1)
• BeYkeRYkt's example gist (3.0.0)

Special versions:

• LightAPI-b1649 for spigot build 1649

Known issues:

• Cauldron on the wider area of the light sometimes does not work.
• Sometimes, after the installation of light it disappears.
• Sometimes, the light can not disappear.
• When you'll frequently update the chunks, the server begins to lags.

Source code:
License is MIT.
https://github.com/BeYkeRYkt/LightAPI

If you find any bugs, I ask you to write about it in this thread.