PortableLight

Table of Contents

(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

Comments

thelonelypixelfj
- Join Date: 12/23/2019
- Posts: 6
- Member Details
#52 thelonelypixelfj

View User Profile

Send Message

Posted Dec 25, 2019
Does this plugin work with 1.15?

Rollback Post to Revision RollBack
_ForgeUser8978456
- Join Date: 6/3/2012
- Posts: 52
- Member Details
#51 _ForgeUser8978456

View User Profile

Send Message

Posted Apr 25, 2015
@Talffury

I'll try to do that as soon as possible.

Rollback Post to Revision RollBack
Talfereg
- Location: Windsor
- Join Date: 5/18/2008
- Posts: 35
- Member Details
#50 Talfereg

View User Profile

Send Message

Posted Apr 8, 2015
Please update to 1.8.1 or 2 or 3 :D

Rollback Post to Revision RollBack
_ForgeUser19347346
- Join Date: 3/15/2015
- Posts: 1
- Member Details
#48 _ForgeUser19347346

View User Profile

Send Message

Posted Mar 15, 2015
Please make video tutorial for the installation of the plugin.

Rollback Post to Revision RollBack
_ForgeUser8978456
- Join Date: 6/3/2012
- Posts: 52
- Member Details
#47 _ForgeUser8978456

View User Profile

Send Message

Posted Jan 17, 2015
@jpell1221

v1.5a is based on bukkit 1.8.. You can use v1.3d with bukkit 1.7.9 only, because bukkit 1.7.10 uses craftbukkit v1_7_R4 while the plugin was compiled with v1_7_R3 (the previous version from bukkit 1.7.9).

~~I might upload a 1.7.10-backport version if possible.~~ It's not possible to upload a 1.7.10-backport version since dev.bukkit.org does not support 1.7.10 builds:

Last edited by _ForgeUser8978456: Jan 17, 2015

Rollback Post to Revision RollBack
_ForgeUser7528095
- Join Date: 9/10/2011
- Posts: 132
- Member Details
#46 _ForgeUser7528095

View User Profile

Send Message

Posted Jan 16, 2015
@GameplayJDK

I am using 1.7.10 with 1.7.9 version shall it not work like that?

Rollback Post to Revision RollBack
_ForgeUser8978456
- Join Date: 6/3/2012
- Posts: 52
- Member Details
#45 _ForgeUser8978456

View User Profile

Send Message

Posted Jan 16, 2015
@jpell1221

Are you using the latest bukkit version (1.8) and the latest plugin version (v1.5a)?

It seems like you're running another plugin version because in the new version there is no v1_7_R3 import.

Last edited by _ForgeUser8978456: Jan 17, 2015

Rollback Post to Revision RollBack
_ForgeUser7528095
- Join Date: 9/10/2011
- Posts: 132
- Member Details
#44 _ForgeUser7528095

View User Profile

Send Message

Posted Jan 15, 2015
I get this with the file in my /plugins folder

15.01 16:53:10 [Server] WARN ... 3 more 15.01 16:53:10 [Server] WARN at java.lang.ClassLoader.loadClass(ClassLoader.java:358) 15.01 16:53:10 [Server] WARN at java.lang.ClassLoader.loadClass(ClassLoader.java:425) 15.01 16:53:10 [Server] WARN at org.bukkit.plugin.java.PluginClassLoader.findClass(PluginClassLoader.java:62) 15.01 16:53:10 [Server] WARN at org.bukkit.plugin.java.PluginClassLoader.findClass(PluginClassLoader.java:67) 15.01 16:53:10 [Server] WARN Caused by: java.lang.ClassNotFoundException: org.bukkit.craftbukkit.v1_7_R3.CraftWorld 15.01 16:53:10 [Server] WARN at java.util.TimerThread.run(Timer.java:505) 15.01 16:53:10 [Server] WARN at java.util.TimerThread.mainLoop(Timer.java:555) 15.01 16:53:10 [Server] WARN at de.GameplayJDK.PortableLight.PortableLight$LightUpdater$1.run(PortableLight.java:96) 15.01 16:53:10 [Server] WARN java.lang.NoClassDefFoundError: org/bukkit/craftbukkit/v1_7_R3/CraftWorld 15.01 16:53:10 [Server] WARN Exception in thread "LightUpdater"

Rollback Post to Revision RollBack
_ForgeUser8978456
- Join Date: 6/3/2012
- Posts: 52
- Member Details
#43 _ForgeUser8978456

View User Profile

Send Message

Posted Jan 15, 2015
@DrkMatr1984

This is caused by a missing PortableLights.properties file inside the './plugins' directory. The plugin doesn't create that file automatically in this version.. I'll fix that in v1.5b :)

@kdthehun

I'll do that :)

Rollback Post to Revision RollBack
_ForgeUser10241261
- Join Date: 12/20/2012
- Posts: 114
- Member Details
#42 _ForgeUser10241261

