HF Patch for AI v3.1 (mods up to 2026/09/11)
An unofficial patch for AI-Shoujo/AI-Syoujyo that installs the latest fan-made English translations and essential mods. It also fixes many common issues with the game. It will allow you to load all character cards and scenes and give you countless content creation and gameplay improvements.
Read the full HF Patch manual to learn more about what it is, what it does, how to use it, and how to solve common issues.
HF Patch does not contain the full game, paid expansions or any other pirated content. You have to buy the game separately on Steam (international version). The Japanese version is no longer being sold. Once patched, the international version is mostly equal to the Japanese version with the patch installed (some DLC is not supported, but there are built-in English and Chinese translations).
The base game (AI-Shoujo / AI-Syoujyo), and by extension this patch are not suitable for minors. If you are under 18 years old you can not use this patch. The base game and this patch contain only characters of age 18 or higher. The creator of this patch is not responsible for creations of its users and prohibits any unlawful use of this software.
Downloads
This download contains the entire HF Patch and can be used offline. You can use qBittorrent or a similar torrent client to open the magnet link. Old patch versions are available in direct download links.
Full patch (Everything is included, most people should use this)
magnet:?xt=urn:btih:503FD080ED42EB46AC87B0D0CB9744D79E0151C0
Light patch (Small size, only use if you regularly update with KKManager or never download characters)
Read before installing
If you want to install the DX update, do it before installing HF Patch (DX cannot be installed on the Steam version of the game).
If you need any help, check the wiki, visit the Illusion Soft Discord server and ask in the #ai-help channel, or ask in comments under this post. The #ai-help channel is the fastest way to get help, you can even search it for your issue to see if someone already answered it. There are also chat and card sharing channels on the server!
To keep the download size reasonable, some of the less used mods are not included (mostly studio-only mods). To download them you can use the KKManager mod updater - run it at the end of HF Patch or from the game's launcher.
You can see the source code here and information about included plugins here.
Changelog
This is the list of changes made in the latest version of the patch. To see changes made in previous versions of the patch, check the releases page on GitHub.
Patcher changes
Also remove d3d11.dll when removing scripts
Fix not removing old Graphics plugin if it was disabled
Fix not removing custom launcher config from BepInEx\LauncherEN
Fix duplicate RuntimeUnityEditor entries
Update info page
Mods updated
Configuration Manager v18.4.1 -> v19.0 (Can change plugin settings. Press F1 to open, not visible inside HMD)
IllusionLaunchers v3.5.1 -> v3.6.0.0 (Custom game launcher)
KKManager v1.10 -> v1.11.0.0 (Manage and update mods, browse cards)
BepisPlugins v21.1.3 -> v21.1.4 (Essential plugins required by many other plugins to function)
Modding API v1.46.1 -> v1.48 (Modding API needed by many plugins)
XUnity Auto Translator v5.6.1 -> v5.6.2 (Translation loader)
BetterPenetration v5.0.1.5 -> v5.1 (Improves how penetration looks in H scenes)
Overlay Mods v7.1.2 -> v7.1.3 (Set custom body, clothes and eye textures)
Material Editor v4.0.3 -> v5.0 (Material editing in maker and studio)
StudioImageEmbed v1.0.3 -> v1.0.4 (Save custom images into scenes so other people can load them)
Graphics Settings v1.4 -> v1.5 (More settings to make graphics more or less demanding)
Timeline v1.5.5.1 -> v1.5.6 (Advanced animation editor for Studio (Ctrl+T, read the Help))
VideoExport v2.0.3 -> v2.1.1 (Video and image sequence recorder)
The Bird of Hermes v4 -> v5.6.0 (Timeline addon, allows loading an audio file, and get a waveform of the audio)
FPS Counter v3.3.1 -> v3.3.2 (Useful for performance testing)
Runtime Unity Editor v6.3 -> v6.3.1 (Debugging and development tool)
Comments (141)
Hi, i just read that Steam version is running older engine version, is it better to download japanese version even if im using HF patch? And i also read that japanese version has some extra content altough i cant find what exactly it is.
any your video channel
please bro add more h-scene in main game , threesome, foursome and more
The magnet link is completely dead. No resources can be found...
Just checked and there's plenty of seeds. Make sure DHT and torrent traffic is not blocked.
I cannot get the Cheat Tool window to pop up even after assigning to a new key input?
Press the F12 or Pause key.
everything i read up on it is years old
does this still exist please. i literally just got a pc again after 10+years and between not having a pc I saw this game and rly wants to try it. but its not the same without the graphics. so without the graphics not worth even trying.
Yes.
qBittorrent에서 다운받는데 너무오래걸려요 원래이런건가요?해결방법좀알려주실수없을까요?ㅠㅠㅠㅠ
Make sure you have at least 100 DHT nodes shown at the bottom, if there is less then there is a problem with your connection. Try opening a port for qbit traffic and/or using a VPN in that case.
its taking too much time finishing the downloads saying ''ETA 40 days" on qBittorrent. am i doing something wrong or do i have bad internet? or is there another way fasten the downloads?
Make sure you have at least 100 DHT nodes shown at the bottom, if there is less then there is a problem with your connection. Try opening a port for qbit traffic and/or using a VPN in that case. There's multiple seeds up at the moment.
will this patch unlock the 18+ mechanics in ai shouju
Yes.
Hey uh, Marco, is there a mod in the HF Patch that adds a Jacket that can have the outside color and Inner Lining colors be separate colors? (Would've asked you this question on the Illusoft Modding Discord, but your custom Discord status said to ping you and I wasn't sure if I'd be breaking server rules by pinging you without my ping being a reply.)
I don't know of any but you might be able to use material editor to edit the texture of some top if the UVs line up right. You can ping on discord there's no rule against that.
just made payment, there is no link to dowload the AI HF Patch
Click on the "Direct download links" link. You're not on the right tier though. You can always use the torrent link for free.
when i installed it whoulnt let me change to English.
If you are not on windows you have to follow additional installation steps, check the readme.
Wait so better penetration was updated? But when i go into uncensor selector there are no BP options.
Something is wrong then, BP uncensors should be installed by default. You can update uncensor modpack manually from the game launcher.
Hey guys, I downloaded the patch just like in the video. But I have a problem, there is censorship in it. How do I remove it?
Did you install the patch? See the guides, ask for help on discord if you don't know what to do.
Hey I have problem with saving/loading female cards in the character creation. When I go to the load or save tab all cards are missing and I can't save any new characters. I can load a character in the in game data terminal and also edit them but can't save them. I tried everything I could think of just to fix it. Updating the mods, verifying integrity of game files, reinstalling the HF patch and even reinstalling the game without the HF patch. It's been a long time since I've played this game and the last patch I had installed before having this problem was patch 2.17. Has anyone else had this problem?
Send output_log.txt on discord or look at the log yourself and look for errors likely related to the issue and try older versions of plugins that are involved. You can also try installing previous version of HF Patch.
I have downloaded 33GB from KKM. So I need to download the light patch, right?
Yes.
Would this patch fix the part where we get stuck on the traveling shop merchant right at the begining of the game?
It could, not sure what you're referring to exactly. At one point it may appear the game is stuck but you just need to change the tab.
Brother, i installed Ai shouju mods from your patreon the latest, and after it was done, the in game language in the game itself settings is fully Japanese not sure why. Tried downloading after couple of attempts a new xunity translator from github but it did nothing. I’m using Steam deck but got the game fully installed prior from the Steam store. Please help.
Check the readme https://gist.github.com/ManlyMarco/31b78470b8e190686c7ed9686c237e3f#running-under-wineproton-linux-steamos-macos-etc
Can I do a full patch with a light patch on?
Yes.
So i'm downloading the updates and it says ETA is 22 days and 6 hours. Is this an error? I can download about 300 gb for anything else in less then 4 hours.
See https://github.com/IllusionMods/KKManager/issues/195
hello i am using hf patch for AI,but my cheattools cant use,when i press the hotkey,no ui pop up,but noclip function is okay, i updated bepin5 and runtime editor, i need your help
Update both CheatTools and RuntimeUnityEditor, use the editor hotkey to open it.
Thanks for the patch, I am however having an Issue. In game (not in maker) the body becomes invisible underneath clothes with tear/damage. entering then exiting H scene with a character fixes it on the character but the problem reoccures every time I load the game. Had this problem with the 2.24 patch also, any help would be appreciated
If it's a Steam version of the game make sure Steam doesn't update it, you have to reinstall the patch then. If that's not the issue then it would be best if you DMd me on discord or asked in the ai-help channel.
Help me plase. I Cannot add accessories to the character
Remove the Maker Buffering plugin.
"Redownload that part and try again." Still getting the same error.
You must be doing something wrong, the files are fine on the mirrors. Make sure all parts are in the same folder and have original file names. Ask on the discord server in the help channel or DM me if you can't make it work.
I've downloaded the latest patch. But I can't proceed cuz AI-Shoujo HF Patch v2.25-1.bin is corrupted. Can reupload?
Redownload that part and try again.
So this is a really random question, but does the illusion cards have to be saved from the Illusion card website? Or can it be saved from anywhere. Main reason I ask is because, the website for illusion cards just freezes on checking to see if I am a bot or not.
Official uploader has been shut down for a while now. You can get cards from anywhere else.
Sorry if this has been asked before... but I have no issues installing the patch, starting the game, and creating characters, but any time I try to load up a new island to actually play the game, I get an infinite load screen. Tried verifying files, reinstalling, and repatching. Also tried in both windowed and full screen. Console shows a list of errors and stops during the load screen. Am I doing something wrong/is there a fix for this?
Try a fresh game + patch install. If that doesn't help, send output_log from game directory, preferably in discord DMs. Also specify which game release you have and any DLC or separate mods.
Is it ok to use Steam version or should i get different version? I applied this patch on my Steam AI Shoujo and basicly any card i download is broken looking like its from Necronomicon, even official cards imported from HS 2 are not working . Also is there way to keep official translation with HF patch? Thank You.
The steam version of the game should work the same as other versions for most cards. Try restarting your PC and reinstalling the patch with no other applications running in the background. If the problem persists ask in the help channel on discord or DM me on discord. The patch should keep the original English translations, just make sure to select the correct language in the custom launcher first in case you didn't choose English when installing the patch.
cannot change ingame language to english
also cant find uncensor selector
just installed, now game is crashing before the illusion logo even shows... did i do something wrong?
What version of the game? If it's on steam then try verifying local files and reinstalling the latest version of the patch with the option to remove all old mods enabled. If the issue persists check if BepInEx\plugins\ConfigurationManager contains any other dlls than ConfigurationManager.dll, if yes then try removing them.
Question, Marco, this HF patch adds the hentai content to the Steam version of AI Shoujo? Steam version does not have the hentai content. I need to know before I buy AI Shoujo on Steam. Thanks. 👍
It does.
Hi the Magnet link is not working.
Use qBittorrent.
I feel like I'm being gaslit. There is supposed to be an exe file, no? If I'm missing it, please spare me the "can you not read" posts. I downloaded both the 2.22 and 2.1 and cannot see the .exe file. Any help will be appreciated
Use the magnet link or direct links to download the patch, no idea where you're getting it to not have a .exe
so it need 5$ to download HF patch now ?
No, use the free magnet link in the post.
Hangul is not displayed. Please give me your condolences so that I can resolve it.
I guess some font is missing, try asking on the discord server.
Hi, sorry to bring this up again, First off, great work on the patches for both AI and HS2 :) Just a reasonably quick question... Having read the above comments, are balls on female characters in AI (Steam version) still not an option? Just I've been frying my brain trying to figure out why the bones show in the character maker (Bonemod menu, type 'dan' in the search box and the xyz axis appears where the balls are supposed to be after selecting an option in the uncensorselector dropdown menu) but nothing is actually visible. To quote the AI_uncensorSelector_base zipmod manifest 'Base files for AI_UncensorSelector. Adds balls for girls.' I'm only asking because the answer above says balls for girls is not possible for both AI and HS2 but a fresh install of HS2(Steam version) and the latest HF Patch now show fully working (with physics and colliders etc) BP4/BP5 balls on female characters but only in HS2 both main game and Studio. They also work fine in Studio found in the AI Girl HF patch just not AI Girl main game and character maker so I figured something might have changed for HS2 as they work in that and I'm doing something wrong for AI girl. Sorry for the massive comment or if any of the seems like I'm being awkward, absolutely not my intention so sorry again just I've been try to fix it for a week+ and its bugging me lol so finally decided I should ask the person who would actually know. Thanks in advance and once again, great work on the HF Patches, they turn a good game into a great game :)
No one really plays AI main game so it very well could be broken there. No idea why it would be though, maybe it's a steam version thing.
will this work on steam version or is it still not possible?
It works fine with the steam version.
Hi, the FH Patch for A.I shoujo, Cannot give balls to futa, help please? i selected an option of display female balls from plugin menu (F1), nothing happens when i select balls for a girl. and the option in the body tab, where is a option from UncensorSelector (a plugin) to add a penis/balls to a girl are not working too, (only penis works )
Hello, it's not possible to add balls to futas in AI/HS2.
how can ido this patch on steamdeck
I've had reports of people getting the patches to work, but I don't know the specifics. You'll most likely need this https://docs.bepinex.dev/articles/advanced/proton_wine.html
I want only mosaic patches, and I selected light patch but Next I won't.How to do?I don't like add other patches I like the content close to the original.I also want to ask Kolkata party and HS2 DX
Make sure you download the correct patch for your game. This patch is for AI, not KK or HS2.
are you charged every time you updated i just joined about a day ago and was charged 3 seperate times
Unfortunately that's how patreon works, it will always charge on 1st even if you subscribed a day before. I can't really do anything about it other than give you a refund.
In the past I have used your modpack with no issues. Several months ago I started getting black screens when adding girls. I resubbed to get latest modpack and still have the black screen issues. It sounds like game is still running, but the only thing I can do is exit game once it becomes black. I even completely uninstalled/reinstalled the game and picked the unlock save when installing the modpack. Now when trying to create a new free mode game I can pick a girl, but when trying to pick character the game will not proceed past character select. I did verify that magic carrot is installed. Do you have any ideas on how to fix this? Thank you in advance for your time.
Replied in DMs.
Been having crash issues not for sure what's causing them. I do seem to noticed that I seam to hear the sound of discord going off before the game crashes.
If you're playing in fullscreen, try windowed mode. Otherwise post output_log from game directory in the help channel on the discord server and describe the issue.
Alright I can't even install the game properlly. Here is an image of the error? https://ibb.co/rsb49D8
Move the installation files to a directory like D:\download\hs2, make sure all files got downloaded and extracted properly.
When I'm not getting a hash error, one of the files is corrupted during the install. I've been redownloading and troubleshooting for four hours
Try a different PC if you can (or a different OS on the same PC). It might be because of some malware messing with the files as they are downloaded, or because of a failing HDD. If you are trying the DDL links, try the torrent instead.
Anyone know what [kky] crytowallet.zipmod is? found it in my update list.
Probably some studio item, you can check what's inside the mod with any zip archiving app.
i installed all 9 bins file and 1 exe files into 1 folder but after choosing where to setup the exe files (steamlibrary/steamapps/common/ai-shoujo).... the setup not responding
You have to put the patch files in any directory outside of the game directory for it to work. If the installation is taking a long time that's normal, leave it for some time and it will eventually finish.
have the newest patch successfully installed, but the font size in game mode / character creation mode becomes too large and I'm not able to click on specific buttons. Is there a way to adjust the font size?
I reinstalled the patch following recommended setups without installing addition packages, and the font size issue is fixed.
Problem solved by switching torrent clients. TY for your time and talents.
great job! noticed a couple bugs when i was playing, MC eating gives tiny fraction of food/water fullness, compared to NPCs, made survival/play difficult; also, putting NPC to recuperate in player-character sleeping spot caused health to regenerate, but not stamina. Even after NPC woke up w/ no stamina and passed out again, putting them in original island sleeping spot did not regen stamina, either.
Maybe you installed the hardcore mod? It's optional during patch install.
Hi, I clicked the start mod updater. Its downloading 83 gb of data. Is this normal?
It sounds like you never downloaded the studio mods, yes they do take up a lot of space. If you don't use studio then you can uncheck the studio sideloader modpack and the studio maps modpack, that should bring the download size down drastically.
it's said that "AIS_HFP_29.7z 001" has been damaged
Make sure you put all downloaded files in the same directory. If you downloaded the torrent, force verify downloaded files in the torrent client or try latest version of qbittorrent. If you use direct downloads try downloading the file in question from a different source or with a different web browser.
I am so lost on how to install the patch. There are instructions everywhere and so many links. What is the simplest way to install the Ai patch.
Download all parts to a single folder and keep clicking next (assuming you installed the game already).
So upon installing the patch, when you start a new game you are unable to cook the fish in the tutorial or after that point.(Used cheat menu to get the fish just to see if it was just a tutorial bug) No food recipes show in the list. There a known reason for this?
What version of the game are you using? If you use the steam version, verify local files in steam library then reinstall the patch with default settings. Otherwise reinstall the game and then the patch. If you still get the issue then send me the output_log.txt from your game directory after you try to cook the fish and check the recipes.
Blessed thank you. just started enjoying this game.
Says "cyclic redundancy check" when trying to extract [LSZC] 2Bybacc@LSZCqq887387353.zipmod. Any suggestions?
If you downloaded a torrent then force verify files in your torrent files. If you downloaded the direct download then use the included .exe to verify and extract a fresh copy of the patch files.
Anyone know how to make the game use the kk_pregnacy plus morphs instead the original morphs?
Try asking the author of kk_pregnacy plus
Ah, gotcha. Thought it was like Koikatsu where the translations are during H-Scenes too. Appreciate your work! Thank you for the response.
Hey Marco, I Posted this in the Illusion Server Discord, but\\ with the HF Pack (Version 2.8) there are no subtitles in the H-Scenes. When the BepInEx\Translation\en\Text_AutoGeneratedTranslations.txt file was cleared (The cache) Issue still persists, any thoughts? Inside the plugin directory in game under subtitles 2.2 it states that the directory is at Translation\AI_Subtitles. That directory doesn't seem to exist in the path, there is no AI_Subtitles.txt Would you happen to know how to resolve this?
As far as I know the subtitles only work in character maker.
How do you use the AI_ClothesAssignment v1.0.0? Do I just edit the clothes file and put the character's name or something else?
Add character names to the names of clothing cards you want them to wear
Will this allow to have the older slider back or will this remove them permanently on steam version
It will restore them.
I keep getting corrupted file with the 7z.006 file. and with that the .exe wont launch due to missing file. I have tried all three download sources and a few times already but still no luck, any advise to fix?
Try using a different web browser, restarting your pc and turning off any other applications you have running.
A fantastic mod, thanks! Just one issue...after installing Patch 2.7, character creation works, except when trying to load other characters. Tells me I have old versions and faces are distorted. Like I said, everything else works. Update...figured it out...userdata! Thanks.
When this happens the first thing to try is run update from the game launcher.
After I installed Patch 2.7 I see it listed on bottom right of menu screen but it also still shows Patch 2.5. listed next to it. So, how do I uninstall and remove the previous 2.5 patch to only have patch 2.7 running?
The patch automatically removes previous versions, the launcher shows a history of what was installed in case it's needed for troubleshooting.
I'm having the same issue as with 2.4 - none of my female uncensors are showing up. I tried the fix I used before (disabling puffy beaver mod) but it was no good. Not sure what's happening since all the BP uncensors and such are installed and show up normally in KK Manager. :(
Ok, not sure exactly what I did, but somehow some of the mods got updated and it's working now! I updated the Better Penetration plugin as well. Also, I noticed the BP uncensors I saw in KK Manager had [KK} in them, and when I updated the Uncensor Selector, the proper [AI] ones were added.
Ok that download of files was the correct one and it worked great! Make sure the files you are downloading have AIS_HFP_ in the name.
Well I think I may have found my answer. Some of those direct links have you download HF2_HFP_ files. I think you want to make sure they are AIS_HFP_. I will confirm this if they work. It's going to take a while to download them.
I checked all of the links and they all point to the correct AIS patch. Which links are bad exactly?
Why does this end up saying this is the patch for HoneySect2 Setup Wizard? I am trying to patch AI Shoujo?
Hi Marco, just downloaded the HF patch (first time because I just got the game 2 days ago) and the application to run the patches doesn't work :( Big sad. (Also I have reinstalled the app and uninstalled twice and have restarted my computer.)
What do you mean by doesn't work? Make sure the exe file is downloaded properly and that other software on your PC isn't interfering. Try rebooting your PC and adding it to the whitelist in your antivirus.
Hi Marco, Just a quick question. I am not sure what exactly happened. I installed the patch over my older HF patches and now it shows me HF Patch 2,4; HF Patch 2,5 HF Patch 2,6 Is this normal? Also I now have two "Enable grafics mod" which lowers the frames to 10-12 if i have them both on. Is there a way to know which one is the newer one or how to fix that whole thing? Hope I don't have to reinstall my game :(
I want to know that too. :D"
还用额外下载KK吗
This patch is not for KK, it's for AI Shoujo. You can get the KK patch here if you want to download it https://github.com/ManlyMarco/KK-HF_Patch/releases
sorry, this is first time play this game, already download discord, still search the ai shouju disccusion
Join the server linked in the post above and look for the ai-syoujyo category.
why i cant use another character face ?
What do you mean? You can change how a character looks in maker, or you can download more characters from the discord server.
Are any of the Fan translations for the H scenes or is it not possible to add them?
You mean subtitles? At the moment there are none since they are much more difficult to do than in KK.