• You've discovered RedGuides, an EverQuest multi-boxing and scripting community 🧙‍♀️⚙️. We want you to play several EQ characters at once, come join us and say hello! 👋

  • A TLP without truebox has thawed (Very Vanilla ready)
    Frostreaver

RGMercs RGMercs Assist System Guide

Joined
May 5, 2024
RedCents
21,850¢
The assist system in RGMercs was updated on 3 Sep 2025. The changes are large enough that I felt a guide was warranted:

The Changes:
  • The "Outside Assist List" is now simply the "Assist List". Many times, we aren't "outside" at all, and the term could be misleading.
    • Any time we want to assist someone that does not carry the appropriate EQ main assist role (in our raid/group), this list will/must be used.
    • Please note that commands related to managing the list have changed along with the name. I apologize for the changes, and possit that the pros outweigh the cons here.
  • The logic of how we assist has been adjusted, to include fallbacks. Additionally, fallback to self is now a possibility.
  • Commands have been added to handle the Assist List on the fly in buttons or via CLI. This keeps with the "Mercs standard": Anything you can do in the UI, you can do via CLI... and vice versa.
Assist Logic Flow... Picture Version
1756748685091.png
To summarize, if the Assist List is activated, we use it, falling back to ourselves (if that is enabled).
If it is not, we will check our raid/group roles for Assists and use their targets if found, falling back to ourselves (again, if that is enabled).
The important thing to understand is that are are constantly revalidating the assist. As soon as the situation changes, our assigned assist may change as well.


The Instructions... RTFM!

How to set assists for my (non-raid) GROUP:
Set the "Main Assist" Role in your Group Window. You are done. That easy.
1756749475612.png

If you don't wish to assign the role, or wish to choose someone else, use the assist list (see below for the assist list tutorial).
Forgot to set your roles? We got you, fam:
Main Window > 1756749687221.png1756749997655.png < Startup message.

Main Assist ranger-gates back to GL or PoK? We will fallback to ourselves, if you set "Self-Assist Fallback" (This option is enabled in groups by default, and can be found in the main options on the Engage tab, or changed with /rgl set).
Fallback Setting>1756920044097.png1756919776705.png1756749916736.png< We will also let you know!

While everyone doing their own thing may sound odd, in testing, it works pretty durn okay! Everyone uses the same logic, and largely ends up on the same target (Usually the one your tank was already fighting). Coding to fallback to some other arbitrary party member is possible, but I've deemed it not feasible at this time. Once the Group MA is assigned, or back in-zone, we will seamless use them as the assist again.



How to set assists for my RAID:
Using raid assists is very similar to setting group roles above.
Again, if you don't wish to assign the raid roles, or wish to choose someone that isn't assigned to them, please use the assist list (see below for the assist list tutorial).

Raids can have up to three assists*. First, choose which assist you would like to use. This is also in the main config settings, on the engage tab (the default is to use the first).
You can change between them on the fly in the UI, or with the command /rgl set RaidAssistTarget #, where # is 1, 2, or 3.
1756751527031.pngRaid Assist Target Setting.

Again, warnings are set up if the roles are not set:
1756752259697.png

The "Self-Assist Fallback" setting is disabled by default for raids, to avoid someone going rogue and causing wipes. For instructions on changing the setting (location, pictures, etc), see the group how-to above.

Special Note: Mercs will only check for the raid assist that you have designated... it does not check the others! Please ensure the value is correct.
Also note that MQ may report the name of the first raid assist in every position, based on raid leadership AA or assigned assists, so a quasi-fallback exists.

* Some EMU servers do not allow leadership AA, or do not grant leadership AA by default. In this situation, please use the assist list.




How to set assists using the Assist List:
First, be aware that enabling the Assist List locks out any check of Raid or Group roles! If we fail to find a valid assist on the Assist List, fallback to self is the only option, depending on your current Self-Assist Fallback settings, and whether you are currently in a raid or group (see explanations above).

