⚔️ Triune AutoCombat — User Manual

Version 3.0

On Project Triune every character is three classes at once. Triune AutoCombat runs all three for you — casting, pulling, healing, pets and boxes — from one in-game window. No macros to write.

Requires MacroQuest (RoF2). Setup takes about ten minutes.

📥 Install

1. Install MacroQuest for RoF2. Download the latest RoF2 build from MacroQuest releases and extract it somewhere simple, such as C:\MacroQuest.
2. Download Triune AutoCombat from the releases page:
3. TriuneAutocombat-full.zip — first install. Includes the MQ2Nav zone navmeshes.
4. TriuneAutocombat-Update.zip — updating. Everything except the navmeshes, which rarely change.
5. Extract into the root of your MacroQuest folder. It merges lua/, config/ and resources/ into place. Overwrite when asked — your own settings and loadouts are never touched.
6. Launch. Start MacroQuest.exe, then log in. Triune opens by itself. If you close it, type /ac or /lua run triune.

⚠️ Before you run it: add your MacroQuest folder as an antivirus exception. Windows Defender and most AV products will quarantine MacroQuest otherwise, which looks exactly like a failed install.

🚀 First run

Three things to do the first time you log in on a character. Everything saves automatically and comes back next session.

1. Check your three classes. The main window shows the classes it detected. If they are wrong, click Re-detect.
2. Tell it what to cast. Work through the Spell Gems, Abilities, AAs, Disciplines and Clickies tabs. Each entry gets a rule for when to fire — Target HP < 90%, My HP < 40%, Missing Buff, Always — and a target (see Targeting rules). Import Bar fills the spell list from whatever you currently have memorised. It is the fastest way to start.
3. Pick a mode and start. Choose a mode on the Control tab and click Start, or type /ac run.

💡 Bind a key. /triunerun starts and pauses the bot. Put it on a hotkey during your first session — it is the control you will reach for most.

⚔️ Combat modes

There are three primary modes. Puller and Assist each have submodes. That is six combinations in total.

Set the Main Assist with /ac ma <name> or from the Control tab. Every Assist mode depends on it.

Upgrading from an older version

Earlier releases had eleven separate modes. They were consolidated into the three-plus-submodes layout above, and your saved loadout is migrated automatically on load. If you are following an older guide, this is how the names map:

You do not need to do anything — the migration runs by itself.

🗡️ Combat style & pulling

Style

Style decides how you fight, independently of mode. Set it in Settings or with /ac style melee|ranged|spell.

Pulling

Pulling options live on the Control tab.

• Pull style — Melee, Spell, Pet or Ranged.
• Include list — only pull mobs on this list.
• Ignore list — never pull these.
• Faction filter — choose the lowest con you are willing to pull, from Scowling, Threateningly, Dubious, Apprehensive, Indifferent, Amiably, Kindly, Warmly, Ally. Set this so you never pull a guard.
• Waypoint routes — walk a path and add points with /ac wp add to patrol it. /ac wp clear resets the route.

Burn mode

/ac burn toggles Burn mode, which fires everything you marked Burn Only. Turn it on for named mobs and off again afterwards, so you are not spending long recasts on trash.

🎯 Targeting rules

Every spell, ability, AA and disc gets a target rule. Enemy rules begin E: and friendly rules begin F:. Getting these right matters more than anything else in your setup.

Enemy targets

Friendly targets

💡 Disciplines fire in priority order. Combat discs share timer groups, so Triune evaluates them by the priority you assign. If a disc never seems to fire, check that nothing above it is holding its timer group.

🪟 Windows & tools

All of this ships with Triune. Open them from the buttons in the main window's header, or with the command shown. Each is a plugin — turn any of them off under Settings → Plugins.

⌨️ Commands

/ac help in game prints the full list. These are the ones you will actually use.

🧰 Boxing

Triune finds your other boxes on the same PC and links them together.

• Open the Box Network with /ac net to see and steer every box.
• Run a command everywhere with /ac net all <command> — for example /ac net all burn on before a named mob.
• Give one character the Main Assist role with /ac ma <name>, then put the others into an Assist mode. Melee take Assist — Chase; healers and casters take Assist — Backline so they never run into melee.
• The DPS parser aggregates a group meter across the network, and the loot and inventory windows are shared, so you can move items between boxes without trading.

🔧 Troubleshooting

Not moving or pulling? Check 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.

Getting stuck on terrain? Triune remembers where it got stuck and routes around it next time. Clear those spots under Settings → Navigation.

The game feels slow with Lua scripts? Triune raises MQ2Lua's turboNum to 10000 on first start, because the default of 500 makes every Lua script crawl. If you have already set it higher yourself, Triune leaves it alone.

A plugin broke? Plugins are isolated. A broken one shows an error under Settings → Plugins and everything else keeps running. Fix or disable it there.

Reporting a bug Turn on /ac log on, reproduce the problem, then run /ac dump. Attach both files from your MacroQuest Logs/ folder: triune_<server>_<char>.log and triune_dump_….log. /ac debug prints extra detail to chat if you want to watch it live.

📁 Your files

All paths are inside your MacroQuest folder.

✅ Updating is safe. Your loadouts live in config/ and are never touched by an update. Extract a new release straight over the top.

🧩 Writing your own plugin

A plugin is a single 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 reference — cursor.lua is the smallest.

🔗 Links

• Triune AutoCombat releases
• MacroQuest releases (RoF2)
• Release notes — short summary per release
• Change log — every change in detail
• Project Triune