ModBot commands are executed in a few different ways (over EQBC):
/bc <command>
/bc <botname> <command>
/bct <botname> <command>
/bct <channel name> <command>
The above are probably most common but check out the EQBC Forum thread for more methods / features.
You can also configure an alias so you can run modbot on the character you control and execute ModBot commands.
To create the alias you must run this from the EQ prompt:
/alias /mb /echo mb-
Or change the LoadAlias variable in MBCommon.inc [Settings] section from 0 to 1 if you've lost the alias in your Macroquest.ini
With this alias you can tell your bot locally what to do:
/mb makecamp
/mb buffup
/mb letsroll
/mb <command>
abort (Interrupts any cast in progress. Sets DoHeals, DoDebuffs, DoBuffs, and DoMelee FALSE and follows the sender closely. Useful when you want to run away.)
addbuff "<SpellName,ItemName,ect.>|<gem,item,ect..>" SpellAlias TarType (Adds a new buff entry to the character's INI file.)
You must restart the ModBot macro after executing the addbuff command in order to complete the adding of the buff entry.
The Spellname, etc. section can be entered directly (e.g. /mb addbuff "Bone Mask of the Ancient Iksar|item" iksar self) or, if adding a clicky, by holding the item on your cursor (e.g. /mb addbuff "${Cursor.Name}|item" iksar self). Please note that the quotes around the spellname|gem section are required.
TarType will accept multiple targets if quotes are used (e.g. /mb addbuff "Levitiation|gem1" levi "war mnk rog").
addbuff execution will add [ABx], Gem, Spell, SpellAlias, and TarType entries to the characters INI file. The remaining buff lines (SpellFoci, DurMod, etc.) will be added once you restart the ModBot macro (ABCount will also not increment until after re-start). For example, using the Bonemask example command, the following entires will be added to the INI file (where "x" is equal to whatever the next numbered entry is in your AdvBuff section):
[ABx]
Gem=item
Spell=Bone Mask of the Ancient Iksar
SpellAlias=iksar
TarType=self
attack (Sets DoMelee TRUE and forces character to attack the TankName's target)
attack <name or ID> <engage at HP> <disengage at HP> (Sets DoMelee TRUE and forces character to attack the target)
Note: OffTank must be TRUE to use this option
Example 1 - /bc attack badguy
Example 2 = /bc attack badguy 100 20
autobank <itemname1|itemname2 etc>
You need to have a banker targeted or be near one
Will auto-inventory the specified items to your bank.
The autobank command can be used in conjunction with categories that have been defined in the loot.ini. For instance, if you have items marked 'SpellScroll' in your loot.ini, and the ItemName variable has "SpellScroll" included, you can issue the command as follows: /mb autobank SpellScroll . The result will be that all items on your toon that are marked with that category (SpellScroll) in your loot.ini will be auto-banked.
backoff <pause> (Have the character stop attacking its current target. Optionally, set MBPause=true.)
buffup (This will set DoBuffs, DoEvents, and DoHeals TRUE)
campout (Performs a /camp desktop and ends the macro)
campout <sm> <char|trader|botname> (Optionally suspends pet. Optionally camps to Character Select, to your Trader (defined by TraderName), or to a specific character.
cast <spellalias> <on/off> (This will enable or disable the spell associated with this alias)
cast <spellalias> [<spawnname/id> <%t> <grp>] <spellalias> [<spawnname/id> <%t> <grp>] (infinte)
If the spell is detrimental, it will target the requester's target.
If the spell is beneficial, it targets the sender or, if grp is present, it casts buff on group members.
If %t is present, it targets the requester's target.
The cast command will ignore INI settings for things like minmana, maxmana, recasts, buff/debuff counters, etc. This command is mainly used for manual, "one off" type casts.
Example 1 - /bc cast buffhp grp haste bob haste jane dmgshld bob
Example 2 - /bc cast dmgshld bob nuke tash
Example 3 - /bc cast slow "nasty add"
doaa [on, true, off, false, force <no parameter acts like a toggle>. "Force" will force an AA purchase check.]
doafk [on, true, off, false, <no parameter acts like a toggle>]
dobuffbot [on, true, off, false, <no parameter acts like a toggle>] (Places the character in "BuffBot Mode". Currently once set to on/true, it will NOT turn off and you MUST restart the macro to "quit" this mode. It will cast any spell alias on the requesting target. Example: /t <bot name> buffhp
dobuffs [on, true, off, false, <no parameter acts like a toggle>]
docombines (Toggle that turns docombines on/off (default off). Docombines will check for an open tradeskill window with an enabled combine button (you have to select recipe), and will click the button. Upon a successful combine, Modbot's built in cursor handling takes over. Useful for tank to summon more arrows during fight. An associated event will fire and toggle docombines to FALSE when you run out of recipe components.)
docures [on, true, off, false, <no parameter acts like a toggle>]
dodebuffs [on, true, off, false, <no parameter acts like a toggle>]
doevents [on, true, off, false, <no parameter acts like a toggle>]
doforage [on, true, off, false, <no parameter acts like a toggle>]
dofw [on, true, off, false, <no parameter acts like a toggle>]
doheals [on, true, off, false, <no parameter acts like a toggle>]
dolist (Used to /bc out the existing "Do" status)
doloot [on, true, off, false, <no parameter acts like a toggle>]
domelee [on, true, off, false, <no parameter acts like a toggle>]
domount [on, true, off, false, <no parameter acts like a toggle>] (To cast a mount or not, used in conjunction with MountCast INI entry)
dopet [on, true, off, false, <no parameter acts like a toggle>] (To cast a pet or not, used in conjunction with PetCast INI entry)
dopettoys [on, true, off, false, <no parameter acts like a toggle>] (Mage Only - To respond to pettoys requests and give toys to pets)
dopull <on/off/path>
doquest [on,true,off,false] (Default is TRUE. If set to FALSE, your looter will ignore items marked "quest" and still loot other items.)
Can be used to add quest items to your loot.ini file. For example, while holding an item on cursor, /mb doquest 4 Hair of the Dog will set the item you're holding to "=Quest|4|Hair of the Dog|" in loot.ini.
Can also be used in conjunction with the QuestOnly variable (found in the setting section of the loot.ini file). If both doquest and QuestOnly are set to TRUE, your toon will only loot quest items. Also note that if QuestOnly is set to TRUE and doquest is set to FALSE, your toon will only loot cash off of mobs.
Please see the modloot section found here for more information on the loot.ini file.
dorez [on, true, off, false, <no parameter acts like a toggle>] (For automatically accepting rezzes, see below)
dosit [on, true, off, false, <no parameter acts like a toggle>] (For sitting based on Mana/Endurance percentages, see below)
dosongs [on, true, off, false, <no parameter acts like a toggle>] (used for bards only - Alias for dobuffs)
dotells [on, true, off, false, <no parameter acts like a toggle>] (Toggles a beep when tells are recieved from non-netbots toons. Useful for tells in background sessions)
droppet (Signals your group(s) to re-include your Charmed pet in their targeting. You can then drop it, if you still have it charmed)
duck [on, true, off, false, <no parameter acts like a toggle>] (To have the bot duck/unduck. Things like MQ@Melee might force them to unduck, so keep that in mind.)
exclude <mob name,save> (Adds <mob name> to alert list, to save list you must use the "save" option, otherwise it will not be written to the INI file)
The exclude list is maintained by zone. It will exclude mobs that are present on the list from being considered for Melee, Debuffs, etc. Especially useful if you need to fight near 'friendly' NPC's and don't want to accidentally aggro them.
Use the following commands from a character to add mobs to the exclude list (suggest you setup a hotkey or two for this):
/bcaa //mb exclude ${Target.CleanName} Will write the exclusion to a string that is checked through the debuff loop
/bcaa //mb exclude save Will write the exclusion in the mbcommon.ini and that exclusion includes the zone id, so mobs of the same name in a different zone are NOT excluded. You shouldn't have to re-run the macro after an exclude but if you do this in the midst of combat, while mobs are near, it may not "take" as quickly.
For mob names with spaces in them, simply enter the name without any quotations. For example:
/bcaa //mb exclude a small bat
See the Include command (found below) to temporarily remove a mob from the alert list
follow <name> (Follows the sender or <name>)
follow close (Follows the sender within 3 steps, very close)
give <TargetName> <ItemName1|ItemName2,etc> <ItemCount1|ItemCount2,etc> <NoStacks>
Hand item(s) to PC or NPC.
ItemCount is optional and will default to 1. If more than one ItemName, you can have different ItemCounts. If only one ItemCount, it will be used for all of the items.
NoStacks is optional. If omitted, items will be given in stacks.
The give command can be used in conjunction with categories that have been defined in the loot.ini. For instance, if you have items marked 'SpellScroll' in your loot.ini, and the ItemName variable has "SpellScroll" included, you can issue the give command as follows: /mb give Bob SpellScroll . The result will be that all items on your toon that are marked with that category (SpellScroll) in your loot.ini will be handed to Bob.
goto <y> <x> (Character will move to the loc given)
handin (Target an NPC or PC, get one item on your cursor, and all of that item will be handed to them and trade or give button pressed.)
holdup (This will set DoBuffs,DoDebuffs,DoEvents,DoMelee all to FALSE)
include <mob name> (Removes <mob name> from alert list. This will not save to the INI file - see exclude save)
letsroll (This will set DoBuffs, DoHeals, DoMelee, DoEvents, DoDebuffs, and DoCures to TRUE)
makecamp (This will Makecamp at existing location. Use /makecamp off or /mb stop to toggle makecamp functionality off)
mana (Used to /bc out the existing Mana % of the character)
mbpause or mbp [on, true, off, false, <no parameter acts like a toggle>] (Used to pause or unpause the macro)
mbwayplay <PathName> (Used to playback previously recorded paths / waypoints, through zones, doors, chaining paths, etc.)
mbwayrec <PathName> (Used to record a path / waypoint.)
Once started, ducking for each location will add a waypoint to the path.
Sitting stops path recording and returns to modbot functions.
To add doors, chains, pull locations, etc. you'll need to edit the MBWayPlay.INI file
Further information about mbwayplay and mbwayrec (along with examples) can be found here in the wiki.
offtank <on/off> (Toggles offtanking for dealing with adds.)
pettoys (Requests toys for your pet. Needs a mage who has DoPetToys on and setup to respond to the request)
qcast <spellalias> <on/off> (Quiet Cast version of 'cast' - Turn on/off a specific ini entry, without /bc notifications).
qcast <spellalias> [<spawnname/id> <%t> <grp>] <spellalias> [<spawnname/id> <%t> <grp>] (infinte) (Quiet Cast version of 'cast' - without /bc notifications) See 'cast' command for details.
scast <INI file section name|entry#> <on/off> (Specific Cast version of 'cast' - Turn on/off a specific ini entry, without /bc notifications).
scast <INI file section name|entry#> [<spawnname/id> <%t> <grp>] (Specific Cast version of 'cast' - without /bc notifications). See 'cast' command for details.
Example - /bc scast AB|1
script <INI file section name> (This will allow you to run custom commands while the macro is running, or combine series of commands. See script examples below.)
sell <MerchantName> (Sell all items marked SELL in your loot.ini file)
If MerchantName is supplied, it will attempt to sell to that Merchant. If MerchantName is not supplied, and your target is a Merchant, it will use your target. If neither, and you are near (20) a merchant, it will use that merchant.
setinivar <variable name><setting> (This will find and change any setting in your .ini)
Note that this command will have trouble with script settings if you have more than one (it will set the first C1= or whatever that it comes to.
Variables changed in the .ini are /varset with the macro running
Spells, gems, etc. will not be set unless you use the array correctly for <VariableName>. In other words, ADGem[1] is not the same as ADGem1:
Use ADGem[1] and this will set the ADGem1 .ini setting and varset the change to memory.
Use ADGem1 and it will only change the .ini.
sing <spellalias> (Will sing this song and add the respective gem number to the Twist.List, it attempts to use detrimental as the qualifier to add it to combat songs, or rest songs)
stop (Will stop following and/or stop in place)
sung <spellalias> (Will remove this song from the respective Twist.List, it attempts to use detrimental as the qualifier to remove it from combat songs, or rest songs)
tankandheals <unpause> (Set DoMelee/DoEvents/DoDebuffs FALSE on all bots except the tank. Set DoHeals/DoCures/DoBuffs TRUE on all bots. Optionally set MBPause=FALSE.)
Example commands:
/bc Bob follow me [This tells bob and only bob to follow me]
/bc cast dd [this tells every bot to cast the spell alias dd]
/bc shamandude cast buffsta grp buffhp focus grp buffhp %T [buffsta on the group, buffhp on the requester, focus on the group, buffhp on requesters target]
/bc necroguy makecamp [this tells "necroguy" to makecamp]
/bc campout [tells all bots to camp to desktop]
/bc exclude ${Target.CleanName} [tells all bots to add your target to the exclude / ignore list, toons will not attack any spawn with that name.]
/bc clericname dobuffs on [tells the cleric to set DoBuffs to true and will then begin buffing group]
/bc pallyguy cast bmb %t buffhp grp [bmb on requesters target, buffhp on the group]
Typical commands sequence for an EXP group:
/bc letsroll
/bc makecamp
You then begin to pull mobs and they will react accordingly.
Mobile Camp Example:
/bc follow
/bc buffup
[once ready zone into the instance]
/bc stop
/bc letsroll
[clear first room lets say]
/bc follow
[move to next room]
/bc makecamp
[etc, repeat]
Example movement options with or without invis
/bc mbp on
/bc follow
Make a EQBC Channel and do things like (using this technique you don't even have to be a master)
/bct mycoolchannelname //mb letsroll
/bct mycoolchannelname //mb campout