Okay ... here we go ... [Takes a deep breath and tries to regain his composure].
I realize there is a learning curve to becoming familiar with both MacroQuest2 and KissAssist.
However, that being said, some of these questions are really MacroQuest2 related. And all this information itself is available for "
self learning".
Your last set of questions are dealing with parameters and functions of the MQ2Cast plugin, and downshits/holyshits (functions within the MQ2Melee plugin), and not with the KissAssist macro itself.
You could literally spend the next 2 months asking hundreds of questions about things you are curious about, or you can try to take some pro-active action and read up on MacroQuest2 (its plugins / uses), and the KissAssist macro RedGuides provides to its community.
KissAssist is simply a macro that pulls together the functionality of a few specific MQ2 plugins, and provides you automated functionality to things your character can normally do in game. I would suggest to attain a base level of understanding about MacroQuest2 itself and the various plugins offered by this site for it. I myself spent the better part of a month reading and becoming familiar with it almost a decade ago.
I knew diddly squat about it... but the more I read.. the more I understood.
We have information on the plugins we provide and their functionality/usage on this forum. This information about our plugins either provides full documentation on the functionality/syntax/usage of that plugin or links you directly to the MacroQuest2 wiki page for each plugin to learn
all its parameters/syntax/functionality.
We have a detailed and comprehensive manual for KissAssit (a comprehensive settings manual, a beginners guide to setting KissAssist up, intermediate to advanced guides for using KissAssist etc).
You also have the MQ2 site itself for info on MQ2 and plugins for it. As well as the MQ2 wiki site and a ton of information from multiple sources.
RedGuides has a great community .. and a paid staff... that is always willing to help inform and answer peoples questions.
I'm here, and on the RedGuides payroll, to provide support for KissAssist and to help with general questions (in addition to helping develop/code/fix KissAssist).
However, I have to be honest (and please don't take this the wrong way) but I feel you would benefit from taking the time to read up and become a little more familiar with all this information.
Then... once you have read it... fire away and ask about things that you still have questions about.
Because the answers to every question you just asked are documented and available to everyone.
Here is some light reading for you.
MacroQuest2:
The MacroQuest2 Site
The MacroQuest2 Forums
The Official MacroQuest2 Manual
MacroQUest2 Wiki Site
RedGuides Beginners Guide to MacroQuest2
Redguides Plugin Pages
KissAssist:
KissAssist Beginners Guide
KissAssist Intermediate Guide
KissAssist 7 Instructions & Settings Info
- - - Updated - - -
Having said what I just said.... I'll add my
Red Cents to this posting. (that's much better than my 2 cents).
1.1 Is the statement "gem10" mandatory to describe which spell gem to activate?
I believe gem10 tells MQ2Cast "cast the spell, if it's not loaded mem it in gem10 and cast it." If the spell isn't memmed and you don't specify a gem, I believe MQ2Cast attempts to mem in a default gem, gem5 in my case.
Spot on correct !!!
1.2 What does the "-invis" at the end of this downshit do?
The -invis flag restricts casting to fire only when you are not invisible.
Spot on correct !!!
2.1 My first try at writing a holyshit... My intent is to cast the spell "Spear of Grelleth Rk. II" whenever it's available during all combat situations when my mana is greater than 40%; is this correct or have I missed the boat?
That looks like it should fire if the TLO members are all correct. As per your conditions, holyshits only fire when you are engaged in melee combat, so the check to combat state probably isn't necessary.
Spot on correct !!!
Spear of Grelleth Rk. II is usable by both [Necromancers and Shadowknights]. Depending on which your toon is.. will change what you do entirely. If you are a SK (melee type) and actually melee attack the mob while casting spells... it WOULD be a holyshit. If you are a Necro, you have to make this a downshit.
If you are a SK
Rich (BB code):
holyshit1=/if (${Cast.Ready[Spear of Grelleth Rk. II]} && ${Me.PctMana}>40 && !${Me.Moving}) /casting "Spear of Grelleth Rk. II" gem8
If you are a NEC
Rich (BB code):
downshit1=/if (${Me.CombatState.Equal[COMBAT]} && ${Cast.Ready[Spear of Grelleth Rk. II]} && ${Me.PctMana}>40 && !${Me.Moving}) /casting "Spear of Grelleth Rk. II" gem8
There is no need to use "${Me.CombatState.Equal[COMBAT]}" in the holyshit if you are a melee class, because this holyshit will become active to fire as soon as you start to melee the target and get put into combat state.
I'm using gem8 as an example .. set it to whatever you want your swap out gem to be.
3.1 Is this how to write an AA and/or Combat Ability and/or clickable item in both the [DPS] and [Burn] sections?
I'm not pro at Kiss ini's, but I believe just using the name of the AA is correct. In [DPS] it should be "SpellName|90". In burn it should be "SpellName|Mob" if it is a targetted spell, or "...|Me" or "...|MA" - I'm not sure if Me is valid, but you are just specifying the target here.
Oooohhh so close to being spot on correct !!!
Format is: Spell/AA/Disc/Item|Target Mob/|Pet/|MA/|Me
Mage example:
Rich (BB code):
[Burn]
BurnText=Decepticons Attack
BurnAllNamed=0
Burn1=Frenzied Burnout|Pet
Burn2=Host of the Elements|Mob
Burn3=First Spire|Me
Burn4=Servant of Ro|Mob
Burn5=Ruthless Servant|Mob
Burn6=["SOME BENEFICIAL COMBAT BUFF OR SPELL TO MA"]|MA
Burn7=NULL
Burn8=NULL
Burn9=NULL
Burn10=NULL
3.2 If I left off the "|90" and just wrote the AA name, would it try to use it at target health 100% and less?
I'm not sure here. In looking at the code it looks like it defaults to the specified assist percent in the ini, but I'm not sure.
Assuming you are talking about the DPS section . . . (because I'm really getting confused with the back and forth "cross topic" questions):
If you do not specify a mob %health for the DPS spell to cast at .... it won't cast it at all.
There are full on support tickets with this as the basis of the user's problem ticket. "My toon doesn't cast anything in combat using kissassist dps section and I don't know why"
The reason is either you spelled the spell/disc/aa/item name wrong.. don't actually have the spell/disc/aa/item... or didn't specify a mob% health to cast it at.
4.0 If any ability that was part of a [Burn] or HolyShit section becomes available sometime during a named fight and it wasn't available at the initiation of the fight due to its associated timer, third spire for example, will it be activated immediately when the cooldown timer expires?
If a [Burn] ability becomes available, it will not be cast when it becomes ready, unless burn text is called again. The named check happens once per mob, so setting BurnAllNamed will not change this.
If all conditions for a HS are met, it will fire if you are in combat when it becomes available.
Spot on correct !!!
5.0 Can I use a holyshit to ensure my one handed weapon and shield are equipped?
There are settings in MQ2Melee called aggropri, aggrosec, meleepri, and meleesec. Set these to item ID's, and it should swap for you based on aggro=0/1. This is based on MQ2Melee documentation
here, and I'm not sure if it's still accurate.
Spot on correct !!!
6.0 Can I activate [Burn] using a holyshit?
You could write a HS to activate [Burn] theoretically, but I don't understand the case well enough to figure out why you'd be doing this. Can you elaborate a little on what you're trying to do?
Technically... YES.. you can use a Holyshit to trigger the [BURN] cycle via very specific methods ... but for heaven's sake why would you??????
Don't start trying to get the MQ2Melle plugin to perform actions that KissAssist has its own logic to handle. Burns are meant to be handled the way we have them handled in KissAssist.. and should not be activated via methods available in plugins from which it was not intended to trigger from.
Start down this path.. and you are opening up a floodgate of possible problems. And then you end up trying to troubleshoot both KissAssist and Mq2Melee functions.