The symptom: you start the game in any mode, you get a black screen, and it crashes before you ever reach the main menu. The launcher itself works fine. It happens every time.
If that is you, read on. This one has a single cause in almost every case, and a fix you can do yourself in five minutes.
What is actually happening
There is no anti-piracy code in WukongMP per-se. We did not write a check.
However, it is VERY IMPORTANT TO REMEMBER that ReadyM DOES NOT ENCOURAGE NOR SUPPORT PIRACY in any shape or form
WukongMP requires a legitimately purchased (or gifted) copy of Black Myth: Wukong (from any authorized reseller). Any discussion promoting, asking about, or facilitating the use of pirated copies of the game will result in an immediate and permanent ban - no warnings.
What we did write though - is a mod loader, and the loader hooks into the game’s executable. To do that it depends on the exact byte layout of the original Steam or Epic build. If your .exe has been repacked, cracked, or patched by anything else, that layout no longer matches, the loader cannot find what it needs, and the game dies before the menu comes up.
Two things follow from that:
- A cracked copy will not work, and there is nothing we can (or want) do about it from our side.
- A legitimately bought copy will also fail if some other - third party mod or tweak tool has replaced or patched the game binaries. This catches people who did nothing wrong and are genuinely confused, which is most of why this post exists.
The fix
Put the original executable back and let the store do it for you.
Steam: right click the game in your Library, Properties, Installed Files, Verify integrity of game files.
Epic: Library, the three dots under the game, Manage, Verify.
If your copy came from somewhere without a verify tool, a clean reinstall does the same job.
Let it replace whatever it wants to replace. Then start the game once on its own and check it reaches the menu. Once it does, launch through the ReadyM launcher again.
If it survives a clean verify
Then you have a different problem and we want to see it. Open a thread in WukongMP Support with:
- Your launcher log and your client log
- Game version and which store it came from
- Whether the game starts on its own, without the ReadyM launcher
- Any other mods you have installed
The policy part, said once again!
WukongMP requires a legitimately purchased or gifted copy of Black Myth: Wukong. We have zero tolerance for piracy and the server rules say the same thing. We would rather spend our support time on people hitting real bugs on a real copy, and there are a lot of those.