Update v.1.1b (13/9/2021): First public beta version released for MZ!.
Update v.1.2b (15/9/2021):
- Now included MV versions!
- Add new parameters: Shadow Ambient and Top Block Ambient. These two color are default choice for all light that not specified this setting. Allow user to control their light shadow ambient color and the ambient color affect top-block. Included two new plugin command to change these but only take effect on the next map.
- The MV version now will be merged to the MZ version and share their development in one plugin file. MZ version have the higher priority though, because PIXI V5 have better optimization for this plugin. MV Demo is completely converted from MZ's one.
- Fix various bugs.
Update v.1.3b (4/11/2021):
- Change the code structure to handling save/load functionality (aka fix my past suckness). Thanks
@Shiko for the feedback.
- Fix some bugs include
@VaiJack8 report of fps drop when changing game variables each frame.
- Get the light layer to draw above the upper layer (everything), intended to use with parallax mapping, as suggest from
@Decinbr. Still need tested though (I don't know how to do parallax mapping).
This is a small update since i came back to plugin coding after my personal issues, just fixing feedbacked bugs and adding suggested feature. I'm pretty dis-motivation now so i hope eveyone can give me more feedback and suggestion I really appreciate that <3.
Update v.1.4b (1/10/2022):
- Re-written the shadow polygon optimization, which both fixed most weird lighting box when drawing unusual shadow shapes, and drastically reduce the shadow segments numbers by roughly 10% (which lead to faster performance).
- Re-organized the region id usage, counting from zero height so that mean now you can draw 0-height shadow caster block, or can be call as top-down-2D-block. You will need to increase the old region id by 1 though. Also now you can limited the region id block by a range instead of only start index like before (default is from 1 to 10).
- Introduce two more special block that can be specified its id (default is 50 and 51): top-roof block and ignore-shadows block. Top-roof block serve the purpose of draw top roof, which no light can be cast on it (useful when you drawing a gate, etc.) and ignore-shadow block will NOT let any shadow ray to be cast on it (can be use when you want to make the illusion of a wall that is higher than the light ray, which the shadow cannot cast to).
- Fixed some minor bugs.
Update v.1.5 (19/1/2022):
- Now preserve various parameters when the game is saved/loaded, i.e. map's ambient, light's status/offset/color. Will add more in the future.
- Add a new parameters to lighting: Status. Control the status allow you to turn on/off the light anywhere you want without need to removing/adding the light repeatedly.
- Add a new parameters to shadow: Offset. Give you control over the shadow source cast position. The shadow offset will be addition with the light offset, i.e. if you set the light offset to 48 and shadow offset to 4, then the shadow source will be calculated at 52.
- Fulfilled all the default parameters. Now you can easily install the plugin to your project without having weird bug cause by the blank parameters. Also add error throwing when you don't have the image file needed.
Update v.1.6 (27/1/2022):
- Now you can draw static lighting using plugin command/ script, by provide it light type and positions. Currently you can't modify, or even change it status, but in exchange it allow you to draw hundreds, or even thousands of static lighting on the map! Note: MV Version blending mode is NORMAL instead of ADD for technical reason (PIXIJS), and I'm gonna patch it in the future if needed.
- Added soft shadow customisation. Allow you to customize soft shadow status/strength/quality. The prefer strength/quality params is 2/1; 1/1; 1/2. All old previous version used 1/2.
- Added customizable color matrix filter to map, which allow you to higher the lights intensity and make lighting blend nicely into map. Currently only 'brightness' is visible in the plugin params, but you can use $shoraLayer.colorFilter to use all the other methods (see
http://filters.pixijs.download/dev/demo/index.html)
- Change lighting registering phase. Now the new lighting type will be registered not only when you create a new game, but when the game boot up (Thanks to
@Enigma_Productions).
- Fix a pretty serious memory leak when update from v1.4 to v1.5. Now it should work fine (test this by repeatingly switch between complex map).
- Fix some others minor bugs.
- Change all both demo's plugin command to use script call instead, for synchronizing easier. You can still use each's plugin commands normally.
Update v.1.7 + v.1.8 (8/2/2020):
- Performance:
+ Lighting layer now will can only be drawn to the map layer. By this, pictures are no longer affected by ambient lighting.
+ Soft shadow now use Kawase Blur instead, which much faster than the old Gaussian Blur.
+ Massive performance improvement by purely render mask texture instead of using filters. This also finally allow the radius and angle features to be added.
- Flexibility:
+ Light's state, shadow's state, radius and angle now can be both set in the plugin manager, in the comment syntax or update dynamically using plugin command/ script call.
+ Change the old comment syntax. The new syntax allow for more flexibility since you can choose whether properties to overwritten.
Example: [flashlight -angle 45 -radius 150 -x 12 -direction off]
Read more about available property in the Wiki. The old syntax ([light flashlight]) will still work, but give a warning in console. Please change to the new syntax. (Just change it to [flashlight] will work).
+ Entire plugin state can be dynamically enable/disable using script: $gameLighting.enable(), $gameLighting.disable(), $gameLighting.setPluginState(true / false).
+ Add helper parameters, which currently allow you to defined your color, and disable engine's shadow. By defined your custom color, you can quickly using the color by its name instead of it value, like [light -tint white] instead of [light -tint
#ffffff].
+ You can now change the map ambient/shadow ambient/top block ambient from the map's notetags. Syntax is [ambient
#333333], [shadowambient night], etc.
+ Temporary remove static lighting feature, to implement custom lighting in the next update. Custom lighting will behave the same as normal character's lighting (so you can still dynamically changes it settings), but with custom position.
- Quality?:
+ By setting radius/angle dynamically by plugin command (by tick similar to offset), you can easily create your own pulsating light/ cycling light. Repeatly changing light with shadow do impact performance, so useful to use this (don't use lots of shadow light continuously pulsating).
+ Moved both the light intensity filters and shadow soft filters to the [Advanced: Filters] section. You can dynamically turn those on/off/set it value.
Update v.1.9 (6/3/2023):
- Massive performance improvement. With Full HD resolution and 100 MOVING lighting & 560 shadow segmentI was able to have ~100 fps using my laptop, when the previous version only have ~14fps. It currently not really stable but it can guaranteed to have at least 5x fps increase on heavy dynamic lighting map. There can be even more optimization in the future since I have already have found what the bottleneck is.
- You can now rotate and scale lighting dynamically WITHOUT impact on shadow performance. Which mean you can have almost every dynamic lights in your game to pulsating for more realistic enhancement and don't need to worry about the fps. With that, the pulse animation option is now worked, you can just enable it in your custom light setting and see the effect.
- Various light parameter now working correctly. For example, you can use [light -r 120 -a 45] to have a quick default light with 120% radius and 45 degree andgle.
- Added tint animation. Now you can animate your light in almost everyway possible: rotating, moving, scaling, flickering and changing colors.
- Fixed various bugs. One important bug I encountered is that if you change paramters on one light, every other lights with the same type will have there paramaters changed (thanks for Javascript reference). It has been fixed.
- Updated the demo, with more animating examples and performance testing maps.
Update v.1.9.1 (6/6/2023):
Download from itch.io page:
https://shoraaa.itch.io/shora-lighting-plugin
- Major optimization, mainly for MV version. Up from 2fps to ~50fps in 100 light 500 shadow benchmark.
- Change the pulse factor defination. Now it is the difference of original light radius. For example: Light with original radius 60 with pulse factor 25% will have their radius ranging from 60 - 60*25% to 60 + 60*25%, which is 45 to 75.
- Add a way to temporary disable the plugin on specific map. Just add [lighting off] to the map notetags instead of using event.
- Fix some minor bugs.