Change Log#

0.1.11 (29/04/2025)#

Added the pymhf.gui.decorators.gui_combobox decorator (partial work on #15).
Added the ability for mods to access each others’ attributes and methods. (#5). See [this page](inter_mod_functionality.md) for more details.
Fixed a few issues regarding running pyMHF. Thanks to @Foundit3923 for helping to figure out the issues.
Fixed an issue where hooks of imported functions which have _result_ as an argument work.
Added pymhf.core.hooking.NOOP decorator which indicates that the original game function shouldn’t be called. (#20)
Added a hex editor to the pyMHF gui. This is accessible from the “Hex Viewer” tab of the gui and allows real time viewing of data, following pointer values, and capturing memory snapshots. (#43).
Fixed an issue with loading hooks. Thanks to @cengelha for finding the bug.
Added “always on top” gui setting to the config. Thanks to @cengelha for adding it.
Fixed an issue with the debug mode toggle in the GUI. (#49).

Added pymhf.core.hooking.get_caller decorator for detours. When added, this will determine the location the function was called from. (#34). NOTE: This currently will only work properly for 64bit applications.
Added an pymhf.core.hooking.exported hook to allow hooking functions which are exported by the main exe.
Added the pymhf.core.calling.call_exported function which allows exported functions by the game to be called.
Added the ability to specify in the pymhf.core.hooking.imported decorator whether the detour time is "before" or "after".
Fixed an issue where hooks defined using the manual_hook decorator didn’t use the __pymhf_func_offsets__ etc. variables defined. (Thanks to @hashcatHitman for finding the bug.)
Made improvements to the shutting down of pyMHF so that when the process it is attached to exits, so does pyMHF.
Added a class decorator pymhf.utils.partial_struct.partial_struct which can be used to create ctypes.Structure types without needing to know the entire layout of the struct. See here for details.

Added cmd mode to the configuration to run commands in any registered libraries.
Added transparency slider and “always on top” options to the pymhf window.
Made a fix to manual hooks which were being declared with a pattern and name only.

Implement ability to call overloaded functions which have patterns.
Improve safety of hooking functions and keyboard bindings as well as GUI reload fix.
Added functions to set the main window active (#6) - Contributed by @Foundit3923

Add ability for GUI widgets to reload when their associated mod gets reloaded (#4)
Add extra_args option to GUI field type decorators (eg, FLOAT) which are passed through to DearPyGui (#8)
Fix issues with hooking multiple functions which are overloads of the same base function.
Add the ability for patterns to be hooked up using the FUNC_PATTERNS data in implementing libraries (#14)

Implemented manual hooks. These are a decorator which have the can take an offset, name, and function definition, and allow for hooking a function without having to rely on the underlying library which utilises pymhf.
Made changes so that libraries can be installed as plugins to pymhf so that they can be run like pymhf <libname>

Fixed issues loading applications which aren’t loaded with steam.
Fixed logging number of mods loaded.
Implemented custom triggers. They can be implemented by libraries which use this framework to enable custom triggers which are specific to the game/application.
Fixed some issues with reloading of mods when there are multiple mods all contributing to compound hooks, including hooks with completely disabled detours.
Added @no_gui decorator which can be applied to a Mod class to indicate that it doesn’t need to be shown in the GUI.

Initial release. Much of the functionality has been copied over from NMS.py which was how this project started.