Homunculus: Difference between revisions

AI Troubleshooting section rewrite
(Added Kisaro Fork)
(AI Troubleshooting section rewrite)
Line 254: Line 254:
[[File:AzzyAI.png|none]]
[[File:AzzyAI.png|none]]


==AI Troubleshooting==




<big>Note: Because the original creator of AzzyAI is no longer providing updates to the program, and with the rework of the Homunculus AI,  it has been left to the remaining of the community to keep AzzyAI up to date.</big>


#<big>If your client is updated follow the steps below.</big>
== AI Troubleshooting ==
#<big>Close the game;</big>
 
#<big>Go to your MuhRO installation folder;</big>
'''Before you attempt any troubleshooting, back up your current AI first:'''
#<big>Delete the folder "AI";</big>
 
#<big>Download [https://github.com/SpenceKonde/AzzyAI/archive/refs/heads/master.zip '''this file'''], and extract it to your MuhRO AI folder;</big>
# Open your MuhRO installation folder and find these folders there:
#<big>Download the [https://github.com/Kisaro/AzzyAI '''Kisaro Fork''']  on Github (If you cannot find the Download button, Click CODE, and click Download Zip), and then extract this over the previous files in your MuhRO AI Folder.</big>
#* '''AI'''
#'''<big>Install all the VC++ Redistributables:</big>'''
#* '''AI_sakray'''
#* <big>https://www.microsoft.com/en-ca/download/details.aspx?id=29</big>
# Copy both those folders to another location outside the MuhRO installation folder, so you can restore them later if needed.
#* <big>https://www.microsoft.com/en-ca/download/details.aspx?id=5555</big>
 
#* <big>https://www.microsoft.com/en-ca/download/details.aspx?id=40784</big>
=== General ===
#* <big>https://www.microsoft.com/en-ca/download/details.aspx?id=48145</big>
 
#* <big>https://aka.ms/vs/15/release/vc_redist.x86.exe</big>
The following are the general steps to verify that you have enabled the custom MuhRO homunculus AI:
#<big>Set the AI to "Customized". You change it by typing '''/hoai''', followed by '''@refresh''';</big>
 
#<big>Make sure your Homunculus is not in passive mode. You can change the mode with the shortcut ''Alt+T''.</big>
# Run MuhRO as usual.
# 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:
#* "Homunculus has been customized.": your game client is set up to load the custom MuhRO 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.
# 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).
# 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:
#* 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.
#* 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.
 
=== Vanilmirth skill 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.
# 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).
# Scroll down to this line at the very bottom: <code>UseVaniCaprice          = false</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.
# 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.
 
=== 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.
 
To reset the AI, do one of the following:
 
* If you have the '''AI''' and '''AI_sakray''' folders backed up, delete those folders from the MuhRO AI installation folder and restore them from the backup copy.
* If you have no such backup or you are not sure that your backup copy contains the default AI settings:
*# In your MuhRO installation folder, open the '''AI''' folder and delete all its contents.
*# Open the nearby '''AI_sakray''' folder and copy all its contents to the '''AI''' folder.
 
=== 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.
 
=== Other AI Versions ===
 
The following other AzzyAI versions are known to be outdated as of July 2023 and are strongly not recommended to use.
 
'''Do not download and use these unless you are a developer:'''
 
* 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
 
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.
18

edits