View User Profile

Send Message

Posted Jan 15, 2015
Please post a sample PortableLight.properties file because it is VERY unclear as to how one should format it. I tried several different ways and it didn't work. Also Do we use item names, or ID, or minecraft:item_name ?

Rollback Post to Revision RollBack

DrkMatr1984

Location: Middletown
Join Date: 6/24/2013
Posts: 293
Member Details

#41 Posted Jan 13, 2015

@GameplayJDK

Hey! I get this on load.

[20:35:06] [Server thread/INFO]: [PortableLight] Enabling PortableLight v1.5a
[20:35:06] [Server thread/WARN]: java.io.FileNotFoundException: ./plugins/PortableLight.properties (Is a directory)
[20:35:06] [Server thread/WARN]: 	at java.io.FileInputStream.open(Native Method)
[20:35:06] [Server thread/WARN]: 	at java.io.FileInputStream.<init>(Unknown Source)
[20:35:06] [Server thread/WARN]: 	at de.GameplayJDK.PortableLight.PropertiesLoader.load(PropertiesLoader.java:32)
[20:35:06] [Server thread/WARN]: 	at de.GameplayJDK.PortableLight.PortableLight.loadConfiguredMaterials(PortableLight.java:36)
[20:35:06] [Server thread/WARN]: 	at de.GameplayJDK.PortableLight.PortableLight.onEnable(PortableLight.java:19)
[20:35:06] [Server thread/WARN]: 	at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:321)
[20:35:06] [Server thread/WARN]: 	at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:335)
[20:35:06] [Server thread/WARN]: 	at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:405)
[20:35:06] [Server thread/WARN]: 	at org.bukkit.craftbukkit.v1_8_R1.CraftServer.loadPlugin(CraftServer.java:355)
[20:35:06] [Server thread/WARN]: 	at org.bukkit.craftbukkit.v1_8_R1.CraftServer.enablePlugins(CraftServer.java:315)
[20:35:06] [Server thread/WARN]: 	at net.minecraft.server.v1_8_R1.MinecraftServer.q(MinecraftServer.java:402)
[20:35:06] [Server thread/WARN]: 	at net.minecraft.server.v1_8_R1.MinecraftServer.k(MinecraftServer.java:370)
[20:35:06] [Server thread/WARN]: 	at net.minecraft.server.v1_8_R1.MinecraftServer.a(MinecraftServer.java:325)
[20:35:06] [Server thread/WARN]: 	at net.minecraft.server.v1_8_R1.DedicatedServer.init(DedicatedServer.java:211)
[20:35:06] [Server thread/WARN]: 	at net.minecraft.server.v1_8_R1.MinecraftServer.run(MinecraftServer.java:494)
[20:35:06] [Server thread/WARN]: 	at java.lang.Thread.run(Unknown Source)
[20:35:06] [Server thread/INFO]: [PortableLight] Enabled!

And then it creates a directory called "PortableLight.properties" with no files in it. I think you want it to create a file named PortableLight.properties inside of the PortableLight directory instead :P

_ForgeUser8978456
- Join Date: 6/3/2012
- Posts: 52
- Member Details
#40 _ForgeUser8978456

View User Profile

Send Message

Posted Sep 8, 2014
@NinjarakuPwnz

I'll test a few things and try to fix that issue, but I can't promise, that I can solve it, it most likely is another problem that comes with server-side lightning :/

Rollback Post to Revision RollBack
_ForgeUser11190718
- Join Date: 5/4/2013
- Posts: 23
- Member Details
#39 _ForgeUser11190718

View User Profile

Send Message

Posted Sep 4, 2014
Perfect for my medieval server, too bad it's flashing on and off underground... were running 1.7.9 R0.2 cb and no error messages or anything just flashing like a strobe torch...

Last edited by _ForgeUser11190718: Sep 4, 2014

Rollback Post to Revision RollBack
_ForgeUser8978456
- Join Date: 6/3/2012
- Posts: 52
- Member Details
#38 _ForgeUser8978456

View User Profile

Send Message

Posted Aug 30, 2014
@DarthRiddle

I'll release a 1.7.10 version, but it may be unstable. Normally I avoid compile with dev-builds, but since there doesn't seem to be a beta-build soon, I'll make an exception with this. v1.4a will be compiled with cb1.7.10-R0.1 dev build #3115. :)

EDIT: There is currently no way to upload plugins for version 1.7.10, as soon as it's possible, I'll upload 1.4a.

@LegendaryAdmin

Thank you for your interest :) The trail of light seems to be a client side issue, Serverside there should be a lightlevel of 0,but somehow the client is thinking, the lighlevel is somewhere between 1 and 3 (current maximum is 10). In some cases this is caused by transparent blocks (such as grass, dead bushes, vines, ...), and in other cases it's not... I'll do more testing to fix this problem, but I can't guarantee anything. Thanks for the suggestion, but there is one issue with it: If you use those potion effects, you won't be able to further than 5 blocks because of the blindness :/

