COMPANION TOOLS

Homunculus & Mercenary AI builder

Choose how your companion fights, follows and supports you. Configure learned skills and monster tactics, then download your complete RagnarokSearch AI.

Your companion

Companion

Using the Renewal skill database. Each database keeps its own saved profiles.

Start with a preset

Fine-tune the settings below. Individual monster rules take priority over the default tactic.

Combat

HP needed to start a fight (%)SP needed to start a fight (%)Return to owner below HP (%)Use configured attack skillsUse skills instead of normal attacksKeep this much SP in reserveOnly fight on a direct commandSwitch to higher priority targetsArea attack skillsMinimum enemies for area skillsMinimum delay between skills (ms)

Movement

Follow distance (cells)Search radius while owner standsSearch radius while owner movesStay within owner range while standingStay within owner range while movingOnly attack enemies already in rangeDefend while holding positionEnable kiting from monster tacticsKiting step (cells)Start kiting within (cells)

Support

Use configured support skillsHeal companion below HP (%)Heal owner below HP (%)

Learned skills

Set each skill to its learned level. Level 0 turns it off. Set HP thresholds in Support; a recast interval of 0 uses the skill's database timing. Higher priority skills are tried first.

Monster tactics

Default tactic

Choose how to handle each monster. Unlisted monsters use the default tactic.

Add a monster rule

No individual rules yet.

Your AI files

One Lua file with the complete engine, your settings and monster tactics for the selected companion.

Homunculus: AI.lua

Import saved configurationImport your downloaded Lua file to edit its settings again. Previous JSON profiles are also supported.

Preview Lua files

Install your AI

Back up your existing AI.lua or AI_M.lua in the game's AI/USER_AI folder.
Save the downloaded file there: AI.lua for Homunculus, AI_M.lua for Mercenary.
Use /hoai for Homunculus or /merai for Mercenary to enable custom AI.
Vaporize and call your Homunculus again, or summon your Mercenary.

Each file runs independently and includes everything needed for its companion. Your companion uses the skill levels selected above; skill items, evolution and combo requirements still apply.