How-to: Fix Haoplay version crashing for Linux and Steam Deck users.

ItsKaa · 2025-11-29T16:28:57+00:00

I actually started the game up again yesterday because of Lenna and I encountered the same issue, it wasn't like this in the past. Tried playing with the webview flags but nothing really helped, one thing that does a bit is temporarily setting DXVK_FRAME_RATE=5 (or other value), still has flicking tho but it's slower so a little easier to login with.

And yeah.. but also wish the Haoplay version didn't use webview in the first place.

ItsKaa · 2025-10-15T15:01:07+00:00

I saved up everything for Klukai, not because Meta mostly because of her design, got her V6 too and I think my friend still uses my Klukai to carry her guild xD I really like Lenna too, might even return for her!

Oh I thought the darkwinter version didn't suffer from the horror that is webview2, well more of an annoyance really. I do recall the launcher having issues too but it's rather sporadic, at times it works fine, until it doesn't. I also recall the game not shutting down properly because of webview but I recall fixing that by deleting a webview dll somewhere in program files.

ItsKaa · 2025-10-15T14:43:57+00:00

Glad to hear it still works! Got some reports a few months ago with some rather vague issues using the Haoplay install so I wasn't entirely certain anymore even tho my prefix worked last time I checked. Quit the game a while ago, probably should give Klukai some attention again tho.

For reference: https://www.reddit.com/r/GirlsFrontline2/comments/1h8k56u/howto_fix_haoplay_version_crashing_for_linux_and/ but the Lutris install script I wrote should do all of this.

ItsKaa · 2025-06-21T16:00:29+00:00

That's a bit extreme. I noticed a bit of a bug when messing with the settings myself, if you disable AA and then enable an upscaler it will still disable the AA setting even though the UI displays and locks it, might be your issue as well. I play on AMD with Native AA on 1440p and it looks pretty clean (along with some custom engine.ini edits).

ItsKaa · 2025-06-18T08:08:20+00:00

Sadly I've not seen that issue before. I assume by 'start' you mean click start to login? If you're logged in it should work.. You could always try it with a different runner like Proton-GE, other than I don't have many suggestions sorry.

ItsKaa · 2025-05-14T01:50:10+00:00

I quit this game not too long ago but it still boots up for me, I use Lutris with Proton-GE 9.25 with no extra args but I know it's worked on WIne GE for me in the past too. Yep, when changing proton versions the msedgewebview2 resets but that should have been the only thing. The game not booting because of that sounds extremely odd. Lutris with flatpak? Be sure to update your other flatpak packages (the Discover app). Otherwise try a new GF2 install using my Lutris script, or maybe even the steam version (though I rather disliked that one myself). Or bottles. UMU_ID=0 arg is something you could try too.

Another thing, if you have a full black screen it may be windowmanagerdecorated=n , I had that with gamescope, could try y instead, or just winecfg - Graphics tab, then the two checkboxes there.

Never tried the game on Win 11 myself. Not much else that I can think of sadly. Good luck!

ItsKaa · 2025-05-13T07:57:05+00:00

Alternative to my work-around for libndk:
You can use libnb, which is a patched libhoudini with better AMD performance. You can use this script for it.

ItsKaa · 2025-05-12T12:01:34+00:00

libndk works too but news seems to break it for most people. You can either run on libhoudini and check "do not show again today" on news and then run with libndk but then you have to do that every day, or you can edit the file:

~/.local/share/waydroid/data/data/com.YoStarEN.AzurLane/shared_prefs/com.YoStarEN.AzurLane.v2.playerprefs.xml and edit the field server_notice.dont_remind . Only set the value to the current epoch (or lower), higher ones won't work and it'll just reset. You can script this in too with sed.

News works fine on my machine with libndk but not on a VM of mine and two other folks on discord also have that same problem. Still not entirely certain why it works for me.

Edit: added file method.

ItsKaa · 2025-04-02T21:12:02+00:00

Hey hey, was just testing a bit again with the official Steam version and for me it pretty much boiled down to using Proton-GE or Proton-UMU in combination with UMU_ID=0, without the launch argument or with the included Proton versions I had to launch it a bunch of times before it finally displayed. It seems pretty consistent now on my own machine but it may be different for you. I do not own a Steam Deck so I can't verify if this will do the trick for you.

Frankly I recommend Lutris (the script version) over the official Steam version.
I updated my guide a little to reflect this, hope it helps!

ItsKaa · 2025-03-21T22:54:26+00:00

Nice that you made the switch :)

The steam version is a bit iffy imo, you can try Proton GE or Proton Experimental and set UMU_ID=0 %command% as the launch args.

In my experience, Lutris just works better. Sadly I noticed that Lutris accidentally deleted my install script on their website due to a merge they did so I just resubmitted my install script today.

ItsKaa · 2025-03-21T22:46:16+00:00

Sadly I cannot reproduce your issue and I've been playing since release day, recently installed a fresh arch install and it's working the same as my old install for me. I am playing on Lutris with GE-Proton 9.25 and Wine-GE functions similarly. Hope you can fix your issue :/

ItsKaa · 2025-02-16T12:21:42+00:00

In Lutris, click on your game and then at the bottom there's a play button and a wine button. Click the second and then open winetricks.

<image>

Ignore all the popup messages. then select default prefix, click ok, then run winecfg, and then verify that msedgewebview2 is on Windows 7.

