About this mod
Quality of life and cheating mod. Player, Handy Gnat and Zipline speed. hauling and storage capacity, stack size in inventory, max mutations, perfect block, max production items, build anywhere, infinite item power, AoE pickup, proximity inventory storage radius, etc.
- Requirements
- Permissions and credits
- Changelogs
- Donations
See: https://www.nexusmods.com/grounded/articles/10
⚠️ If you get a "black screen" when loading a save (this is a very common bug!), restart the game. ⚠️
This is an issue caused by UE4SS, I can't fix it.
Does this mod work with the latest Grounded version (August 2024)?
Short answer: partially.
This mod requires UE4SS to work, but UE4SS seems to be unstable with the latest Grounded update.
Try the latest UE4SS experimental version: https://github.com/UE4SS-RE/RE-UE4SS/releases/tag/experimental-latest
This mod is a fork of the Configurable QoL mod by TheLich https://www.nexusmods.com/grounded/mods/82
From version 1.2.0, I merged the QoL mod by TheLich with my mod.
Things you can configure







- Player interactions timer max.
- Cancel all under construction buildings (CTRL+DEL).
- Build anywhere (CTRL+NUM5). Partially works with some buildings.
- Pause/unpause the game (PAUSE key).
- Max production items (total capacity) in oven, grinder, cookery, spinning wheel and glue masher.
- And more...
Installation
UE4SS v3 experimental (for the latest versions of the mod)
You need to install an experimental release. In the "Assets" section, download the file with a name like this: UE4SS_v3.0.1-394-g437a8ff.zip.
Steam - Unpack UE4SS archive into (GameInstallDir)\Maine\Binaries\Win64
Windows Store/Xbox Pass (untested version) - Unpack UE4SS archive into (GameInstallDir)\Maine\Binaries\WinGDK
Delete xinput1_3.dll or xinput1_4.dll from an older UE4SS version.
More information: https://docs.ue4ss.com/dev/installation-guide.html (Official Installation Guide)
If the game crashes on startup (optional):
- In the ue4ss/mods/ folder edit the mods.txt file and modify BPModLoaderMod : 1 to BPModLoaderMod : 0
- In the ue4ss/ folder edit the UE4SS-settings.ini file and modify bUseUObjectArrayCache = true to bUseUObjectArrayCache = false
Mod
Download and install RE-UE4SS (see above).
Since UE4SS v1.3.6: Mods that have 'enabled.txt' present in their mod directory are now always loaded regardless of their state in mods.txt. So, you don't need to have a "mods.txt" file if there is an "enabled.txt" file in the mod directory.
Steam - Unpack mod archive into (GameInstallDir)\Maine\Binaries\Win64
Windows Store/Xbox Pass - Unpack mod archive into (GameInstallDir)\Maine\Binaries\WinGDK
Example for Steam with UE4SS v3 (experimental)
(GameInstallDir)\
├─ Maine\
│ ├─ Binaries\
│ │ ├─ Win64\
│ │ │ ├─ UE4SS\
│ │ │ │ ├─ Mods\
│ │ │ │ │ ├─ oraxQoLMod\
│ │ │ │ │ │ ├─ Scripts\
│ │ │ │ │ │ │ ├─ helper.lua
│ │ │ │ │ │ │ ├─ main.lua
│ │ │ │ │ │ ├─ enabled.txt
│ │ │ │ │ │ ├─ options.txt
│ │ │ │ ├─ UE4SS.log
│ │ │ │ ├─ UE4SS-settings.ini
│ │ │ │ ├─ dwmapi.dll
Example for Windows Store/Xbox Pass with UE4SS v3 (experimental)
(GameInstallDir)\
├─ Grounded
│ ├─ Content
│ │ ├─ Maine\
│ │ │ ├─ Binaries\
│ │ │ │ ├─ UE4SS\
│ │ │ │ │ ├─ Mods\
│ │ │ │ │ │ ├─ oraxQoLMod\
│ │ │ │ │ │ │ ├─ Scripts\
│ │ │ │ │ │ │ │ ├─ helper.lua
│ │ │ │ │ │ │ │ ├─ main.lua
│ │ │ │ │ │ │ ├─ enabled.txt
│ │ │ │ │ │ │ ├─ options.txt
│ │ │ │ │ ├─ UE4SS.log
│ │ │ │ │ ├─ UE4SS-settings.ini
│ │ │ │ │ ├─ dwmapi.dll
Configuration
Mod configuration file: \Mods\oraxQoLMod\options.txt
It's a Lua file. It's similar to the configuration file from "Configurable QoL mod" by TheLich. You can open it with any text editor (Notepad, for example).
Everything after -- (two hyphens/dashes) is ignored (it's a commentary), so if you want to turn off any option, just put -- in the beginning of the line.
Example:
InteractTimerMax = 0.3 -- this is a commentary
-- CancelInteractTimerMax = 0.3
The line "-- CancelInteractTimerMax = 0.3" will be ignored because there is a double hyphen (dash) at the beginning.
Tips
- Hot reload the mod
You can either (see Applying code changes):- reload all mods from the UE4SS GUI Console with the "Restart All Mods" button on the "Console" tab, or,- enable "Hot reload" in UE4SS-settings.ini and use the assigned hotkey (Ctrl+R by default) to do the same.You can then reload the mod to quickly test your changes (in options.txt) without needing to restart the game.⚠ However, when you reload the mod, some functionality may not work properly.So if something doesn't work properly after reloading the mod, open the game menu and reload a save. - Log file
Log file is UE4SS.log, but you can enable the external UE4SS debug console in the UE4SS settings (UE4SS-settings.ini) in the [Debug] section.
Troubleshooting
- Log file
You can check tho log file at (GameInstallDir)\Grounded\Maine\Binaries\Win64\UE4SS\UE4SS.log (for the Steam version). At the end of the file, you should see something like this:[2023-07-29 00:06:12] Starting mod 'oraxQoLMod'
If you don't see these lines, the mod is probably not loaded. If the log file UE4SS.log is not created when you launch the game, then UE4SS may not be installed.
[2023-07-29 00:06:12] [Lua] oraxQoLMod init - Game version (Windows Store/Xbox Pass)
I use the mod on a Steam version of the game. I don't know if it work correctly on the "Windows Store/Xbox Pass" version. - If the game crashes on startup
- In the ue4ss/mods/ folder edit the mods.txt file and modifyBPModLoaderMod : 1toBPModLoaderMod : 0- In the ue4ss/ folder edit the UE4SS-settings.ini file and modifybUseUObjectArrayCache = truetobUseUObjectArrayCache = false - Mod restart/reload
When you reload the mod with "UE4SS Debugging Tools" (or with CTRL+R when "Hot reload" is enabled), some functionality may not work properly. So if something doesn't work after reloading the mod, open the game menu and reload a save.
Miscellaneous files
- LootDropTable
Mod to edit the loot/drop table. - oraxMiscMod
Remove the Wendell marker on the HUD (at the endgame).
Known issues
- StorageRadius
A very high number to "StorageRadius" does not work as expected. It seems there is a limit.
Resources for modders
https://docs.google.com/spreadsheets/d/1jq5xZXhddalPsDQNVu2biGKSUFPqu3n3TrS40l3gf-g/edit?usp=sharing
File Paths https://docs.google.com/spreadsheets/d/1gU15CK14L0bkgtqyMcRmShArKjynI1gO/edit?usp=sharing
FModel - https://fmodel.app/
Unreal Engine Modding Discord - https://discord.gg/zVvsE9mEEa
Grounded Modding Discord - https://discord.gg/Rtfn5FE
Lua scripting system RE-UE4SS - https://github.com/UE4SS-RE/RE-UE4SS
Credits
Some code of my mod come from Configurable QoL mod by TheLich - https://www.nexusmods.com/grounded/mods/82
Grounded Cheat Engine Table - https://www.nexusmods.com/grounded/mods/65
ASCII Tree Generator - https://ascii-tree-generator.com/
Font - dafont.com/musicals.font