UnityRef is currently in early development. Some features may be incomplete and/or not functioning.

UNITYREF

Your Pit Stop For Solving ANYTHING in Unity

editor

[HotReload] Fix Error 131 and Project Path Encoding Failures

Solution

editor scriptingeditorhotreloaddevelopment workflow

Unity 2021.3.x - Unity 6.3.x

Published 7 days ago

Issue

 The Hot Reload feature fails to apply code changes within the Unity Editor, remaining stuck on a "Starting Hot Reload" status while the server reports readiness. The Console logs an error regarding the inability to update SingularityGroup.HotReload.RuntimeDependencies2022.dll, accompanied by error code 131.

Hot Reload functionality failing to apply code changes is typically resolved by ensuring the project path contains only standard ASCII characters.

Explanation

This failure is primarily caused by non-standard characters, specifically full-width characters, within your project path. Such characters interfere with file system operations performed by tools like Hot Reload, preventing Assembly updates. This behavior is often seen when your project path includes international characters that are not part of the standard ASCII set.

  1. Close the Unity Editor and any associated background processes.
  2. Locate your project folder and identify any non-ASCII characters in its absolute path.
  3. Move the project to a directory path composed solely of conventional English letters, numbers, and allowed symbols like hyphens or underscores.
  4. Re-open the project from the new path and re-enable Hot Reload.

Additional Tips

  • On macOS, ensure Unity Hub and Unity have Full Disk Access in the system Privacy & Security settings.
  • Check that the Library folder permissions are not restricted, as this can block the Hot Reload server from writing new DLL files.

Related Posts Haven't quite found a solution to your problem? We think these posts might help you.

Content inspired by a Unity discussion post.