Modhold
Wrath of the Righteous
Freev0.3.52

AI Control - Fully Autonomous Combat Companions

Let your companions fight for you. They attack, cast, heal, use quick-slot items, and move in turn-based or real-time combat. You choose who the AI controls, and you can still give orders yourself.

MonsieurAndroid3 @MonsieurAndroid
0Unique downloads
0Downloads
5Views
0Vouches
–no scores yetScore
AI Control
Fully Autonomous Combat Companions

Stop clicking every action in every fight.
Let your companions fight, and keep the choices that matter.
Your companions look at the battle and choose a sensible action. They can attack, cast, heal, use an item, or move. This works in turn-based combat and in real time with pause.
You can still give orders yourself. You also choose which characters the AI controls.

What the AI does in a fight
  • Attacks. It can make a single attack, a full attack, a charge, or move and then attack. It uses the game's own rules for hit chance, damage, and damage reduction.
  • Spells and abilities. It looks at what the spell really does, and whether that enemy can save against it, resist it, or ignore it.
  • Buffs. It notices buffs that are already active, and it avoids replacing a useful buff with a weaker one.
  • The party. Healing a friend, helping a fallen ally, and removing a harmful effect are all real options.
  • Where they stand. Tanks stay in front. Fragile characters step back. Before anyone moves, the AI thinks about attacks of opportunity (free hits when you leave melee). It also tries to walk around Grease, webs, and clouds.
  • Cone spells. When it can, it aims a cone so it does not hit allies next to the caster.
  • Items. It uses potions, scrolls, wands, and bombs in quick slots when they are worth using.
  • A sleeping enemy. A melee character may leave that enemy asleep for a coup de grace (a finishing strike), instead of waking them with a normal hit.
Tip: put the potions, scrolls, and wands you want companions to use into their quick slots. In combat, the game only lets a character use items from quick slots.
Some class features it understands

These are examples. They are not a full list, and they are not a promise that every class or archetype works perfectly.
  • Rage, Smite, and bard performances
  • Power Attack and similar combat modes
  • Kineticist burn, infusions, and blasts
  • Psionic focus, if you use the Psionics mod
  • Magus Spell Combat and Spellstrike, including ranged versions the mod recognises
  • Some Shifter forms, and Magic Deceiver spell fusions from the base game

You stay in control

Open the settings with Ctrl+F10. The defaults are fine for most players.
  • The AI controls your companions. It does not control your main character unless you turn that on.
  • You can turn the AI off for one character and play that character yourself.
  • Give each character a role: DPS (damage first), Tank (hold the front and protect allies), or Support (heal, buff, and control the fight).
  • Choose where they prefer to fight: Mixed, Melee, or Ranged.
  • Pure Mage is optional and off by default. That character prefers spells and cantrips instead of weapon attacks. It only works while Range is set to Ranged.
  • Choose how they spend attack spells. Conservative uses the lowest spell level that can still do the job. Stronger spells on bosses stay allowed unless you turn that off. Standard is a normal balance. Aggressive is more willing to spend higher spell slots. Cantrips, healing, buffs, and items keep their own rules.
  • Block anything the AI must never use: a spell, one version of a spell, a quick-slot item, or a toggle. Block it for one character, or for everyone. You can still use it yourself. Unblocking works at once.
Spoiler
  • The AI can switch toggles on and off, such as Rage, a bard song, Power Attack, or Fighting Defensively. If you click a toggle yourself, the AI leaves it like that for the rest of the fight.
  • After a fight, it can cast long buffs again if they have worn off. Turn this off if you buff by hand, or if another mod already does it.
  • Pre-Buff Party is a button. Casters controlled by the AI put useful low-level buffs on the party before a fight.
  • A healing potion is used when health drops below 50%. You can change that number. Potions, scrolls and wands, and bombs or thrown items each have their own on/off switch.
  • Animal companions can use items in their belt slots.
  • When you order someone to walk, the path can go around traps the party has already spotted.
  • Control Summoned Creatures is off by default and still being tested. It does not control animal companions, swarms, or a summon created by another summon. Summons never use the party's items.

Please keep this in mind
  • The AI follows the game's rules. It will not do something the game itself does not allow.
  • It does not fully support every class, every archetype, or every ability added by another mod.
  • Grapple is still being improved. Control of summons is still being tested.
  • This mod does not take over cutscenes. It also leaves confused, dominated, or panicked companions to the game.

What you need

You need Unity Mod Manager 0.27.0 or newer. No other mod is required.
  • Wrath Tactics works with this mod. In real time, Wrath Tactics goes first. This mod acts when Wrath Tactics does not give an order. A "Do nothing" rule gives no order, so this mod still acts. You can change this in the settings.
  • These mods have been checked in play: Tabletop Tweaks (Core and Base), Isekai, Psionics, Mystical Mayhem, Dark Codex, Demonology, and Tome of the Firebird. Many of their rule changes are picked up automatically. Abilities those mods create from scratch may still not work. This is not a promise for every version and every setting.
  • If Buff It 2 The Limit already handles your buffs or toggles, turn off the matching option here. The two mods should not press the same buttons.
  • Mods that replace companion combat AI will conflict with this one.

How to install

  1. Install Unity Mod Manager and point it at your Wrath of the Righteous folder.
  2. Download this mod.
  3. Close the game completely. In Unity Mod Manager, open the Mods tab and drag the zip onto the window. You can also extract it to Mods\CompanionAI_Pathfinder\.
  4. Start the game and press Ctrl+F10. The AI Control settings should be there.

You update the mod in the same way. Your settings are usually kept.
Something went wrong?

A comment or a bug report is welcome. Please say what happened, which character and ability were involved, and whether the fight was turn-based or real time.

If you can, add Log.txt from that same play session. Open the Logs tab in Unity Mod Manager, or go to:

<game>\Wrath_Data\Managed\UnityModManager\Log.txt

Leave debug logging off unless you are asked to turn it on.
Enjoy the fight, and let the party do some of the clicking.

Requirements

Credits

MonsieurAndroid designs this mod, tests it, and decides how it should behave. The code was written with AI coding tools.

The idea began with 'CompanionAI' for Pathfinder by veria (seyelive5) which is MIT Licenced. Veria halted development before the project was functional but his work served as motivation and provided the conceptual foundation which got me started.

Permissions

You are not allowed to upload this file to other sites under any circumstances. You must get permission from me before you are allowed to modify my files to improve it.

Before you download

This mod needs other mods

AI Control - Fully Autonomous Combat Companions needs this to work. Download and install it too.

Required 1