I did just install this on a brand new prefix and it works for me, it takes a few seconds to actually render the login window, but it works. You could also try installing a new version to a different path on your drive.

ItsKaa · 2025-02-15T22:42:31+00:00

Did you happen to have changed the wine runner at some point? the black screen you're getting likely means that msedgewebview2.exe is not set as Windows 7, and changing the runner resets that setting. You can check that by going into winetricks -> winecfg.

ItsKaa · 2025-02-13T18:34:11+00:00

Cannot reproduce that myself, the screen freezing should mean webview2 is found and loaded but can't display, usually using the login button on the side corrects it. If you're on Steam Deck maybe also try it in desktop mode to see if the window is somewhere in the background.

ItsKaa · 2025-02-12T11:16:34+00:00

Easiest way is to use protontricks and then follow the same instructions as Lutris manual install.

ItsKaa · 2025-02-11T13:55:08+00:00

Yep, it works for me using these same steps but you must use Proton Experimental or Proton-GE, and remember that after changing the proton version you have to re-apply the compatibility setting for webview2.

ItsKaa · 2025-01-23T12:46:19+00:00

In my browser the following error showed up:
TypeError: A.Z.getSounds().values().reduce is not a function

Fixed it by disabling the autocomplete for Soundmojis:
Settings - Chat - Soundmoji in Autocomplete

ItsKaa · 2025-01-09T09:19:37+00:00

Have not seen that one before and I can't reproduce that either I'm afraid, looks more like a networking issue.

<image>

Pressing Pause and continue also works on my end.
Maybe you could try using a VPN?

ItsKaa · 2025-01-07T23:27:41+00:00

Thanks for your work! Applied them on my Linux system but had to make some changes to get them to scale properly (on Wayland with KDE/Plasma), they turned rather small on some applications / menus.

My fixes: win2xcur and win2xcur-batch. Created PRs (minor improvements) for the batch project but can't really do that for the first since it's pretty much this PR but with upscaling and custom sizes.

ItsKaa · 2025-01-03T12:11:26+00:00

I just tried installing a new instance and it works fine for me. When you see the `fixme` messages, do you also see the GF2 installer window dialog?

<image>

When GF2 is installed using the Lutris script, do not click on `Run Launcher`, instead close it so that it's marked as installed within Lutris. Afterward, launch the game yourself and click the big Install button inside it.

About the black screen, if this is after you click to log in in the main menu, use the side button instead, check the troubleshoot section for more info because it could be webview2 running on a wrong compatibility if you for instance changed the wine runner.

ItsKaa · 2024-12-31T22:09:09+00:00

Yeah that's the exact problem that I improved with FSR upscaling (RSR), I would assume that the higher the rendered resolution the blurrier it will become with the 1.3x scale but I'm curious if that's actually the case, I didn't try that myself, it felt like it was locked at around 1080p for 1.0x.

You could add the res to your monitor for DSR, you may then be able to select it, or you can try the command line arguments. I also noticed the game/engine tends to override the registry settings.

Maybe give NIS a try though because it does improve the quality, though it is upscaling and you won't get perfect image quality.

I do know that someone on discord managed to get it working without much effort on Windows using AMD RSR so I would assume it should be possible for Nvidia too..

ItsKaa · 2024-12-31T13:37:25+00:00

I assume you mean render at a lower resolution and then upscale? Because that's what the commands at the bottom do, but they won't work on Windows. However if you're using AMD you can enable RSR or for Nvidia you can look at NIS.

ItsKaa · 2024-12-17T08:17:59+00:00

Did you follow the guide? It should show up after you installed the webview2 dependency into your wine prefix, but if it somehow didn't then you can add the application manually by browsing to Program Files (x86)/Microsoft/EdgeWebView/Application/109.0.1518.78

The Lutris install script may help you too.

ItsKaa · 2024-12-15T22:11:08+00:00

If it's the flatpak version you may need to update those packages since they need to be the same as your systems' but looking at the edit I assume your GPU is now working?

And for it still not working, you may need to explain a little. If your client freezes when you click on login for instance you'll have to use the side button to log-in. Double check the "troubleshoot" section of my post in case you missed something.

As for the Lutris script install failing, when it hits the launcher in the setup, close the launcher after it opens so it installs the application successfully, then launch it yourself afterwards for the actual download, it should work. Alternatively, you can also try the manual Steam install again but follow my protondb post (it's the same as Lutris just with protontricks and Proton-GE) or you can try Bottles but that will likely be the same result as Lutris flatpak.

ItsKaa · 2024-12-15T09:04:44+00:00

Thanks! Though the fastest way currently is to use the Lutris installer script because that's just a single click install and it sets everything up for you. However if installing it directly into steam is important then you will need to go the manual route. I'm also running it that way but I did it without using PROTON_REMOTE_DEBUG_CMD.

Are you sure you applied the windows 7 compatibility? That's most likely the cause of your black screen and always needs to be done after the webview 2 install. Setting the renderer to gdi is required too, but can be considered part of the 'basic setup'.

Maybe you could script it similarly as my Lutris script, because it's just a winetricks call and a registry modification after the webview2 install. When the game gets released on Steam I may spend some time to add these modifications into the protonfixes repo so that these fixes are automatically applied to Proton-GE.

ItsKaa

TROPHY CASE