Homunculus: Difference between revisions

updated the AI Troubleshooting section w.r.t. the 2023-07-23 Kisaro AI update
(AI Troubleshooting section rewrite)
(updated the AI Troubleshooting section w.r.t. the 2023-07-23 Kisaro AI update)
Line 268: Line 268:
=== General ===
=== General ===


The following are the general steps to verify that you have enabled the custom MuhRO homunculus AI:
The game client contains two implementations of the AI: the so-called basic (default) AI and the custom (user) AI. The basic one is active by default. That one is generally a stub, which does nothing. To enable the actual AI, you have to switch your game client to load the custom AI. This needs to be done only once at a given game client.
 
The following are the general steps to verify that you have enabled the custom homunculus AI:


# Run MuhRO as usual.
# Run MuhRO as usual.
# Check that the '''Public''' chat messages are enabled in your chat settings. If not, enable them.
# Check that the '''Public''' chat messages are enabled in your chat settings. If not, enable them.
# Use the <code>/hoai</code> command ingame and check the message it sends to the chat:
# Use the <code>/hoai</code> command ingame and check the message it sends to the chat:
#* "Homunculus has been customized.": your game client is set up to load the custom MuhRO AI, move on.
#* OK: "Homunculus has been customized." If you see this, your game client is now set up to load the custom AI, move on.
#* "Homunculus has been activated with the basic AI.": your game client is currently using the default AI, which is not the one you need. Use the <code>/hoai</code> command again to switch to the custom MuhRO AI.
#* Not OK: "Homunculus has been activated with the basic AI." If you see this, your game client is now using the basic AI. Use the <code>/hoai</code> command again to switch to the custom AI.
# Only after you have verified that your client is set up to load the custom MuhRO AI: use the <code>@refresh</code> command ingame to reload the AI settings. (<code>@refresh</code> is not an AI command but it reloads the AI files as a side effect).
# Only after you have verified that your client is set up to load the custom AI: use the <code>@refresh</code> command ingame to reload the AI settings. (<code>@refresh</code> is not an AI command but it reloads the AI files as a side effect).
# The custom MuhRO AI is set to autoattack by default. If you find out that your homunculus does not autoattack, make sure it is not in standby mode:
# The custom AI bundled with the MuhRO client is set to autoattack by default. If you find out that your homunculus does not autoattack, make sure it is not in standby mode:
#* Heal your homunculus to full HP.
#* Heal your homunculus to full HP.
#* Get to any low-level dungeon and get near some mobs. Normally the homunculus should start attacking them automatically.
#* Use Warper - Dungeons - Anthell. Normally the homunculus should automatically start attacking the ant eggs near the entrance.
#* If the homunculus does not attack, use the '''Alt+T''' hotkey to switch between active and standby modes. Do not expect it to switch immediately, allow a few seconds until the homunculus becomes aware of the mode change.
#* If the homunculus does not attack, use the '''Alt+T''' hotkey to switch between active and standby modes. Do not expect it to switch immediately, allow a few seconds until the homunculus becomes aware of the mode change.
When in doubt, you can restart your game client to troubleshoot the AI. Although the restart is not required to reload the AI, it does not hurt. The <code>/hoai</code> setting is persistent and survives the restart; the standby mode is reset upon restart; homunculus behavior settings are read from the AI files and are not affected by the game client restarts.


=== Vanilmirth skill Caprice ===
=== Vanilmirth skill Caprice ===
Line 285: Line 289:
If you have an issue that your '''Vanilmirth autoattacks but never uses Caprice''':
If you have an issue that your '''Vanilmirth autoattacks but never uses Caprice''':


