LightHUD+ATE

If you want to buy me a coffee 

This project is born like a fusion of the features of these modules LightsHUD, ATE and DFreds Convenient Effects, but after the initial code i rewriting everything so many times now is just a new module inspired form these other modules.

Remember to support these authors if you feel generous on their patreon or kofi account.

A Foundry VTT module that displays on the HUD config of the token all the available lighting and visions items on the token/actor with two modality:

1. The module setting 'Apply HUD interface on ATE Items' (by default is true) enable some ATE effect, so you can light a torch or turn of without modify the token configuration and you can set with Times up and Dae time and condition of the vision and light effect on the token.

2. The module setting 'Apply HUD interface on flagged Items' (by default is false) enable some old flag system for replicate the old behavior of LightsHUD, but with a more dynamic and customizable integration or for people who don't like ATE and want a minimal setup starting from a series of presets.

3. The module setting 'Enable LightHUD Old Interface' (by default is false) fFor people who want the literally 1:1 same interface of the old LightsHUD you can enable this. Usually this will work better with 'Apply HUD interface on ATE Items' and 'Apply HUD interface on flagged Items' module setting disabled, but they can kind work together

NOTES:

Although not recommended, both modes can be active and the interface will show both ATE effect and item objects with module flags activated. The priority of the light and visual effects will always be given to the ATE effects present on the object if there are both the ATE effects and the module flags.

If both settings are disabled only the two GM management macros will be viewable on the HUD interface, it can be useful for very minimal games without too many gadgets.

Which of the two settings should I choose? If you are experienced enough with active effects I suggest you use the solution with ATE because under the hood it does a lot of cool things that you can't even imagine.

If you ask me the big difference is that the version with flags has the limitation of not "merging" the abilities, but of overriding to keep active one effect at a time, while ATE does the "merge" trying to give the "best of the bunch".

What are the differences between LightHUD, DFreds Convenient Effects and LightHUD + ATE?

The module "LightHUD" is more generic, not in the wrong sense of the term, but there are simply cases where you want to create custom animations for your torches and lanterns and do not been vincolate

The module "DFreds Convenient Effects" it lets you add effects related to ligthing and always customize them with ATE, but it is not bound to the objects currently present in the actor and does not take into account things such as limitation of use and consumption of objects.

NOTE: If you are a javascript developer and not a typescript developer, you can just use the javascript files under the dist folder

Installation

It's always easiest to install modules from the in game add-on browser.

To install this module manually:

1. Inside the Foundry "Configuration and Setup" screen, click "Add-on Modules"
2. Click "Install Module"
3. In the "Manifest URL" field, paste the following url: https://raw.githubusercontent.com/p4535992/foundryvtt-lights-hud-ate/master/src/module.json
4. Click 'Install' and wait for installation to complete
5. Don't forget to enable the module in game using the "Manage Module" button

libWrapper

This module uses the libWrapper library for wrapping core methods. It is a hard dependency and it is recommended for the best experience and compatibility with other modules.

socketlib

This module uses the socketlib library for wrapping socket methods. It is a hard dependency and it is recommended for the best experience and compatibility with other modules.

ATE (old ATL)

This module uses the ATE library for wrapping methods. It is a hard dependency and it is recommended for the best experience and compatibility with other modules.

Warpgate

This module uses the warpgate library for wrapping methods. It is a hard dependency and it is recommended for the best experience and compatibility with other modules.

Suggested mdules to use with this module

• CommunityLighting (need to be updated for 9)
• Times up
• Dae

Compatibility modules

• Sense Walls Multisystem
• About Time

Known Issue\Limitation

• Internazionalization of the labels (is coming after the bug fixing...)
• HELP WANTED This is just a "fast to make" module maybe someone a little more expert than me with form application and hud layer can do a better form for a better user experience
• CommunityLighting is not been updated for foundryvtt 9 so is not advisable to used right now.
• The modules is not smart enough to distinct multiple ligthing effect on the same item and is not make sense ? Every item must have only one effect with ATL changes on it (at least for me). If multiple effect with ATL changes are founded on the same item only the first is analyzed from the module, you can use multiple item where each has is own lighting configuration.
• The warpgate function spawnAt should include a check distance of spawn so no player drop torch on a very far point of the canvas.

