XirisBot

XirisBot is an INI-driven MacroQuest bot framework for EverQuest emulator raids. It coordinates class combat routines, healing, curing, buffing, movement, burns, pets, looting, and encounter-specific reactions across a multi-box crew.

The project is built for the RoF2-era MacroQuest environment used by this repository. It assumes a trusted private group or raid: many commands are intentionally accepted through tells, group chat, raid chat, and DanNet messages.

Start here

1. Read Installation and load the required plugins.
2. Create or copy the character INI described in Configuration.
3. Start one character with /mac xiris_bot and resolve any initialization errors.
4. Start the crew and create the recommended Hotkeys.
5. Use the Command reference when building raid or character-specific controls.

Minimal quick start

The loader accepts three tank names, the normal tank heal threshold, and optional auto-assist settings:

/mac xiris_bot MainTank SecondTank ThirdTank 85 "FALSE,98"

If arguments are omitted, XirisBot reads its defaults from the active character INI:

xiris_class_ini/BOT_<CLASS>_<Character>.ini

Example:

xiris_class_ini/BOT_CLR_Xanshia.ini

To start every connected character in the current zone from a tank:

/dgza /mac xiris_bot ${Me.Name} Xiria Xirea 85 "FALSE,98"

Everyday controls

/rs KillMob ${Target.ID} "${Target.CleanName}" ${Time.Time24}
/rs BackOff
/rs FollowMe /type|NAV
/rs NavStop
/rs doRaidBuffs ALL
/rs DebuffTarget ${Target.ID}
/rs BurnOnAll

These are message-driven commands. Sending the text through a supported channel causes each running macro that registered the event to handle it. See Commands for scopes, arguments, and targeted examples.

Supported class macros

Class	Macro	Major capabilities
Bard	bot_brd.mac	Medley, melee, nukes, DoTs, debuffs
Beastlord	bot_bst.mac	Pet, melee, spells, attack buffs
Cleric	bot_clr.mac	Healing, curing, buffs, rez, battle-cleric mode
Druid	bot_dru.mac	Healing, curing, buffs, nukes, DoTs
Enchanter	bot_enc.mac	Debuffs, buffs, charm, runes, pet
Magician	bot_mag.mac	Pet, buffs, nukes, AE nukes
Necromancer	bot_nec.mac	Pet, nukes, DoTs, feign death
Paladin	bot_pal.mac	Tanking, healing, stuns, offtanking
Ranger	bot_rng.mac	Melee, spells, self/group healing
Shadowknight	bot_shd.mac	Tanking, lifetaps, DoTs, feign death
Shaman	bot_shm.mac	Healing, curing, buffs, slows, DoTs
Warrior	bot_war.mac	Tanking, disciplines, offtanking
Wizard	bot_wiz.mac	Nukes, quick nukes, AE nukes, aggro reduction
Berserker, Monk, Rogue	bot_melee.mac	Shared endurance-melee routine

xiris_bot.mac is only the loader. It selects bot_<CLASS>.mac, with BER/MNK/ROG routed to bot_melee.mac.

Documentation

• Installation and prerequisites
• Character configuration
• Command reference
• Recommended hotkeys
• Architecture and extension points
• Troubleshooting

Repository layout

Path	Purpose
xiris_bot.mac	Loader and class router
bot_*.mac	Class main loops and class-specific behavior
xiris_common/*.inc	Shared behavior libraries
xiris_common/xiris_events_raid_*.inc	Zone and encounter reactions
xiris_class_ini/	Per-character behavior configuration
xiris_common/*.ini	Shared definitions, loot rules, exclusions, and encounter data
xiris_trade_ini/	Trade-skill configuration

Safety notes

• Test new INI entries on one character before deploying them raid-wide.
• Keep a BackOff and NavStop hotkey available at all times.
• Verify the target before broadcasting KillMob, DebuffTarget, charm, or movement commands.
• Encounter includes can move characters or react to emotes automatically. Review the relevant raid include before a first attempt.
• Character INIs in this repository contain crew-specific names and spell lineups. Treat them as examples, not portable defaults.

Contributing

Keep command names synchronized with their #EVENT definitions, document new INI keys, and include a short test description with behavior changes. Avoid committing account credentials, server login information, or private character data.