Secondly, as mentioned in Changes, the assist list can be (mostly) fully controlled via the UI or a CLI (Command-Line Interface). This allows you to create hotkeys, multilines, or integrate this list into other scripts as desired.

We will process the list in numerical order. The first valid target will be used. As with group/raid roles, the assist is constantly being revalidated; actions such as adjusting the list (by adding, or removing) or adjusting the order, or factors such as death or abscence of a target may cause a new assist to be selected. This can be leveraged to quickly change your desired assist in fluid encounters. The list can also be cleared entirely, if desired.

The Assist List can be accessed from the main RGMercs window:
1756752711927.png<Click the collapsing header as show to display the Assist List.

Turning the list on:
1756923690657.png 1756923770375.png< Command: /rgl set UseAssistList true Valid Arguments: true/false, off/on, 1/0

Adding a character: Adding via CLI does not confirm that the name used is a valid spawn, so typos are possible. I have added YourMom to my assist list many times during my tests.
1756923667513.png< Command: /rgl assistadd algar If a name is not specified, your current target is added.

Deleting a character: Use the trash can icon which is how I removed YourMom.
1756923845383.png< Command: /rgl assistdelete algarpal or /rgl assistdelete 2 Both of these will remove "Algarpal" from the list, as he is currently in position 2.

Moving a character's position in the list: Use the up or down arrows.
1756923879705.png< Command: /rgl assistup algarpal or /rgl assistup 2 Both of these will move "Algarpal" up one position, as he is currently in position 2.

1756923902286.png< Command: /rgl assistdown algarpal or /rgl assistdown 2 Both of these will move "Algarpal" down one position, as he is currently in position 2.

Clearing the list:
Breaking my own rules, this is currently not implemented in the UI. My major concern is accidental button presses. Perhaps, in the future, if we provide the ability to save and load custom lists, this will be added.
Command: /rgl assistclear

Final thoughts: minor details, unsolicited advice:
Adding yourself to the assist list seems awkward, but is probably best if you are designating yourself as the driver. At least, until I suppress the warning messages when you haven't done that! Coding around whether we are the MA because we are falling back vs we are the MA because we *want* to be could be tricky. As a beneficial side effect, it may be easier to set up buttons or scripts that interface with the Assist List.

Adding non-peers (read: outside parties) to the assist list has had only rudimentary testing. I will endeavor to test this better as time goes on. While the code will instruct your PC to target your selected assist to get the target-of-target, I can see possibilities for this breaking down without a good recourse.

If you find issues with this, I would advise you to consider remaining the MA on your driver, and simply determining the targets yourself, by disabling auto target in the tanks engage settings... Or, leaving everyone else assisting you with your driver being the one person assisting the outside party.

