(Recent version works with the 1.8-R1 CraftBukkit version only)

PortableLight

Use the latest version (v1.5a) for the best performance with CB-1.8-R1

Thank you for over 3,000 downloads! <3 <3 <3

What is 'PortabLight'?

It is a Plugin which allows items to act as a lamp while being hold by a player.

Features&Commands

Items act as lamp (with permission: 'portablelight.use' or as op)

Planned Features&Commands

(I'm currently working on them)

Better performance

Installation

Download the plugin
Place it in your 'plugins' directory
Create a file called 'PortableLight.properties' in your 'plugins' (please note that the torch also needs to be added to the 'AllowedMaterials' inside the properties file!)
Start your server
Now the plugin is ready to use (no configuration needed!)

You can un-/register items by changing the 'AllowedMaterials' property in './plugins/PortableLight.properties' ( - all material names are seperated by a comma ( , )).
You can un-/register items by accessing the API programmatically through the 'PortableLight' class ( - remember to add PortableLight as a dependency in your 'plugin.yml'). Included methods:
- .registerMaterial(Material material) - - Register new material
- .registerMaterials(Material... materials) - - Register new materials
- .unregisterMaterial(Material material) - - Unregister registered material
- .unregisterMaterials(Material... materials) - - Unregister registered materials
- .isMaterialRegistered(Material material) - - Determine if a material is registered

Quote from an exmaple PortableLight.properties:
# List of materials that will illuminate (seperated by commas; whitespaces are ignored), e.g.
# AllowedMaterials=<MATERIAL>,<MATERIAL>
AllowedMaterials=TORCH,GLOWSTONE_DUST
You can find a list of all available materials here.

Media

Youtube Video:

Bukkit Plugin Showcase #2: PortableLight (v1.3c)

Suggestions?

I'm happy about every suggestion :)

Bugs

The current version might have bugs, because it uses an untested method to determine the lightlevel, which causes a framedrop on the client
The current version produces an error when there is no PortableLight.properties file inside the './plugins' directory and creates a folder named 'PortableLight.properties' instead. Fix: Create the PortableLight.properties file manually (i.e. touch ./plugins/PortableLight.properties in the server root directory)
No other bugs at the moment