Troubleshooting Guide [YunaMS]

[yuna]

Last updated: December 5th, 2024​

A Note Before Troubleshooting:
First and foremost, some users may be concerned that the client, or some of the YMS DLL files, are getting picked up by their anti-virus/anti-malware software. This is completely normal in the MSPS community. The reason for this is that the localhost (i.e. the client) we use is unpacked to work on our own private network. As a result, this violates Nexon's digital signature, which subsequently sends an alarm to most security software. Nexon originally used Themida to protect against tampering the client, however this was cracked by some talented individuals (and subsequently, what allows us to use the client for our own server). As a result, most security software will now automatically pick-up these types of files as a false positive. To ensure your files remain untouched, please remember to add an exclusion for the entire YunaMS folder in your security software (i.e. Windows Defender). If you have any questions or concerns, please feel free to reach out via Discord or the forum!

---

Hello!

The following troubleshooting guide will assist you with some of the common problems and their solutions.
This table will be updated as additional issues/solutions arise:

SECTION	PROBLEM	ROOT CAUSE	SOLUTION
1	Files disappearing, especially YunaMS.exe, OR nothing happens when I open the client, OR game opens briefly then closes	Multiple	Steps: Disable your antivirus/defender Ensure you have no conflicting programs open (i.e. other games that may have any sort of anti-cheat system) Add the entire YMS folder to your exclusions list Delete the file called version or version.data in your YMS folder Run Patcher.exe to re-obtain all missing files Run YunaMS.exe! OR Right-click desktop Select Display Settings Select Advanced Display Settings Change Refresh Rate to any value GREATER than 59 Hz Run YunaMS.exe! OR Right-click YunaMS.exe Click properties Select the Compatibility tab Select Change settings for all users Select Change high dpi settings Check the box labeled Override high DPI scaling Ensure the drop-down is set to Application Click ok to save all settings then try to run YunaMS.exe again! OR Try setting your monitor resolution to a value that maintains the 16:9 aspect ratio (i.e. 1920x1080) OR If using a NVIDIA GPU: go to the NVIDIA control panel > click"manage settings 3D (on the left side) > "program settings" tab. Put YunaMS.exe there and choose "image scaling" and enable scaling using GPU core OR If using a NVIDIA GPU: NVIDIA broke something with their latest GPU update (560.70). Users have reported success by reverting to the latest working driver here. OR Try enabling variable refresh rate. To get to this setting, search for "Graphics Settings" in the Windows search bar. More information on this can be found here. OR Close all clients Go to settings.ini in your YMS folder Set the value of singapore_proxy to 1 Launch YunaMS.exe OR Some users have reported success by connecting to a VPN - you can use any free VPN service such as NordVPN or ProtonVPN. Try connecting to a region in Canada, such as Toronto or Montreal. OR If all else fails, please delete the YMS folder and re-download the full set of game files freshly from our download page
2	To run this application, you must install .NET Desktop Runtime static x64	Lacking system requirement(s)	Click here to download and install .NET runtime
3	MSVCRXXX.DLL not found OR receiving error 0x000007b OR error with MSVCPXXX.DLL	Lacking system requirement(s)	Click here to download and install the Visual C++ Redist. pack Simply open "install_all" and let it run If the above does not working, try installing this version of DirectX
4	Failed to load d3dx9_xx.DLL, or DirectX-related error message, or d3d8.dll not found	Lacking system requirement(s)	Click here to download the DirectX package needed for YMS
5	Game crashes with no error, especially when opening your inventory or when entering a map	Mismatched registry settings	Right click YunaMS.exe Select properties Change compatiblity mode to Windows XP OR Type `/resetsettings` in-game (if you are able to at least land in-game) Close all clients and re-open OR Close all clients you have open Click here to download and run the fix Open this file Re-open YunaMS
6	Vote did not go through	GTOP server may be lagging, or did not register your vote	Ensure you received a "SUCCESS" message when voting; if not, retry the vote If you received a "SUCCESS", wait up to 5 minutes for your vote to be received; typically, though, this should be instant Ensure your ad blockers are off, and that you aren't using a privacy-heavy browser like Brave Try a different browser, device, or account
7	Error code -2147467261, or Unspecified Error, or Invalid Pointer	Resolution-related discrepancy	Ensure your monitor refresh rate is at LEAST 60hz Update settings.ini to change your resolution to another (preferably option 1) If using a NVIDIA GPU: go to the NVIDIA control panel > click"manage settings 3D (on the left side) > "program settings" tab. Put YunaMS.exe there and choose "image scaling" and enable scaling using GPU core Ensure your graphics drivers are fully up-to-date Try running in compatibility mode for Windows 7 or Windows XP Try setting your system locale to English (US) and UNCHECK Unicode. Here is a guide.
8	Extreme game or network lag; keep disconnecting or crashing; login button stuck for a minute before proceeding	Network-related discrepancy; particularly experienced by overseas users	Close all clients Go to settings.ini in your YMS folder Set the value of singapore_proxy to 1 Launch YunaMS.exe OR Use a VPN to connect; ProtonVPN and NordVPN have been known to work well; you can try connecting to Canada or Netherland or Belgium Try using Google's DNS, click here for more info Flush your DNS using this tutorial [Read fully!]
9	Patcher update failed, or Access Denied, or Unauthorized Access Exception, or Patcher.exe asks for .NET runtime install	N/A	Download and install this Please close any MapleStory windows, as well as the patcher, then re-runthe patcher Can be an array of issues; please upload the contents of your Logs folder inside your YunaMS folder and create a post in the troubleshooting section with your logs link. Your issue will be addressed ASAP. Please try deleting your files and re-download from our homepage, then run the patcher again; do NOT mix any files as the patcher will handle everything
10	Unable to connect to the server	N/A	First, confirm the server is online by checking the website Ensure you are connected to the internet Try using Google's DNS, click here for more info If you are already using a DNS, try to use the default DHCP DNS Try setting the singapore_proxy to 1 in settings.ini If all else fails, try to unplug your router for 2 minutes, then replug and try again
11	Invalid, corrupted, or outdated files error	Files were either deleted, corrupted during patch, or tampered with after installation	In most cases, all you need to do is run Patcher.exe located inside your YunaMS folder - this will analyze all your game files and provide you with only the files you need If this does not fix your issue, please re-download from the homepage and run the patcher once more.
12	How do I enable client mods?	N/A	Most mods can be done using our Widget in-game (check the bottom-right of your screen in game. Inside your YunaMS folder, you will see a file named settings or settings.ini - there's a few mods available here, but most will be in the widget. If you want to change something here, open this file and make the changes you'd like as instructed. When you're done, save the file, and restart your client.
13	Entire screen is flickering, and seeing double	Graphical issue, separate from GFX, which has an unknown cause currently	Close your game and run the patcher
14	Skills not working or pet auto pot not working, or pet isn't looting, or unable to see mob names or health bars	N/A	Players were able to resolve this issue by following these steps IN ORDER: Type `/resetsettings` in-game Close your game Update your Windows (check for Windows updates) Restart your computer Run patcher and launch game OR Close all clients Click here to download and run the fix Open this file Re-open YunaMS
15	Crashing frequently, or crashing in bosses, or boss NPC crashes, or crashing after exiting Cash Shop, or random crashes, or Error code -2147221000 (DLL for class not found) or ERROR 38	N/A	Ensure you have run the patcher Try setting compatiblility mode to Windows XP Service Pack 3 (Right-click YunaMS.exe > Properties) Ensure you run the client as ADMIN (Right-click > Run as administrator) Ensure your antivirus or Windows Defender is excluding the entire YMS folder Download and install .NET Framework 3.5 Ensure your desktop background is NOT on slideshow mode, or rotating, or any sort of desktop background that changes after a few minutes Close Chrome and any additional web browsers Close any background processes that may be interrupting the YMS process Follow this tutorial to set your system's locale to English US, then restart your computer. Make sure you UNCHECK "use unicode" If you are still receiving this error, ensure that the entire name of your directory contains only ENGLISH characters (i.e. c:/user/yuna and not c:/users/yunã or anything that is not english characters)
16	Maker Skill does not finish executing - button appears clicked, or maker does not do anything	N/A	Try crafting something random first, then try again. If it does not work after doing this, see steps below Players were able to resolve this issue by following these steps IN ORDER: Type `/resetsettings` in-game Close your game Update your Windows (check for Windows updates) Restart your computer Open your game and try again OR Close all clients Click here to download and run the fix Open this file Re-open YunaMS
17	Strange symbols or characters appear in-game; then shortly crashing with 0x008 error, or error -2147221000	Invalid directory, or system locale	Follow this tutorial to set your system's locale to English US, then restart your computer. Make sure you UNCHECK "use unicode" Ensure that the directory your YMS folder exists in does NOT have any special characters such as -,.*~, etc. Must contain only English letters and normal slashes/ Ensure your desktop background is NOT on slideshow mode (change it to be a static, non-changing, image or solid color instead
18	"Bad Image" error or error status 0xc000012f	Process was interrupted while patching or launching	Follow this guide to run sfc /scannow
19	Receiving the "Game Update available" message even after running the patcher, or the patcher is taking very long despite a good connection	Local version mismatch	Delete the file named version (or version.data), then run the patcher again NOTE: do not do this every time. Only delete the file if you are unable to patch
20	Screen shaking wildly, can't see anything straight	N/A	Close your game, and run the patcher
21	Unable to connect to login server / server check notice, even when server is online	Network-related issues	Please first ensure the server is ONLINE, by going to our main website yuna.ms and checking the status. If it is online, continue reading: Try using a free VPN such as ProtonVPN Flush your DNS using this guide Try using Google's DNS, click here for more info If you are already using a DNS, try to use the default DHCP DNS Try setting the singapore_proxy to 1 in settings.ini If all else fails, try to unplug your router for 2 minutes, then replug and try again
22	How can I reset my widget settings?	N/A	Type `/resetsettings` in-game Close any clients you have open Reopen game Done! OR Close all clients Click here to download and run the fix Open this file Re-open YunaMS
23	Not seeing any skill animations or damage numbers	Registry mismatch with local client	Type `/resetsettings` in-game Close any clients you have open Reopen game Done! OR Close all clients Click here to download and run the fix Open this file Re-open YunaMS
24	Game randomly crashes with a pop-up that freezes the game. Pop-up states: "Microsoft Visual C++ Runtime Library" but has no text.	Runtime issues	Close all clients you have open Download and run this Download and run this as well Right-click your YMS folder > Properties > Ensure the "Read-only" check box is completely BLANK (not checked, no black square) Reopen game
25	"The application was unable to start correctly" Error 0xc0000142	N/A	Ensure your antivirus has either excluded the entire YMS folder or has been disabled Ensure your YunaMS folder lives in a directory/path with no special characters Ensure your machine's language is set to English (US) If the above still fails, continue reading: Click start Open Command Prompt Run this: for %i in (%windir%\system32*.dll) do regvr32.exe / s%i Run this as well: for %i in (%windir%\system32*.ocx) do regsvr32.exe / s%i
26	XInput1_4.dll window error when trying to open the patcher or game client	N/A	Go to Windows/System32/ folder, locate the XInput1_3.dll file, copy it to your desktop, rename it as XInput1_4.dll and put it on that windows/System32 folder"
27	Game client closes a few seconds after opening everytime its opened	Anti-Cheat System	Our client-based anti-cheat system runs a check every few seconds to scan for blacklisted programs that are open on your machine. Ensure that there isn't a program open that could be considered as a hack; close these programs Restart your machine
28	Game crashes after entering PIC	Kernel Issue, ACCESS_DENIED	Users have reported that they were able to login after following these steps to disable Memory Integrity
29	Chair/Mount and other animations are not properly disappearing	Registry configuration mismatch	Simply run the RUN_FIXES file found in your YMS folder!
30	Game stretching more than usual, or game looks really large and not fitting on desktop	Graphical issue related to system configurations	Right-click YunaMS.exe > properties > change high DPI settings > Disable "override high DPI scaling behavior"
31	Hyper teleport rock causing crashes	Invalid map, or a strange windows interaction	Right-click YunaMS.exe > properties > change compatibility mode to Windows 7 > run the "RUN FIXES" file in your YMS folder > Try again If this does not work, please post on the forum or discord with your IGN and which map you are trying to access
32	Error 0xc0000906	Antivirus block	Ensure you have excluded the ENTIRE YunaMS folder within your antivirus program. If you have already done that, try removing the exclusions then adding it back. If you need help with how to do this, please visit our Discord thread here.
33	DBGHELP.dll is either not designed to run on Windows or it contains an error.	Architecture mismatch	This should only happen to specific users on Virtual Machines. Please reach out to the staff to obtain the correct DLL, including the system architecture that your VM uses.
34	Window is very small, or resolution changing	N/A	Right click YunaMS.exe>Properties>Compatibility>Change high DPI settings At the bottom, check the box "Override high DPI scaling behaviour. Scaling performed by:" and select "System". Click OK and restart the client.

---

If your issue was not addressed in this table, please join us on Discord and post your issue there.
If you don't use discord, please create a post HERE using THIS template.

Thank you!
Yuna