Development Release

Geode development release for commit 994f8e0. Since this is not a regular release, Geode will not install the resources automatically, so you should use the installer if you want them.

Geode v4.9.0

This release adds the assets for Modtober 2025, alongside other cool features and fixes.

v4.9.0

• Add Modtober 2025 content (#1501)
• Add geode::cocos::getObjectName for getting demangled type names (c734b29)
• Add mod load priority, load mods in alphabetical order (#1492, #1500)
• Implement CCImage::saveToFile for macOS and iOS (#1496)
• Allow using SDK without GEODE_MOD_ID macro (useful for static libs) (a6f215f)
• Use OS APIs for file operations for improved performance and clearer error messages (ec46ad3)
• Fix crashlog window title and icons on Windows (d527c08, efdde0a)
• Fix custom settings not reloading dependants (#1488)
• Fix removeAllChildren UB (dd9446b)
• Fix Android gd::string causing double frees (#1490)
• Optimize pathToString conversion (2cd8559)
• ConstexprString can now be used as a template parameter (cf795fb)
• Add Self type on Modify to make referring to self type more idiomatic (945f6d5)
• Fix aligned_storage deprecation warnings when using C++23 (e7eed58)
• Fix CC_SYNTHESIZE calls and define inline getters/setters for cocos (869dcfa)
• EventV2 + async fixes (b3e6536)
• Improve the outdated GD version warning (#1475)
• Fix VMTHookManager (22ba7dd)

Geode v4.8.0

A mostly fix release that focuses on Unicode and paths. Also adds a way to do virtual table patching via the VMTHookManager class.

v4.8.0

• Fix geode::Notification z ordering (127733e)
• Add CCNode::getChildrenExt (d198df5)
• Add CCNode::getChildByIndex (0ba1f2a)
• Fix GEODE_MOD_STATIC_PATCH not using the geode namespace (#1456)
• Fix Linux install script flatpak directory (2cf1e57)
• Document return paths for dirs functions (d821172)
• Add VMTHookManager for hooking virtual functions that have not been defined by virtual table patching (383f8fd)
• Fix Unicode logging on Windows (c5e93b9)
• Remove all std::filesystem::path::string calls as they can crash on Unicode paths (#1473)
• Replace all A WinApi calls with W calls (#1473)
• Hook and patch toggling (#1468)
• Added option to force cURL to use IPv4 (#1412)

Geode v4.7.0

This release mostly includes minor additions and bugfixes. But for the nerdy, this adds support for Enterprise Certificates on iOS!

v4.7.0

• Change from copying queue to moving queue for main thread (9b8fb73)
• Add reading from unzipped/launch-args.txt on iOS as an option (ae90fc9)
• Add new "binary-dir" launcher flag for changing the path of mod binaries (0b71c3c)
• Use ColorProvider for SwelvyBG colors (01ee436)
• Deprecate the usage of geode::cast::as (9d28ab9)
• Return success for patching if there is nothing to do (f92e5b6)
• Updated TulipHook to 3.1.4 (f469696)
  • Fixes struct params and enabling after disabled.

Geode v4.6.3

The latest update may have tried fixing the crashlogs on Windows, but it unfortunately was not entirely successful in that. This update is supposed to fully fix the issue.

v4.6.3

• Fix Windows crashlogs not appearing (for real this time) (dedf1eb)

Geode v4.6.2

Another small bugfix for windows and ios!

v4.6.2

• Fix Windows crashlogs not appearing (02cee65)
• Unzip JIT-less iOS binaries separately from the .geode file (85fe11f)

Geode v4.6.1

Not a big update without rapid bugfixes! A small update that should fix a lot of crashes.

v4.6.1

• Fix several random crashes caused by incorrect relocation code in Tuliphook
• Make unzip upon download iOS only (0a6d09c)

Geode v4.6.0

Big update incoming! This update mainly adds support for JIT-less iOS and lots of internal TulipHook changes. Huge thanks to @FireMario211 and @altalk23! There might be bugs or crashes, so please let us know if you come across to them!

v4.6.0

• JIT-less iOS support! (#1395)
  • This means that Geode now supports iOS 26 beta and above
  • Follow instructions in the iOS launcher guide for setting up
  • Old mods compiled for iOS need to be recompiled to work with this version, but other platforms are unaffected
  • There are new additions to help with JIT-less specific hooking and patching
    • Geode's own Modify classes should work out of the box
    • You can check if the platform is JIT-less iOS by using the Loader::isPatchless function
    • For custom hooks, you can use the GEODE_MOD_STATIC_HOOK macro to add a hook. This hook can be enabled and disabled like normal.
    • For custom patches, you can use the GEODE_MOD_STATIC_PATCH macro to add a patch. This patch will be applied by the launcher and can not be disabled.
    • If you have any dynamic patches, you can not use them with JIT-less iOS
  • This is a pretty big update, so there might be some issues with it. Please report the issues you find.
• Major TulipHook update from 2.5.0 to 3.1.0 (#1395)
  • Adds debug logging behind the launcher flag enable-tulip-hook-logs
  • This update is a mainly internal one, but it is the most sensitive part of Geode
  • If you find any issues with it, please report them
• Unzip on mod download (#1390)
• Add Italian translation for the Windows installer (#1393)
• Add AndroidInputTimestampEvent (#1396)
• Fix keyUp when command key is pressed on MacOS (#1324)
• Don't create a popup when there are no mods to update (#1311)
• Add unzipped binary cleanup of unused platforms (#1377)
• Add API badge and tag for mod listing (#1389)
• Create Linux installer script (d38acee)
• Use FORCE_COLOR environment variable to force terminal colors (79761bf)
• Patch conditional variable on older Wine versions (53df4d3)
• Make ObjWrapper::getValue non-const (5c3afbd)
• Make Windows clipboard utilities unicode (82d8faf)
• Use custom certificate store for web requests on Windows (e0c1774)
• Add verbose curl logging (ec34df6)
• Add writeStringSafe that writes to a temporary file first (af806ba)
• Force unzip of mods on launch if the binary is missing (e4dd3e8)
• Fix rare unzip crash (86fd2c4)
• Fix PCH on iOS (0d972ab)
• Don't load importance superseded mods (2c5230e)
• Add some more documentation comments (9b27ddc)
• Fix LazySprite overloads and performace issues (0f53f38, 5394954)
• Error when trying to use m_fields in non-CCNode modify classes (0aed958)

Geode v4.5.0

Mostly bugfix release, but has some pretty important fixes and other useful additions!

v4.5.0

• Multipart form support for Geode web utilities (#1345)
• Use system certificate store for web requests on Windows, should fix some SSL issues (665a000)
• Fix windows file dialogs needing alt tab in full screen (f1a2b1b)
• Improve iOS stack traces in crashlogs, show the memory address that caused the crash (230ad79)
• Shorten DLL paths in Windows crashlogs, for DLLs that are from GD or mods (f6a5fb3)
• Add a geode::utils::string::pathToString method, which safely handles UTF-16 conversions on Windows (95eed22, 138d071)
• Fix base64 utilities not being exported and thus unusable by mods (dcd42df)
• Fix geode::utils::game::exit and restart not linking on all platforms except Windows (50c09b0)
• Fix Mod::getLaunchArgumentName not actually existing (#1356)
• Fix openFolder not working properly on MacOS (b1a8464)
• Fix LazySprite callback sometimes being called multiple times (d273ce6)
• Fix LazySprite sometimes invoking undefined behavior (6b5146a)
• Fix WeakRef leaking memory if a strong reference outlives all weak references (9587ce3)
• Add a way to cancel LazySprite loading (3a35321)
• Unify destructor fix across all platforms, replace a global map with a stack, fix Windows leaking references (#1350, b0f38ad)
• Add some logs to web utilities and improve error messages (c2caafc)
• Make AxisScaling::grow shrink to initial size if needed (0c80db6, c3b4e3d)
• Make the name of the mod being uninstalled yellow (9a6346a)
• Fix static notification queue object causing crashes when closing the game (#1340)
• Fix compile issues with gd::vector on Android (#1351)
• Use Clang 19 for windows builds (#1346)
• Additional CCRenderTexture members (#1352)
• Make property macros public (#1364)

Geode v4.4.0

This release came out much bigger than expected! Huge thanks to @RoootTheFox, @FireMario211 and the rest of the team involved on the iOS support. Note that iOS support is still experimental, expect a proper release soon.

v4.4.0

• Experimental support for iOS! (#1275, #1280, #1282, and a lot more other commits...)
• Use MDPopup for mod setting descriptions (#1286)
• Add a new filter that shows enabled mods before disabled ones on the install page (#1315)
• Save filters from InstalledModListSource to disk (#1315)
• Fix a vanilla crash that could happen with large save files on Android (#1270)
• Fix a vanilla MacOS crash that could happen on game close (#1304, 7b877db, eb043db, 75c8efa, 8982011, 8bd735a)
• Fix a rare crash that could happen when searching for mods (eb874ad)
• Fix a small visual bug that happened when viewing mod problems (967b6ad)
• Fix some file access related crashes that could happen when loading mods (27ca8b6)
• Fix a small visual bug in ModDeveloperList (#1303, #1319)
• Fix link buttons not being disabled when needed in ModPopup (#1303)
• Print more useful information in Windows crashlogs when an access violation happens (c3d2b4e)
• Fix small issues with installer spanish translation (#1254)
• Optimize ModsLayer a lot (#1296, #1321, 427e0b0, eb874ad)
• Remove Modtober tab (#1299)
• Add geode::dirs::getResourcesDir() and {gd_resources_dir} setting variable (#1285)
• Add geode::globalListen() and EventListener operator= move (#1218)
• Add base64 utils (#1307)
• Make geode::utils::web::openLinkInBrowser open the system webview on Android (#1295)
• Add API to change log level per mod (#1305)
• Add safe area API for Android and iOS node placement (#1284)
• Add unicode conversion utils (#1310)
• Add missing SimpleAxisLayout getters (#1314)
• Add format_as for all SeedValue classes (#1316)
• Add LazySprite class, which handles image loading in a separate thread as much as possible (#1320)
• Add gd::pair for non-Android platforms (#1322)
• Add optional saving for geode::utils::game::exit and geode::utils::game::restart (061c335)
• Add members for CCParticleSystem (#1273)
• Add gnustl vector and map, alongside other dependencies (#1255)
• Make gd::pair constructible from std::pair (b444247)
• Fix some geode::stl iterator conversions (e64ab20)
• Expose BreakLine class (#1309)
• Correctly check image size in MacOS crashlogs (#1274)
• Fix a MacOS crash related to extra keys added by Geode (f7d44f3)
• Fix memory leaks in CCImage usage (f38fe30)
• Fix CCSprite members (#1308)
• Update minimum CMake version to 3.21 (023274b)
• Let our libcurl use the native system CA, alongside our bundle (#1301)
• Fix gnustl set functions returning wrong type (ac1de8a)
• Fix SimpleAxisLayout scaling not working properly in some cases (22f01bb)
• Fix SimpleAxisLayout offset gaps in BackToFront disrection (f4deccd)
• Fix TextArea not handling scale properly on touches (#1313)
• Fix undefined behaviour in path handling on file utils
• Rename 2.207 to 2.2070 in the timestamp map (79ba633)
• Update TulipHook to 2.4.4

Contributors

@RoootTheFox @FireMario211 @hiimjasmine00 @Alphalaneous @Prevter @0x5abe