# [UniversalUE4Unlocker](https://github.com/frostworx/steamtinkerlaunch/wiki/UniversalUE4Unlocker)

[UniversalUE4Unlocker](https://framedsc.github.io/GeneralGuides/universal_ue4_consoleunlocker.htm) is a mighty tool, which also (re-)enables the dev console in UE4 games
*(not limited to the [compatibility list](https://framedsc.github.io/GeneralGuides/universal_ue4_consoleunlocker.htm#games-that-work-with-the-unlocker))* and provides a nice configuration gui for changing/manipulation UE4 internal settings.

The gui requires [DotNet](https://github.com/frostworx/steamtinkerlaunch/wiki/DotNet), so isn't used currently - maybe later.

The tool ships a `UniversalUE4Unlocker.dll` though, which can be automatically injected per game via **steamtinkerlaunch** using [IGCSInjector](https://github.com/frostworx/steamtinkerlaunch/wiki/IGCSInjector)
by simply enabling `UUUSEIGCS` in [Game Menu](https://github.com/frostworx/steamtinkerlaunch/wiki/Game-Menu)
*(this automatically enables `USEIGCS`)*

⚠️  As `UniversalUE4Unlocker` doesn't allow direct downloads, the file needs to be manually downloaded from the [project page](https://framedsc.github.io/GeneralGuides/universal_ue4_consoleunlocker.htm#downloading-the-uuu)
and extracted to `$STLDLDIR/uuu` *(usually ~/.config/steamtinkerlaunch/downloads/uuu/)*

When a game ist started with enabled `UUUSEIGCS` and the `UniversalUE4Unlocker.dll` is missing, a requester is opened where the [project page](https://framedsc.github.io/GeneralGuides/universal_ue4_consoleunlocker.htm#downloading-the-uuu)
can be copy/pasted into a browser and the destination directory `$STLDLDIR/uuu` can be opened via `xdg-open`.
When done, click OK and the regular function will continue using the files.

For a list of possible options and tweaks, please check the project page directly.

By using the [UniversalUE4Unlocker](https://github.com/frostworx/steamtinkerlaunch/wiki/UniversalUE4Unlocker) in combination with [IGCSInjector](https://github.com/frostworx/steamtinkerlaunch/wiki/IGCSInjector)
it is possible to **inject [VR](https://github.com/frostworx/steamtinkerlaunch/wiki/Flat2VR) compatibility for several regular UE4 games!**

**steamtinkerlaunch** offers to prepare and execute an [UE4 patch script](https://github.com/frostworx/steamtinkerlaunch/wiki/UniversalUE4Unlocker#UE4-patch-script)
to auto-apply UE4 console commands inside a [UE4 console script](https://github.com/frostworx/steamtinkerlaunch/wiki/UniversalUE4Unlocker#UE4-console-script) into a game.
This can be enabled with the `UUUSEPATCH` checkbox in [Game Menu](https://github.com/frostworx/steamtinkerlaunch/wiki/Game-Menu)

# UE4 console script
A simple text file with several UE4 console commands.
**steamtinkerlaunch** uses the scriptname `steamtinkerlaunch-uuu-patch` for its auto functions.

UE4 regularly expects the script in the `*$GAMEEXENAME/Binaries/*` subdirectory of the game.
Depending on the resonance it might be possible to add a little console management to **steamtinkerlaunch** to automatically copy a selected script into the game dir.
*(VR specific patches are sourced differently - see [UE4-VR-console-script](https://github.com/frostworx/steamtinkerlaunch/wiki/Flat2VR#UE4-VR-console-script))*

When found, the source file will be copied automatically to make it available.
For easy editing it is listed automatically in the [Editor Menu](https://github.com/frostworx/steamtinkerlaunch/wiki/Editor-Menu) when available.
 

# UE4 patch script
A simple temporary bash script using xdotool, which, when enabled *(via `UUUSEPATCH`)* is autogenerated in `UUUPATCHCOMMAND` *("/dev/shm/steamtinkerlaunch/stl-uuu-patch.sh")* and automatically started.
When the additional variable `UUUPATCHWAIT` is set to 0, the patch script
will be placed behind the "Launch custom script" [Tray-Icon](https://github.com/frostworx/steamtinkerlaunch/wiki/Tray-Icon) entry, so it can be launched manually any time while in game.
If `UUUPATCHWAIT` is bigger, it will be executed automatically after another `UUUPATCHWAIT` seconds
after the game started and also be placed as 'Launch custom script' TrayIcon script, if the script does not exist yet or already is a VR patch command.
The script is only executed, when the game window id was detected successfully.