Edit: Updated notes and merged changes on 3/12/2025.
TLDR: Big update. I expect this update to go live sometime next week. It will affect custom config users, so I'm throwing out a heads up.
This may take a few more days to finish the testing, but the reason things have been so quiet lately is configs have been given a pretty serious revamp. We've overhauled, added more helper functions to eliminate duplicate code, and have tried to make the class config something that is a little easier to read, digest, and customize. Our configs were pretty barebones at first, and in the process of adding functionality, we definitely added some bloat. The latest focus has been removing a decent bit of that, without any loss of functionality. The current removed code is right now somewhere in excess of 2,000 lines across the repo (counted before the addition of a new laz alpha config). About 1700 of them are from class configs.
For the custom config users that are starting to groan right now as they realize what this means, sorry my dudes... we really try to minimize this but it's bound to happen. All I can say is I can pretty much guarantee that the little bit of time you spend with some copy pasting and ctrl+r now will pay off down the road when config entries are just that much simpler to write/copy/work with.
Also, in the process of doing this, we've baked in a lot of the constant revisions and updates that you have been accustomed to seeing.
Here are the final notes:
A special note to the creators/users/editors of custom class configs:
As someone who spends hour upon hour editing configs, I wholly understand and appreciate the amount of thought, work and time that goes into it. I do not take "breaking" configs lightly. I firmly believe that the work spent to restructure your configs will pay dividends in future saved time and effort. Thank you.
Class Config/Helper Function Adjustments:
* Adjusted rotation checks to check if an ability is ready before trying to use them and removed such checks from the class configs.
* * Added various ready checks (Item Ready, etc) to support the above.
* Refactored spell presence and stacking checks to a modular system. Added functions where appropriate. This should greatly simplify the ease of use and understanding for such checks in the class configs. Fix for #237
* Group Buff Checks will now check to ensure a buff isn't blocked before any other checks are made. Fixes #503
* Added additional Targeting helper functions such as "TargetIsMA", "TargetIsMyself", etc, again with the goal of ease of use in class configs.
* Renamed various Casting functions to follow a common theme and for ease of digesting.
* * Example: "DoBuffCheck" is now "OkayToBuff". "DebuffConCheck" is now "OkayToDebuff".
* Added additional Casting helpers to retrieve AA or Item spells more easily.
* * "mq.TLO.Me.AltAbility("RynWondersWhyWeUseFoo").Spell", we now have "Casting.GetAASpell(aaName)".
* "HaveManaToFoo" functions now accept a variable that determines whether to ignore the check in a burn, rather than having two separate functions. (what was previously "HaveManaToNuke" or "BurnCheck" is now a single function). Fixes #508
* We are now able to pass targets in "DetFooChecks", if a target is not passed, the autotarget will be used, with the current target as a fallback. Fixes #501
* Added "FooHealsNeeded" (Light, Main, Big, Group, BigGroup) helper functions to reduce condition footprints.
* Created helper function to check for the Auto Target ID (for ease of reading rotation tables in class configs.)
* The "(HP/Named)StopDOT" settings have been renamed to "Mob Low HP" and "Named Low HP".
* * These settings may be checked for more than just dots; for example, they may also be checked prior to using a nuke with a long cast time, or used as an indicator to use another spell (snaring at low health, refreshing combat buffs for the next fight at low health).
* * Adjusted Snare checks that had a hardcoded health check to use the above settings.
* * [WIZ- Alpha], [MAG]: Removed the custom HP threshold setting for Big Nukes and adjusted checks to use the above settings.
* Added support for Bard meditation
* Enable "Respect Med Settings" on the bard Mana/End Sustain tab to enable meditation. Please check the tooltips or FAQ for more information!
* * This will stop any downtime action from the bard config during meditation.
* * It is recommended you ensure the "Stand When Done Medding" setting is enabled on your bard if you are using this feature.
* Added CastReady checks to combatbuffs that involved (DanNet) peer presence/stacking checks to reduce overhead.
* Made various fixes and tweaks in class configs that are too numerous to list here. Please be on the watch for any new issues, as every single config has been broadly edited. A total of 2000 lines of code are removed in this update, some 1700 of them from the configs (with the intention of zero loss of capability).
Under the Hood/Behavior Adjustments:
* We will now ensure that we had control of our character before checking rotations (stun, charm, fear,mez). Silence will be checked for spells.
* We will now take take a little extra time if meditating to ensure we actually have mana/endurance to use an action (as there are some situations where reported mana while meditating can fluctuate erroneously). Fixes #497
* We will now abort casting when our target is no longer valid or dies, unless the spell is flagged as allowed to continue through variable passing (example: Rez spells, Combat-buff spells where the target is irrelevant). This was previously intended, but other functions were clearing targets just before we checked for a dead target.
* Added an option to disable the behavior in which we rememorize the previous spell in our last spell slot when we use it for buffs. It can be found in the RGMain Spell/Abil options. Further options to allow us to instead rememorize our proper layout spell instead are planned. Partially addresses #472
* Corrected the Force Target being cleared along with the Auto Target when the Force Target was still alive.
* MAs will no longer clear targets as they pull if using the pull module or if the script detects that they (likely) manually pulled a target.
* Adjusted how we set and acquire the autotarget to allow for the fact that we may have pulled the target (via module or manually). The latter is more difficult to detect, so there may be some small amount of false positives, but I do not foresee them causing great or common issues.
* Adjusted later target scans (when Stay on Target is disabled, as it likely should be for tanks) to only flip to a target that isn't locked on the tank (< 100 PctAggro) if the target isn't moving. I don't anticipate this causing issues, but will keep a close eye on it for reversion or further adjustment.
* Also adjusted later target scans to use the autotarget set in the initial stages as the default ID to return if no other more pressing criteria for targeting is met.
* * Between the above two settings, this should solve the issue of constantly and immediately flipping to an xthater you *didn't* pull. Fixes #513
* Songs will now iterate through nearly all of the targeting/range checks that spells do.
Pull Module Adjustments:
* Expanded Group Watch to enable selection of any (or every) group member, by name.
* Exposed the hard-coded navigation delay to the user; changing the "Max Move Delay" will allow Nav to be active for longer periods without reassessing targets.
* Cleaned up and organized config options.
* Moved pull-related group messages to the Announce system. Fixes #515
Mez Module Adjustments:
* Removed confusing and misused "DoAEAEAEAAAAEAEEEAAAMez".
* Adjusted/Added mez module to use the following options:
* * Mez Enabled (enables the entire module without controlling which specific abilities/spells you will use or memorize).
* * Do ST Mez (self-explanatory)
* * Do AE Mez (self-explanatory)
* * Do Mez AA (ENC: Use Beam of Slumber. BRD: Use Dirge of the Sleepwalker).
* Removed superfluous buff population check in mez/charm module (it is now included in the target setting function).
TLDR: Big update. I expect this update to go live sometime next week. It will affect custom config users, so I'm throwing out a heads up.
This may take a few more days to finish the testing, but the reason things have been so quiet lately is configs have been given a pretty serious revamp. We've overhauled, added more helper functions to eliminate duplicate code, and have tried to make the class config something that is a little easier to read, digest, and customize. Our configs were pretty barebones at first, and in the process of adding functionality, we definitely added some bloat. The latest focus has been removing a decent bit of that, without any loss of functionality. The current removed code is right now somewhere in excess of 2,000 lines across the repo (counted before the addition of a new laz alpha config). About 1700 of them are from class configs.
For the custom config users that are starting to groan right now as they realize what this means, sorry my dudes... we really try to minimize this but it's bound to happen. All I can say is I can pretty much guarantee that the little bit of time you spend with some copy pasting and ctrl+r now will pay off down the road when config entries are just that much simpler to write/copy/work with.
Also, in the process of doing this, we've baked in a lot of the constant revisions and updates that you have been accustomed to seeing.
Here are the final notes:
A special note to the creators/users/editors of custom class configs:
As someone who spends hour upon hour editing configs, I wholly understand and appreciate the amount of thought, work and time that goes into it. I do not take "breaking" configs lightly. I firmly believe that the work spent to restructure your configs will pay dividends in future saved time and effort. Thank you.
Class Config/Helper Function Adjustments:
* Adjusted rotation checks to check if an ability is ready before trying to use them and removed such checks from the class configs.
* * Added various ready checks (Item Ready, etc) to support the above.
* Refactored spell presence and stacking checks to a modular system. Added functions where appropriate. This should greatly simplify the ease of use and understanding for such checks in the class configs. Fix for #237
* Group Buff Checks will now check to ensure a buff isn't blocked before any other checks are made. Fixes #503
* Added additional Targeting helper functions such as "TargetIsMA", "TargetIsMyself", etc, again with the goal of ease of use in class configs.
* Renamed various Casting functions to follow a common theme and for ease of digesting.
* * Example: "DoBuffCheck" is now "OkayToBuff". "DebuffConCheck" is now "OkayToDebuff".
* Added additional Casting helpers to retrieve AA or Item spells more easily.
* * "mq.TLO.Me.AltAbility("RynWondersWhyWeUseFoo").Spell", we now have "Casting.GetAASpell(aaName)".
* "HaveManaToFoo" functions now accept a variable that determines whether to ignore the check in a burn, rather than having two separate functions. (what was previously "HaveManaToNuke" or "BurnCheck" is now a single function). Fixes #508
* We are now able to pass targets in "DetFooChecks", if a target is not passed, the autotarget will be used, with the current target as a fallback. Fixes #501
* Added "FooHealsNeeded" (Light, Main, Big, Group, BigGroup) helper functions to reduce condition footprints.
* Created helper function to check for the Auto Target ID (for ease of reading rotation tables in class configs.)
* The "(HP/Named)StopDOT" settings have been renamed to "Mob Low HP" and "Named Low HP".
* * These settings may be checked for more than just dots; for example, they may also be checked prior to using a nuke with a long cast time, or used as an indicator to use another spell (snaring at low health, refreshing combat buffs for the next fight at low health).
* * Adjusted Snare checks that had a hardcoded health check to use the above settings.
* * [WIZ- Alpha], [MAG]: Removed the custom HP threshold setting for Big Nukes and adjusted checks to use the above settings.
* Added support for Bard meditation
* Enable "Respect Med Settings" on the bard Mana/End Sustain tab to enable meditation. Please check the tooltips or FAQ for more information!
* * This will stop any downtime action from the bard config during meditation.
* * It is recommended you ensure the "Stand When Done Medding" setting is enabled on your bard if you are using this feature.
* Added CastReady checks to combatbuffs that involved (DanNet) peer presence/stacking checks to reduce overhead.
* Made various fixes and tweaks in class configs that are too numerous to list here. Please be on the watch for any new issues, as every single config has been broadly edited. A total of 2000 lines of code are removed in this update, some 1700 of them from the configs (with the intention of zero loss of capability).
Under the Hood/Behavior Adjustments:
* We will now ensure that we had control of our character before checking rotations (stun, charm, fear,mez). Silence will be checked for spells.
* We will now take take a little extra time if meditating to ensure we actually have mana/endurance to use an action (as there are some situations where reported mana while meditating can fluctuate erroneously). Fixes #497
* We will now abort casting when our target is no longer valid or dies, unless the spell is flagged as allowed to continue through variable passing (example: Rez spells, Combat-buff spells where the target is irrelevant). This was previously intended, but other functions were clearing targets just before we checked for a dead target.
* Added an option to disable the behavior in which we rememorize the previous spell in our last spell slot when we use it for buffs. It can be found in the RGMain Spell/Abil options. Further options to allow us to instead rememorize our proper layout spell instead are planned. Partially addresses #472
* Corrected the Force Target being cleared along with the Auto Target when the Force Target was still alive.
* MAs will no longer clear targets as they pull if using the pull module or if the script detects that they (likely) manually pulled a target.
* Adjusted how we set and acquire the autotarget to allow for the fact that we may have pulled the target (via module or manually). The latter is more difficult to detect, so there may be some small amount of false positives, but I do not foresee them causing great or common issues.
* Adjusted later target scans (when Stay on Target is disabled, as it likely should be for tanks) to only flip to a target that isn't locked on the tank (< 100 PctAggro) if the target isn't moving. I don't anticipate this causing issues, but will keep a close eye on it for reversion or further adjustment.
* Also adjusted later target scans to use the autotarget set in the initial stages as the default ID to return if no other more pressing criteria for targeting is met.
* * Between the above two settings, this should solve the issue of constantly and immediately flipping to an xthater you *didn't* pull. Fixes #513
* Songs will now iterate through nearly all of the targeting/range checks that spells do.
Pull Module Adjustments:
* Expanded Group Watch to enable selection of any (or every) group member, by name.
* Exposed the hard-coded navigation delay to the user; changing the "Max Move Delay" will allow Nav to be active for longer periods without reassessing targets.
* Cleaned up and organized config options.
* Moved pull-related group messages to the Announce system. Fixes #515
Mez Module Adjustments:
* Removed confusing and misused "DoAEAEAEAAAAEAEEEAAAMez".
* Adjusted/Added mez module to use the following options:
* * Mez Enabled (enables the entire module without controlling which specific abilities/spells you will use or memorize).
* * Do ST Mez (self-explanatory)
* * Do AE Mez (self-explanatory)
* * Do Mez AA (ENC: Use Beam of Slumber. BRD: Use Dirge of the Sleepwalker).
* Removed superfluous buff population check in mez/charm module (it is now included in the target setting function).
Last edited:
