Skip to content

NotNite/GDWeave

Repository files navigation

GDWeave

Thunderstore downloads Build

GDWeave is a mod loader & runtime script patcher 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. Download it through GitHub or Thunderstore.
  • 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.
  • You may also need to install Microsoft Visual C++ 2015-2022 Redistributables.
  • Users of Proton / Steam Play (i.e. those who are on a Steam Deck, a Chromebook, or are otherwise running Steam for Linux) will need to set their Steam launch arguments to WINEDLLOVERRIDES="winmm=n,b" %command%.
  • If you're using Wine or Proton, and nothing appears when you attempt to start a game with GDWeave, try downloading this .gz file, extracting it, renaming the resulting .dll file to bcryptprimitives.dll, and then placing it next to the game files.

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.