Lua Mod Reloader for UE4SS

Description

Lua Mod Reloader for UE4SS is a small developer utility that lets you submit a reinstall request for one UE4SS Lua mod without restarting the game.

It is primarily intended for Lua mod developers and testers who want to apply changes in

main.luafaster and reduce full game restarts during iteration.

This utility was created and tested in Windrose and is designed to stay as universal as possible as long as the target mod is a standard UE4SS Lua mod and does not depend on game-specific reloader logic.

Tested configuration

• []Windrose [/]

  []Windows [/]

  []Steam version [/]

  []Unreal Engine 5. 6 [/]

  []UE4SS 3. 0. 1 Beta #0 [/]

  []Git SHA

  c2ac2464[/]

---

Installation instructions

• []Make sure UE4SS is already installed and working in your game. [/]

  []Extract the archive so the final structure looks like this: [/]

Mods/LuaModReloader/

├─ enabled.txt

├─ Scripts/

│  └─ main.lua

├─ README.md

└─ CHANGELOG.md

• []Start the game. [/]

  []Open the UE4SS / in-game console and use the commands listed below. [/]

---

Main features

• []Reload one selected UE4SS Lua mod [/]

  []Reload the last accepted mod name again [/]

  []Show current session status [/]

  []Show command help [/]

  []Write custom log markers for testing sessions [/]

  []Strict input validation [/]

  []No polling [/]

  []No timers [/]

  []No Tick hooks [/]

  []No world scanning [/]

  []No automatic file watching [/]

  []No mass reload of all mods [/]

---

Available commands

mod_reload <ModName>Submit a reinstall request for one Lua mod.

mod_reload FortLife

mod_reload "Fort Life"mod_reload_lastRepeat the last accepted mod name from the current Lua session.

mod_reload_statusShow:

• []mod name and version [/]

  []last accepted mod name [/]

  []number of submitted reload requests in this session [/]

  []number of written user marks [/]

  []last used command [/]

  []registered commands and alias [/]

  []reload limitations and console note [/]

mod_reload_helpShow a short help message and examples.

mod_reload_mark <Text>Write a custom visible marker to

mod_reload_mark Begin reload testExample log output:

Begin reload test

---

Compatibility alias

For backward compatibility, the following alias is also available:

ue4ss_reload <ModName>Main documentation and examples use the

mod_commands.

---

Important usage note

After submitting a reload request, close the in-game console so UE4SS can process its queue.

Do not repeat the command before the UE4SS result appears in the log, otherwise you may queue the same reload request more than once.

Typical successful sequence:

mod_reload FortLife

Request validated ............. OK

Submitted to UE4SS ............ OK

Reinstalling mod: FortLife

Mod 'FortLife' reinstalledImportant: this utility can confirm that the request was validated and submitted to UE4SS.

It does not claim that the reinstall has completed until UE4SS itself later prints its own result.

---

Requirements

• []A game with UE4SS already installed [/]

  []A target mod that is a UE4SS Lua mod [/]

  []The mod you want to reload must already exist and be installed through UE4SS [/]

---

Limitations

This tool supports UE4SS Lua mods only.

It does not reload:

• [].pak [/]

  [].utoc [/]

  [].ucas [/]

  []cooked Blueprint assets [/]

  []DLL mods [/]

  []the game itself [/]

Reloading a Lua mod does not guarantee a full rollback of its previous runtime state.

The following may remain:

• []actors created by the mod [/]

  []CDO changes [/]

  []modified game objects [/]

  []external files [/]

  []effects the mod does not clean up by itself [/]

  []badly managed background activity inside the target mod

This means the tool is best used for developer iteration, not as a