A combat bot and set of in-game tools for the Project Triune EverQuest server, running on MacroQuest.
On Project Triune every character is three classes at once. Triune AutoCombat also supports servers with up to four classes per character: it casts your spells, fires your AAs and discs, pulls mobs, controls your pets, keeps your boxes together, and sits to med when it is safe. Everything is set up from one in-game window - no macros to write.
- Download the latest RoF2 MacroQuest from macroquest/macroquest/releases and extract it somewhere like
C:\MacroQuest. - Download Triune from Triune AutoCombat releases:
TriuneAutocombat-full.zip- first install. Has everything, including the MQ2Nav zone navmeshes.TriuneAutocombat-Update.zip- updating. Everything except the navmeshes (they rarely change).
- Extract the zip into the root of your MacroQuest folder. It merges
lua/,config/andresources/into place. Overwrite if asked - your own settings and loadouts are never touched. - Start
MacroQuest.exe, then log into Project Triune.
Triune opens by itself when you log in. If you close it, type /ac or /lua run triune.
Windows users: add your MacroQuest folder as an antivirus exception before running it.
- Check your classes. The main window shows the classes it detected from your Inventory Window. Click Re-detect if they are wrong, or adjust the four class selectors manually. Leave unused selectors at -- None -- on servers with fewer classes. Your class selection is saved with your loadout.
- Set up what to cast. Go through the tabs: Spell Gems (spells), Abilities (kick, bash, backstab...), AAs, Disciplines and Clickies. Each entry gets a simple rule for when to fire it, such as Target HP < 90%, My HP < 40%, Missing Buff or Always. Import Bar fills the spell list from whatever you have memorized.
- In Spell Gems, mark emergency heals, lifetaps, or other spells High Priority to check them after Abilities and Disciplines but before Clickies. Other spells remain after Clickies; the overall action-category order stays fixed.
- Pick a mode on the Control tab and click Start (or type
/ac run).
Your setup is saved automatically and reloads next time.
| Mode | Use it when | What Triune does |
|---|---|---|
| Manual | You want to drive | You move and pick targets. Triune attacks, casts, heals and uses your abilities. |
| Puller - Camp | You are the puller | Runs out, tags a mob, brings it back to camp and fights it there. |
| Puller - Hunt | Solo roaming | Wanders the zone and kills mobs where they stand. |
| Assist - Chase | Boxed melee | Follows the Main Assist and attacks their target. |
| Assist - Camp | Boxed, stay put | Holds at camp and only fights what comes in. |
| Assist - Backline | Boxed healers and casters | Stays at range and never runs into melee. |
Set the Main Assist with /ac ma <name> or from the Control tab.
Combat style (Settings tab, or /ac style melee|ranged|spell) decides how you fight: close to melee, shoot a bow from a distance, or stand back and only cast.
Pulling options live on the Control tab: pull with melee, a spell, your pet or a bow; an Include list (only pull these) and an Ignore list (never pull these); faction filters so you never pull a guard; and waypoint routes for patrolling a path (/ac wp add while walking).
Burn mode (/ac burn) fires anything you marked Burn Only - flip it on for named mobs.
Everything below is built in. Open them from the buttons on the main window's header or with the command shown.
| Window | Command | What it is |
|---|---|---|
| Status | main window tab | Live view of what the bot is doing, your target, pets and XTarget threats. |
| Pets | main window tab | Control a pet for each of up to four classes: attack, back off, hold, taunt, and the server's #petcmd commands. |
| Target & Player HUD | /ac hud |
Compact unit frames for you, your target and your pets. |
| Group | /ac group |
Replacement group window with vitals, roles and click-to-target. |
| XTarget | /ac xtar |
Replacement extended target window with HP, aggro and distance. |
| Effects & Songs | /ac eff |
Your buffs and songs with time left. |
| Spell Gem Bar | /ac gems |
Replacement spell bar with recast timers and spell sets. |
| Cooldowns | /ac cd |
Every ability, AA and disc timer in one place. |
| Spellbook | /ac spellbook |
Browse and search the spells of all your classes; mem to a gem from here. |
| Map | /ac map |
2D zone map, Norrath atlas and an NPC tracker (/ac track). Camp, waypoints and hazards are drawn on it. |
| Chat Windows | /tacchat |
Chat window replacement: tabs, filters, colours, highlights, a Tells window, item links, NPC dialogue links (click to answer), logging. |
| Game Database | /ac db |
Offline copy of the server's item, NPC and spell database. /ac item, /ac npc, /ac spell search it. |
| Inventory & Bank | /ac inv |
Search, sort and move items; see every box's bags; hand items between boxes. |
| Hot Buttons | /ac btn |
Button Master-style hotbars with cooldown overlays and share strings. |
| Box Network | /ac net |
See and steer your other boxes on this PC. /ac net all burn on runs a command on all of them. |
| NMS Loot | /ac nms |
The server's #nms loot system as a window, shared across your boxes. |
| DPS Parser | /dps |
Per-fight damage for you and your pets, plus a group meter over the Box Network. |
| Auto-Accept | /ac autoaccept |
Auto-accepts group, trade and DZ invites by your rules. |
| Auto AA | /ac aawin |
Spends AA points on the checked priorities only; the fireworks cap spender runs once every priority is maxed (or none is checked). /ac aastatus shows why each priority is or is not next. |
| Buffbot | /ac buffbot on |
A buff station: players /tell you for buffs, it casts them. Off unless you turn it on. |
| Cursor Manager | /ac cursorui |
Clears whatever is stuck on your cursor. |
| Parcels | /ac parcels |
Tells you when parcels arrive and collects them all at a parcel merchant. |
| GM Commands | /ac gm |
Reference and runner for the server's # GM commands: search every command, fill in its arguments, run it, keep favourites; /ac gm zone poknowledge runs one from a hot button. Off unless you turn it on, and only useful with GM status. |
| Floating damage | Settings -> Plugins | Big animated numbers for crits. |
| Update Checker | /ac update |
Tells you when a newer Triune release is out. Nothing is downloaded. |
| Compact Mini HUD | /ac compact |
The whole bot shrunk to a small strip. |
Each of these is a plugin in lua/tac/. Turn them on or off under Settings -> Plugins.
Group cures and buffs over Box Network: update both lua/triune.lua and lua/tac/boxnet.lua
on the support character and each boxed recipient, enable Box Network, and
restart TAC on each character. Keep the MacroQuest launcher running; this uses
its existing Actors connection, not EQBC or DanNet. Updating only triune.lua
does not update what the tank broadcasts.
With both characters in game on the same server and zone and permitted by the
existing Box Network allowlist, fresh reports of their own poison, disease,
curse and corruption let Me, then Group / Group, then Me choose a cure
recipient without targeting them to inspect buffs. The support still explicitly
targets that recipient for the cure and restores its previous target afterward.
The Box Net counter column shows ? for incomplete/unknown data; C1 can mean a
curse is present even if the client has no numeric counter total. Missing,
stale or older zero-only reports use the existing nonblocking inspection
fallback, rather than declaring that character clean. Older positive reports
remain usable. Item readiness, burn-only settings, thresholds and heal priority
still apply. /ac net debug reports the local plugin version and counters,
and each peer's counter schema, heartbeat age and usability; use it on support
and recipient to distinguish a missing update from stale or unavailable data.
Box Network 1.2.0 also broadcasts complete own long-buff and song observations,
including ranked names and remaining duration. Ordered missing buff rules use
fresh usable reports without targeting groupmates just to inspect them; actual
casts still select and hold their recipient, then restore the previous target.
Existing spell-name/rank matching and buff-refresh thresholds apply. A complete
empty list means no buffs, but older plugins, failed/partial reads and stale
reports keep the existing inspection fallback. Update both files on every
participating character, keep Box Network enabled, and restart TAC; updating
only the support's core cannot add the tank's buff reports. /ac net debug also
shows local buff-report completeness/count and peer report age/usability.
Type /ac help in game for the full list.
| Command | What it does |
|---|---|
/ac |
Start or pause |
/ac run / /ac pause |
Start / pause |
/ac manual, /ac puller camp, /ac puller hunt, /ac assist chase, /ac assist camp, /ac backline |
Switch mode |
/ac ma <name> |
Set the Main Assist |
/ac burn |
Toggle Burn mode |
/ac memall |
Memorize any missing spells |
/ac importbar |
Build the spell list from your memorized gems |
/ac style melee|ranged|spell |
Set combat style |
/ac wp add / /ac wp clear |
Add a waypoint here / clear the route |
/ac pet attack|back|hold on |
Pet commands (any #petcmd verb) |
/ac net <all|zone|group|Name> <command> |
Run a command on the boxes: an /ac command (/ac net all burn on) or any slash command as typed (/ac net group /ac manual, /ac net all /camp) |
/ac scale 1.25 |
Make every Triune window bigger (or smaller) |
/ac status |
Print what the bot is doing |
/ac restart |
Reload the whole script |
/triunerun |
Start/pause - bind this to a key |
- Not moving or pulling? Look at the Status tab. It shows whether MQ2Nav and MQ2MoveUtils are loaded and whether the zone has a navmesh, with buttons to load or reload them.
- Stuck on terrain? Triune remembers where it got stuck and routes around it next time. Clear those spots under Settings -> Navigation.
- Need to report a bug? Turn on Log To File (
/ac log on) and, when it happens, run/ac dump. Attach the files from theLogs/TAC/folder inside your MacroQuest folder (triune_<server>_<char>.logandtriune_dump_...log)./ac debugprints extra detail to chat. - Game feels slow with Lua scripts? Triune sets MQ2Lua's
turboNumto 10000 on first start (the default of 500 makes every Lua script crawl). If you set it higher yourself, Triune leaves it alone. - A plugin broke? It is isolated - it shows an error under Settings -> Plugins and the rest keeps running. Fix or disable it there.
All paths are inside your MacroQuest folder.
| File | What it holds |
|---|---|
config/triune_loadout_<server>_<char>.lua |
Each character's settings and loadouts. Never overwritten by updates. |
config/triune_chat_<Name>.lua |
Chat Windows layout and colours, per character. |
Logs/TAC/triune_*.log |
Diagnostic logs (when Log To File is on), /ac dump files and the Chat Windows logs. TAC creates the folder if it is missing. Log files from older versions stay in Logs/. |
lua/triune.lua |
The bot itself. |
lua/tac/*.lua |
The plugins listed above. Drop your own .lua plugin here and it loads. |
resources/gamedb/ |
The offline game database (in both release zips). |
resources/MQ2Nav/ |
Zone navmeshes (full release only). |
A plugin is one Lua file in lua/tac/ that returns a table with an id, a name, and any of the hooks onInit(core), onTick(), onDrawUI(), onDrawSettings(), onCommand(cmd, args), onSaveSettings() and onLoadSettings(t). core gives you mq, ImGui, the live ctrl config, core.log for logging and core.delay(ms) instead of mq.delay. Add plugin.window = { label = 'Mine', flag = 'show_mine' } and it gets a header button and a place in the window manager. The shipped plugins are the best examples - cursor.lua is the smallest.
- Triune AutoCombat releases
- MacroQuest releases (RoF2)
- Project Triune
- Release notes - short summary per release
- Change log - every change in detail
Current version: 3.5
See CHANGELOG.md for what changed in each release.