Welcome to the LargePageInjectorMods! This mod significantly enhances Stellaris's or other Games/Applications performance by optimizing its memory management.
Support for other games/application is highly expermimental and untested and may not work.
A memory allocator is a software component responsible for managing the allocation and deallocation of memory during a program's execution. Efficient memory allocation is crucial in games like Stellaris or Factorio, as it can lead to smoother performance. By using a more efficient allocator, such as the one introduced in this mod, the game's performance can be noticeably improved.
mimalloc, developed by Microsoft, is an advanced memory allocator that generally outperforms standard allocators in speed and memory fragmentation efficiency. By integrating mimalloc into Stellaris, Factorio or other Games/Applications through this mod, the game benefits from faster memory operations, enhancing overall performance. mimalloc GitHub
DLL (Dynamic Link Library) injection is a method used to run code within the address space of another process by forcing it to load a dynamic-link library. In the LargePageInjectorMods, we utilize DLL injection to seamlessly replace Stellaris's default memory allocator with mimalloc, without the need for modifications to the game's executable files.
The LargePageInjectorMods can provide a substantial performance boost (Performance only tested for Stellaris):
-
Standard Performance Increase: Small performance increase of 4-5%, could be completly negligible or significantly larger depending on circumstances.
-
Enhanced Performance with Large Pages: When enabled with Large Pages, the mod can deliver a 5-80%+ Performance Increase.
- Benchmak Result for Factorio with Ryzen 7800X3D:
- Without Large Page Injector Mods Factoriobox: 46 UPS
- With Large Page Injector Mods and Large Pages Factoriobox: 54 UPS
- Benchmak Result for Factorio with Ryzen 7800X3D:
-
Please note that the performance increase can varry dratically based on your save (Performanc increase should be bigger the later in the game you are and the heavier the save is), your hardware(generally there bigger performacne gains on weaker hardware), what mods your using and more. Your performance gains may me significantly smaller or larger then anything mentioned above. Somone with weaker hardware did report getting an 80% Performance increase so large gains are not impossible.
- Download the Mod: Download the ZIP file for your Game/Game version from Releases Page.
Disclaimer: Some Antivirus (including Windows Defender) may falsely detect Injector.exe to be maleware, this is a false positive caused becouse antiviruses see dll injection as suspious. You can read the source code and compile it yourself if you don't trust me. - Locate Game Executable Directory: Find the directory where Stellaris/Factorio/Whatever you want to try this on is installed (the same folder where
stellaris.exe,factorio.exeor the games executable in general is located). - Extract Files: Drag all the files from the downloaded ZIP file into the Stellaris installation folder. Click "Yes" to replace files if prompted.
- Stellaris Run the game normally, the included launcher-settings.json configures the paradox launcher to run the Injector which then runs the game. If succefull the game it will take a few extra seconds for the game to open and you will hear a short beep before the game opens to indicate success. Please not that you might need to replace the launcher-config.json file again if the game updates. Other Games Run Injector.exe instead of starting the game.
To enhance performance further by enabling Large Pages, follow these steps:
First, grant your Windows user the LockPagesInMemory privilege:
This privilege is necessary for enabling Large Pages and can be granted through the Local Security Policy editor (secpol):
- Press
Win + R, typesecpol.msc, and press Enter. - Navigate to
Security Settings->Local Policies->User Rights Assignment. - Find and double-click on "Lock pages in memory".
- Select "Add User or Group" and add your user account.
- Apply the changes and restart your computer to ensure the changes take effect.
For more detailed instructions, refer to the Microsoft documentation.
Set the MIMALLOC_RESERVE_HUGE_OS_PAGES variable in LargePageInjectormods.toml to 1 or higher (default is 8). This value represents the GB of Large Pages to reserve, ideally more than the RAM typically used by the Game/Application your trying to run.
- Less than 16GB of RAM: Large Pages may not be effective.
- 16GB of RAM: Do not set the environment variable higher than 4. It might require a PC restart and disabling unnecessary auto-starts to ensure enough continuous RAM.
- 32GB of RAM or more: Setting the variable to between 4 and 8 is recommended.
Note: Insufficient continuous RAM can lead to memory fragmentation issues.
This mod uses the following third-party libraries:
- Mimalloc: Mimalloc GitHub
- Sigmatch: Sigmatch GitHub
- EasyHook: EasyHook GitHub
- Hooking by Example (Not A Library but I copied some of the functions) Hooking By Example Github
- Toml11: Toml11 GitHub
- Mimalloc License: Mimalloc License
- Sigmatch License: Sigmatch License
- EasyHook License: EasyHook License
- Hooking by Example Licence: Hooking by Example Licence
- Toml11 Licence: Toml11 Licence
- Stellaris
- Factorio
This mod has been tested for the list but might also work for other games provided they are 64 bit native apllicatiions and use the same C Runtime Library. Reports/Suggestion on Games/Application you have succefully used this on, are welcome and I might add them to the supported list.
Please don't report any Issues related to unsupored application that don't work unless you have a pull requests that makes them work.
It should be compatible with all other mods for the supported games. If you encounter any compatibility issues, please report them in the "Issues" section of this GitHub page.
The configuration file must be named LargePageInjectorMods.toml. Sample configs are provided in the configs folder. To use a sample config, rename it to LargePageInjectorMods.toml. The config file must be in the same folder as Injector.exe and the game/application that gets launched.
# Path to the game/application executable to launch
LaunchPath = "stellaris.exe" # For Stellaris
# LaunchPath = "factorio.exe" # Uncomment for Factorio
# Modules (DLLs or EXEs) to patch with mimalloc
ModulesToPatch = [
"stellaris.exe", # The main executable
# Add other modules if needed
# "example.dll",
]
# Verbosity level (0-4)
Verbosity = 0 # 0 = Silent, 1 = Errors, 2 = Warnings, 3 = Info, 4 = Debug
# Redirect console output to Injector (true/false)
RedirectConsoleOutput = true # Set to true to enable
# Enable beep sound after injection (true/false)
EnableBeep = true # Set to false to disable
# Environment variables to set
[Environment]
#Amount of RAM in GB allocated to Large Pages set to 0 to disable huge pages
MIMALLOC_RESERVE_HUGE_OS_PAGES = "8"
#Various Mimalloc Env vars which may boost performance
MIMALLOC_ARENA_EAGER_COMMIT = "1"
MIMALLOC_PURGE_DELAY = "10000"
MIMALLOC_RESET_DELAY = "10000"Contributions to the LargePageInjectorMods are welcome! If you have suggestions for improvements or bug fixes, feel free to fork this repository and submit a pull request.
This project is licensed under the MIT License - see the LICENSE file for details.
- Thanks to the Stellaris and teams for their engaging games.
- Kudos to Microsoft for developing the
mimallocallocator. - Special thanks to the developers of Sigmatch and EasyHook for their contributions to the software community.
This mod is not officially endorsed by the creators of Stellaris. Use at your own risk.