Last edited by _ForgeUser8978456: Aug 30, 2014

Rollback Post to Revision RollBack
_ForgeUser14100981
- Join Date: 4/16/2014
- Posts: 97
- Member Details
#37 _ForgeUser14100981

View User Profile

Send Message

Posted Aug 27, 2014
Our server has been following this plugin for quite some time and we really want this to work!! As you have mentioned, you can't do much about the flickering until the API changes. What I haven't seen discussed yet, is that it leaves a trail of light where ever we walk. I am sure this is due to the way bukkit updates its blocks as well...

I hate to suggest it, but perhaps the method of lighting blocks is too literal. Instead of thinking of this as having to effect each block with "light" Have you considered using a mixture of effects to get the same result such as night vision and blindness like this?

https://www.youtube.com/watch?v=FlKK9k5g7zw

I don't know if this could solve all your problems, or if it is far off the mark, worth the suggestion though. In the meantime we are not using any handheld light source and we really, really want one =)

Rollback Post to Revision RollBack
_ForgeUser9153528
- Join Date: 7/8/2012
- Posts: 90
- Member Details
#36 _ForgeUser9153528

View User Profile

Send Message

Posted Aug 24, 2014
Could we get an update to CB 1.7.10? Thanks. This is a great plugin

Rollback Post to Revision RollBack
_ForgeUser8978456
- Join Date: 6/3/2012
- Posts: 52
- Member Details
#35 _ForgeUser8978456

View User Profile

Send Message

Posted Aug 24, 2014
@Jofkos

Until the bukkit API gives us a better method for updating blocks, I can't really do anything about the flickering :/

@CholeraJasna

Caused by: java.lang.ClassNotFoundException
I assume you're using Spigot for minecraft 1.7.10, which uses the API version that is one ahead of the one I used to build 1.3d. It should work fine with spigot for mc1.7.9.
Quote from Main page:
(Recent version works with the 1.7.9-R0.2 CraftBukkit version only)

Last edited by _ForgeUser8978456: Aug 24, 2014

Rollback Post to Revision RollBack
_ForgeUser16841869
- Join Date: 8/21/2014
- Posts: 23
- Member Details
#34 _ForgeUser16841869

View User Profile

Send Message

Posted Aug 23, 2014
@GameplayJDK completelly not working (1.3d on newest Spigot). As OP I'm holding torch, and nothing. Errors in console:

[11:14:05 WARN]: Exception in thread "LightUpdater" [11:14:05 WARN]: java.lang.NoClassDefFoundError: org/bukkit/craftbukkit/v1_7_R3/ CraftWorld [11:14:05 WARN]: at de.GameplayJDK.PortableLight.PortableLight$LightUpdat er$1.run(PortableLight.java:96) [11:14:05 WARN]: at java.util.TimerThread.mainLoop(Unknown Source) [11:14:05 WARN]: at java.util.TimerThread.run(Unknown Source) [11:14:05 WARN]: Caused by: java.lang.ClassNotFoundException: org.bukkit.craftbu kkit.v1_7_R3.CraftWorld [11:14:05 WARN]: at org.bukkit.plugin.java.PluginClassLoader.findClass(Pl uginClassLoader.java:91) [11:14:05 WARN]: at org.bukkit.plugin.java.PluginClassLoader.findClass(Pl uginClassLoader.java:86) [11:14:05 WARN]: at java.lang.ClassLoader.loadClass(Unknown Source) [11:14:05 WARN]: at java.lang.ClassLoader.loadClass(Unknown Source) [11:14:05 WARN]: ... 3 more

Last edited by _ForgeUser16841869: Aug 23, 2014

Rollback Post to Revision RollBack
_ForgeUser10521506
- Join Date: 2/6/2013
- Posts: 49
- Member Details
#33 _ForgeUser10521506

View User Profile

Send Message

Posted Aug 22, 2014
The update light is still flickering in v1.3d

Last edited by _ForgeUser10521506: Aug 22, 2014

Rollback Post to Revision RollBack
FlagCourier
- Location: Oklahoma
- Join Date: 2/28/2012
- Posts: 13
- Member Details
#32 FlagCourier

View User Profile

Send Message

Posted Aug 19, 2014
@GameplayJDK Thanks for the response, I also noticed that spigot.yml now has random light updates set to false by default though I'm pretty sure this is for OpenGL lighting. Enabled and double checked for safe measure, same result :p

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.

Project ID

75271
Created

Feb 27, 2014
Last Released File

Jan 13, 2015
Total Downloads

7,653

Bukkit

PortableLight

Bukkit Plugins

PortableLight

Table of Contents

PortableLight

What is 'PortabLight'?

Features&Commands

Planned Features&Commands

Recently updated

Installation

Media

Suggestions?

Bugs

Comments

About This Project

Categories

Members

Recent Files

Bukkit