Skip to content

NotNite/GDWeave

Repository files navigation

GDWeave

GDWeave is a mod loader & runtime script patching for the Godot Engine.

Installation

Download the latest release and extract it to your game install. You should end up with a GDWeave folder and winmm.dll next to the game files.

You can also install from Thunderstore.

After GDWeave is installed, you can install/create some mods!

Troubleshooting/tips

  • Do not download GDWeave from the "Code" button on the GitHub page.
  • You can open the folder the game is installed into with Steam - right click > "Manage" > "Browse local files".
  • You may need to install .NET 8 manually, if the installer from GDWeave doesn't work. Pick the SDK for Windows x64.
  • Linux users will need to set WINEDLLOVERRIDES="winmm=n,b" %command% in their Steam launch arguments.

Supported versions

Currently, GDWeave only supports one version (for the game WEBFISHING), but support for more versions can be added.

  • GodotSteam 3.5.2

FAQ

How?

GDWeave uses a Rust proxy DLL to start a C# library in the target game's address space, then hooks functions in the Godot engine itself. It then parses the GDScript "bytecode" (really a syntax tree) and runs its own processors over it, rebuilding it in place.

Why not fork Godot?

Because compiling a modified engine for every Godot version isn't feasible, especially when game developers can use their own forks of Godot.

Credits

GDWeave's logo is U+1F9F5 "Spool of Thread" in Twemoji.