Supported Systems

• Dnd5e
• Pathfinder 2e

How can i add my system ? That's is pretty easy on the code level ty to the design pattern so i just need some information on the system rules and voilà.

Feature

Add a custom ATE Effect for customize vision and lighting on my game

This is already done from the ATE checkout the documentation on that module.

Add vision and lighting modification with ATE active effect (the advisable way)

Add vision and lighting modification with ATE active effect, no token configuration is actually touched, everything is on the active effect management, the duration the remove, the adding, you can even merge the effect of two different kind of visions and lighting together.

The module is build to show on a left click of the button with the image of a lightBulb on the hud panel all the item with some ATL effect present on the token\actor, there is a distinction between passive, temporary, applied, need to be attuned or equipped condition (suppressed).

Symbol	Description
	The symbol of the yellow exclamation triangle means the active effect is suppressed for some reason that you can delve into in the effects panel, usually need to be attuned or equipped condition this does not prevent the effect from being active or not, only that it will result in the subcategory of inactive effects.
	The symbol of the light blue infinity means the active effect is passive like a race feature or a special ability like darkvision, this does not prevent the effect from being active or not, only that it will result in the subcategory of inactive effects.
	The symbol of the white clock means the active effect is temporary like a spell valid only for tot. rounds or seconds, this is usually managed from the Times up module if installed, this does not prevent the effect from being active or not, only that it will result in the subcategory of temporary effects.
	The symbol of the orange clock means the active effect is temporary and is expired like a spell valid only for tot. rounds or seconds, this is usually managed from the Times up module if installed, this does not prevent the effect from being active or not, only that it will result in the subcategory of temporary effects.
	The symbol of the green lightbulb means the active effect is enabled (or applied).
	The symbol of the red lightbulb means the active effect is disabled (or not applied).

	The symbol of the coral flag means the light/vision applied is from the flagged feature not the ATE feature.
	The symbol of the blue steel user means the light/vision applied is from the a ATE effect applied on the actor not the item.

By default the module it will roll the item associated to the ATL effect, so you can apply other things like consumable feature and apply measure template.

Add a button to the 'Token vision configuration' macro (for everyone need to be just fast and not perfect)

This is useful for fast configuration during the game, but is advisable to always use items with ATL changes on it.

On the hud config of the token if you are a GM, you can see on the popout form a couple of buttons 'Call macro preset' and 'Call macro custom', they are a embedded version of the macro token_vision_config.js and the variant with about time token_vision_config_about_time.js for make the work of the gm more fast when forget to set some vision.

I add two dialog panel one for put the preset one from the current supported system and one for put a custom preset, no store of these custom is done, if you want to store a custom lighting or vision it's advisable to create a item and apply ATE effects on it.

NOTE: You can still apply the custom vision and light like a new active effect by checking the checkbox Apply as ATE/ATL Effect, so no excuse now.

NOTE: The custom dialog work with CommunityLighting if is enabled and active it will show more options for animation type.

Drop the light (work but need feed back from the community for better user experience)

This feature is inspired from Drop My Torch, but completely rewrite and the actor/token is created on runtime.

If you right click on a image/voice of the hud panel we call the warpgate function spawnAt for let the player drop a light on the canvas.

NOTE: For let player make use of this you need to set the permission of player to create token (i don't know if warpgate has some function with socketLib for executeAsGM).

NOTE: For now there is no discrimination on the item you can drop. You can drop a Torch, like you can drop a Light Spell , like you can drop your Darkvision feature, probably some condition for let drop only physical items

How can i contribute with my ownt item ?

Anyone can contribute with a custom lighting and vision item, you just need to export the item you created with the ATL effect on it and i will create a compendium, or better open a PR on the official ATE compendium.