# Verify that you have the custom MuhRO AI enabled in general, as described in the general instruction at the beginning of this section.
# Verify that you have the custom AI enabled, as described in the general instruction at the beginning of this troubleshooting section.
# Open your MuhRO installation folder and find the homunculus configuration file '''AI\USER_AI\H_Config.lua'''.
# Open your MuhRO installation folder and find the homunculus configuration file '''AI\USER_AI\H_Config.lua'''.
# Open '''H_Config.lua''' with any '''plain text editor''' (do not use text processors like Word; Notepad is OK).
# Open '''H_Config.lua''' with any '''plain text editor''' (do not use text processors like Word; Notepad is OK).
Line 291: Line 295:
# Change <code>false</code> to <code>true</code> so the line reads: <code>UseVaniCaprice          = true</code>.
# Change <code>false</code> to <code>true</code> so the line reads: <code>UseVaniCaprice          = true</code>.
# Save the '''H_Config.lua''' file and close it.
# Save the '''H_Config.lua''' file and close it.
# Switch to the MuhRO window and make sure you have the custom MuhRO AI enabled: use <code>/hoai</code> to check, then <code>@refresh</code> to reload settings. There is no need to restart the game client.
# Switch to the MuhRO window and make sure you have the custom AI enabled (see the general instructions above): use <code>/hoai</code> to check, then <code>@refresh</code> to reload settings. There is no need to restart the game client, though you can also use a restart instead of reloading AI with the commands.
 
=== Dieter skill Tempering ===
 
If you have an issue that your '''Dieter does not buff you with Tempering''', you will need to download and install another version of the custom AI; the one bundled with the MuhRO client does not support the newer Homunculus S skills.
 
# Close all the game clients.
# Download the [https://codeload.github.com/Kisaro/AzzyAI/zip/refs/heads/master Kisaro AI]. You will get the '''AzzyAI-master.zip''' archive. Unzip it to a temporary location to get the '''AzzyAI-master''' folder with the AI files inside.
# Open your MuhRO installation folder. Back up your current AI as described at the beginning of this troubleshooting section.
# In your MuhRO installation folder, open the '''AI''' folder and delete all its contents.
# Copy the ''contents'' of the previously unpacked '''AzzyAI-master''' folder to the now empty '''AI'' folder that is inside your MuhRO installation.
# Check the results. The AI-related folder structure should be:
#* <your MuhRO installation>
#** AI (this is the folder where you've got to replace the files)
#*** Default
#*** USER_AI
#*** .gitignore
#*** Changelog.md
#*** README.md
#** AI_sakray (this folder should be left intact)
#*** Default
#*** USER_AI
#*** ...other files
# Start your MuhRO client and verify that you have the custom AI enabled, as described in the general instruction at the beginning of this troubleshooting section.
 
'''Note:''' the homunculus behavior settings in the '''Kisaro AI''' are different from the behavior settings in the custom AI that comes bundled with the MuhRO client. You may need to set up the AI again after you install the Kisaro AI, if its default settings do not suit you.


=== AI Reset ===
=== AI Reset ===


If you had changed the AI settings from defaults and have issues after that, try resetting the AI first. The custom MuhRO homunculus AI is currently (as of July 2023) the most up to date AI version available - do not try replacing it with other AI versions to avoid creating new issues caused by incompatibilities between an outdated AI and current homunculi.
If you had changed the AI settings from their defaults and have issues after that, try resetting the AI first. The custom AI bundled with the MuhRO client has settings that suit most players, and several in-game issues are actually caused by altering those settings.


To reset the AI, do one of the following:
To reset the AI, do one of the following:
Line 306: Line 335:
=== Get Help ===
=== Get Help ===


If you cannot resolve the issue on your own, follow to the class Discord channel for help: [https://discord.com/channels/822793286786875403/1127134731063005255 #merchant]. Please be ready to upload your configuration files and answer questions regarding your AI settings.
If you encounter an issue that you cannot resolve on your own, do not hesitate to ask for help in the class Discord channel: [https://discord.com/channels/822793286786875403/1127134731063005255 #merchant]. Please be ready to upload your AI configuration files and answer questions regarding your AI settings.


=== Other AI Versions ===
=== Other AI Versions ===
Line 315: Line 344:


* The original AzzyAI at https://github.com/SpenceKonde/AzzyAI
* The original AzzyAI at https://github.com/SpenceKonde/AzzyAI
* The Kisaro fork at https://github.com/Kisaro/AzzyAI
* The ImmaculAI at https://github.com/cidimmacula/ImmaculAI
* The ImmaculAI at https://github.com/cidimmacula/ImmaculAI


With regards to their original authors, the custom MuhRO AI is actually an updated version of the work done in the KisaRO fork and ImmaculAI.
With regards to their original authors, the currently supported AI versions are ahead of the abovementioned ones: those are the base works, while the custom AI bundled with the MuhRO client, and the Kisaro AI, are the continuations of those previous works.
18

edits