kandashi / Active-Token-Lighting

MIT License
23 stars 25 forks source link

Quick Reference Guide (v10) #115

Closed MaxPat931 closed 1 year ago

MaxPat931 commented 1 year ago

I wrote up this Quick Reference Guide for the usable ATL attribute keys in v10 and what values they accept, I think it would be useful to add as a resource here when the v10 release is ready.

Raw .md available here: https://raw.githubusercontent.com/MaxPat931/Macros/main/QuickReference.md

sharkbruhaha commented 1 year ago

yes please! Thank you for the write-up @MaxPat931 !!

brunocalado commented 1 year ago

Add this documentation and some snippets of how to create new presets.

kaelad02 commented 1 year ago

@MaxPat931 I'm not going to include the testing notes at the end. I assume that's okay, right?

kaelad02 commented 1 year ago

I created a wiki page for this, linked below. I added a little intro text, added the preset key, and skipped the testing notes section. I'll keep this issue open for a few more days (maybe until the weekend) to get immediate feedback.

https://github.com/kandashi/Active-Token-Lighting/wiki/Key-Reference

brunocalado commented 1 year ago

Can you add working snippets of how to use? Noob friendly

please

ATL.AddPreset() takes 2 arguments, the name of the preset to add and the object to add ATL.RemovePreset() takes the name of the preset to be removed ATL.GeneratePreset() will open a dialog to create a new preset ATL.UpdatePresets() will open a dialog to edit,delete,add presets

MaxPat931 commented 1 year ago

Looks good, I think leaving out the testing notes is fine. Might want to either remove ATL.texture.offsetX/Y or note that they dont do anything (core thing, not related to the module) And maybe a note for ATL.light.darkness.min/max since it's not something that is accessible in the UI but is a neat feature

MaxPat931 commented 1 year ago

I updated my file in the original link to separate everything out into sections and using tables (inspired after looking at AdvRem's docs!) but I didnt really do anything with the Description column (I think most are self explanatory so it might not really be necessary, but there are a couple that it could be helpful), but if you like that format better, it's there

kaelad02 commented 1 year ago

Done