Finally... further improvements are always on the horizon, and feedback is always requested! Feel free to hit us up here, or find is in our living room (the #rg-mercs channel on the RG discord)!
 
Last edited:
This feature is in final testing. To avoid Labor Day weekend (bonus xp) disruption, and to give notice, the update is scheduled to be released on 3 Sep 2025.
On Wednesday, we will release an update that slightly overhauls the underlying assist systems in RGMercs - Lua Edition! We have changed and added features and commands, so I felt a guide was warranted.

The Changes:
  • The "Outside Assist List" is now simply the "Assist List". Many times, we aren't "outside" at all, and the term could be misleading.
    • Any time we want to assist someone that does not carry the appropriate EQ main assist role (in our raid/group), this list will/must be used.
    • Please note that commands related to managing the list have changed along with the name. I apologize for the changes, and possit that the pros outweigh the cons here.
  • The logic of how we assist has been adjusted, to include fallbacks. Additionally, fallback to self is now a possibility.
  • Commands have been added to handle the Assist List on the fly in buttons or via CLI. This keeps with the "Mercs standard": Anything you can do in the UI, you can do via CLI... and vice versa.
Assist Logic Flow... Picture Version
View attachment 71508
To summarize, if the Assist List is activated, we use it, falling back to ourselves (if that is enabled).
If it is not, we will check our raid/group roles for Assists and use their targets if found, falling back to ourselves (again, if that is enabled).
The important thing to understand is that are are constantly revalidating the assist. As soon as the situation changes, our assigned assist may change as well.


The Instructions... RTFM!

How to set assists for my (non-raid) GROUP:
Set the "Main Assist" Role in your Group Window. You are done. That easy.
View attachment 71510

If you don't wish to assign the role, or wish to choose someone else, use the assist list (see below for the assist list tutorial).
Forgot to set your roles? We got you, fam:
Main Window > View attachment 71512View attachment 71515 < Startup message.

Main Assist ranger-gates back to GL or PoK? We will fallback to ourselves, if you set "Self-Assist Fallback" (This option is enabled by default and can be found in the main options on the Engage tab, or changed with /rgl set).
Fallback Setting*>View attachment 71513View attachment 71514< We will also let you know!
*please note that to turn this off, you may need to toggle "Show Advanced Options"

While everyone doing their own thing may sound odd, in testing, it works pretty durn okay! Everyone uses the same logic, and largely ends up on the same target (Usually the one your tank was already fighting). Coding to fallback to some other arbitrary party member is possible, but I've deemed it not feasible at this time. Once the Group MA is assigned, or back in-zone, we will seamless use them as the assist again.



How to set assists for my RAID:
Using raid assists is very similar to setting group roles above.
Again, if you don't wish to assign the raid roles, or wish to choose someone that isn't assigned to them, please use the assist list (see below for the assist list tutorial).

Raids can have up to three assists*. First, choose which assist you would like to use. This is also in the main config settings, on the engage tab (the default is to use the first).
You can change between them on the fly in the UI, or with the command /rgl set RaidAssistTarget #, where # is 1, 2, or 3.
View attachment 71517Raid Assist Target Setting.

Again, warnings are set up if the roles are not set:
View attachment 71518

And, the same rules as group roles apply! If the option-designated raid assist isn't assigned, is dead, or not in-zone, we will fallback to ourselves, if that setting is enabled.

Special Note: Mercs will only check for the raid assist that you have designated... it does not check the others! Please ensure the value is correct.
Also note that MQ may report the name of the first raid assist in every position, based on raid leadership AA or assigned assists, so a quasi-fallback exists.

* Some EMU servers do not allow leadership AA, or do not grant leadership AA by default. In this situation, please use the assist list.




How to set assists using the Assist List:
First, be aware that enabling the assist list locks out any check of Raid or Group roles! If the assist list fails to find a valid target, fallback to self is the only option.
Secondly, as mentioned in Changes, the assist list can be (mostly) fully controlled via the UI or a CLI (Command-Line Interface). This allows you to create hotkeys, multilines, or integrate this list into other scripts as desired.
We will process the list in numerical order. The first valid target will be used. As with group/raid roles, the assist is constantly being revalidated; actions such as adjusting the list (by adding, or removing) or adjusting the order, or factors such as death or abscence of a target may cause a new assist to be selected. This can be leveraged to quickly change your desired assist in fluid encounters. The list can also be cleared entirely, if desired.

The Assist List can be accessed from the main RGMercs window:
View attachment 71519<Click the collapsing header as show to display the Assist List.

Turning the list on:
View attachment 71520View attachment 71521 < Command: /rgl set UseAssistList true Valid Arguments: true/false, off/on, 1/0

Adding a character: Adding via CLI does not confirm that the name used is a valid spawn, so typos are possible. I have added YourMom to my assist list many times during my tests.
View attachment 71522< Command: /rgl assistadd algar If a name is not specified, your current target is added.

Deleting a character: Use the trash can icon which is how I removed YourMom.
View attachment 71523< Command: /rgl assistdelete algarpal or /rgl assistdelete 2 Both of these will remove "Algarpal" from the list, as he is currently in position 2.

Moving a character's position in the list: Use the up or down arrows.
View attachment 71525< Command: /rgl assistup algarpal or /rgl assistup 2 Both of these will move "Algarpal" up one position, as he is currently in position 2.

View attachment 71526< Command: /rgl assistdown algarpal or /rgl assistdown 2 Both of these will move "Algarpal" down one position, as he is currently in position 2.

Clearing the list:
Breaking my own rules, this is currently not implemented in the UI. My major concern is accidental button presses. Perhaps, in the future, if we provide the ability to save and load custom lists, this will be added.
Command: /rgl assistclear

Final thoughts: minor details, unsolicited advice:
Adding non-peers (read: outside parties) to the assist list has had only rudimentary testing. I will endeavor to test this better as time goes on. While the code will instruct your PC to target your selected assist to get the target-of-target, I can see possibilities for this breaking down without a good recourse.

If you find issues with this, I would advise you to consider remaining the MA on your driver, and simply determining the targets yourself, by disabling auto target in the tanks engage settings.

Finally... further improvements are always on the horizon, and feedback is always requested! Feel free to hit us up here, or find is in our living room (the #rg-mercs channel on the RG discord)!
Excited to use it!
 
sorry if I am doing necro post here, I look for thread that has same topic.
my question: how does outside assist work and what I suppose to use it for?
I was thinking that if I have some char outside group that I want to play with, or 2 group or some thing, then I add all chars to all "outside assist" lists on all chars?
then, they will assist each char if getting attack?
or is OA only suppose to be for tank chars? like if I have tank char in group-1 and tank char in group-2 then I only have the tank in group-2 list on the chars in group-1, and then the tank in group-1 list on all chars in group-2?
am confused how to make 2 group "help" each other. plan is for do small raids with 2 group later. want all char in both group to help attack any mob that tank-1 OR tank-2 is fighting, and priority would be if their group MA has target or if OA tank has target, like if group-1 tank has target, then all chars in group-1 AND group-2 will attack group-1 tank target.
then if group-1 tank not have target, all char from both group attack group-2 tank target.
is working this way or no? then how to set?

also will like if possible that all char still fight mob if tank dies.
right now, if tank dies, then all char sit there do nothing and must /rgl pause all char to fight them manual.
so then i think if I add all char to OA they maybe fight after tank die? or no?
tyvm! :}
 
Just and FYI, and not sure if it helps you, but today/tomorrow, Algar is pushing an assist overhaul for RG Mercs Lua, check this out: https://www.redguides.com/community/threads/assist-system-overhaul-guide-coming-3-sep-2025.94931/

Parks And Recreation Wow GIF
 
I have updated the guide to reflect that the "Self-Assist Fallback" option can now be seperately enabled or disabled when the PC is a group or raidmember.
The default is "Only in Groups". This should stop raid members from going rogue and causing wipes by default, while allowing new players to still have fallback functionality when they first start using mercs.
The setting can be found on the engage tab. Note that this setting does not interface with whether you are using the Assist List; we are only checking raid or group status.

The update will be pushed shortly.
 
I am confused on how to assist automatically out of group. the toon will assist if manually the assist list. but after mob dies, will not engage again unless i click it
 
I am confused on how to assist automatically out of group. the toon will assist if manually the assist list. but after mob dies, will not engage again unless i click it
I'm sorry, I'm not quite catching what you are throwing here. It isn't clear to me what is happening.

Could you explain in a little more detail?
Do you have the assist list enabled, with a valid PC on the list?
 
I'm sorry, I'm not quite catching what you are throwing here. It isn't clear to me what is happening.

Could you explain in a little more detail?
Do you have the assist list enabled, with a valid PC on the list?
i have a full group and want a seventh toon to assist outside of the group. The group has MA set. The outside ranger has MA on assist list. his target in noted with the large health bar. the ranger will assist if i click on the MA name on the UI. once it is dead, he will not assist again unless i manually click the ma again
 
i have a full group and want a seventh toon to assist outside of the group. The group has MA set. The outside ranger has MA on assist list. his target in noted with the large health bar. the ranger will assist if i click on the MA name on the UI. once it is dead, he will not assist again unless i manually click the ma again
Can you please confirm that they useassistlist setting is on for the seventh toon?

Are all of these toons on the same network?
 
not sure what that setting is, yes same network


oh yes it says enabled
Alright... I'm still not sure what "his target in noted with the large health bar. the ranger will assist if i click on the MA name on the UI. once it is dead, he will not assist again unless i manually click the ma again", but it seems to me that its possible that the click may not have anything to do with it. This could be a performance issue? Let's rule that out.

Let's do this:
* Absolutely ensure that you have the mq frame limiter properly configured and that this isn't a performance issue (There is a link in my signature).
* Confirm that your assigned MA using the OAL is actually showing up in the MA block in mercs (see attached image).

Once you have completed both of the above and the issue persists (and only then), please open your RGMercs window on the affected character, find the Console near the bottom, and open it. Check the "Log to File" toggle. Please ensure the logging actually covers the timeframe you are reproducing your specific issue. Once you have, you likely want to turn log to file off again.
The log will be output to your MQ directory, in the Logs folder. DM me the file here, or on discord, and I can have a look at what is going on. We'll get you sorted!
 
Let me start over. I configured the frame limiter the same as showed in the video. I six box with ctwn plugins. On occasion I want one of the toons to assist outside of group. I pause the CTWN plugin. and start the /rg merc Lua.
The UI loads. The box group has the main tank/MA set to SK. On the outside toon, the SK is set to the assist list and the list is enabled. On the RG UI the Green bar shows running. The second bar is auto target which populates with the MA target. The ranger engages. Then the corpse goes to top of XTar window and is the rangers current target. The Autotarget window picks up the MA target with distance info and health. The ranger does nothing. If i click the MA name in the Use Assist List, the ranger will then engage that target. I dont see the image you mentioned for OAL (meaning)? Im not sure that the Migration was completed to MQ2, when i go to the launcher and hit settings there is a button next to MYSEQ and Settings that says migrate to macroquest. when i follow it to the end of the prompts the error message state "can not index into null array.' In other I'm very slow news, i have no idea how to dm here or discord.
 
Let me start over. I configured the frame limiter the same as showed in the video. I six box with ctwn plugins. On occasion I want one of the toons to assist outside of group. I pause the CTWN plugin. and start the /rg merc lua.
The UI loads. The box group has the main tank/MA set to SK. On the outside toon, the SK is set to the assist list and the list is enabled. On the RG UI the Green bar shows running. The second bar is auto target which populates with the MA target. The ranger engages. Then the corpse goes to top of XTar window and is the rangers current target. The Autotarget window picks up the MA target with distance info and health. The ranger does nothing. If i click the MA name in the Use Assist List, the ranger will then engage that target. I dont see the image you mentioned for OAL (meaning)? Im not sure that the Migration was completed to MQ2, when i go to the launcher and hit settings there is a button next to MYSEQ and Settings that says migrate to macroquest. when i follow it to the end of the prompts the error message state "can not index into null array.' In other I'm very slow news, i have no idea how to dm here or discord.
Sorry, I said OAL and meant "assist list", it used to be called the "outside assist list".

We have three methods to obtain a target from an assist that doesn't have a role in MQ.
It sounds like the first two (actors and dannet) are failing... and the third (which is manual target and assist) can be problematic (and may need adjusting).
I'll need those logs to confirm that, really.

There is a mail/letter icon to the right of my name, which can be used to send a message.

Unfortunately, I can't really advise you on any MQ2 migration, I never used MQ2.
 
RGMercs RGMercs Assist System Guide

Users who are viewing this thread

Back
Top
Cart