Edit Infobox Switch Homebrews: UnrealNX Switch

Free text:

This is a Switch port/loader for Unreal and Unreal Gold. It loads the aarch64-linux binaries supplied with the 227j patch for Unreal/Unreal Gold, patches them and runs them, similar in function to the Max Payne Mobile loader. Currently pretty unstable as exception handling is broken, meaning any non-fatal error will cause a crash. ==Installation== You will need an Unreal or Unreal Gold installation patched with the [https://www.oldunreal.com/phpBB3/viewtopic.php?f=51&t=10395 OldUnreal 227j patch]. Unfortunately oldunreal.com seems to disallow direct linking to files, so click the link at the bottom of that post to get it. Ensure that the patch is installed correctly: when installing make sure to tick every box, but only tick "Return to Na Pali support" if you have Unreal Gold. If you don't have a folder called <code>SystemARM</code> in the Unreal folder, you need to reinstall the patch. Simply run the installer again to do that. How to install: *Create a folder called <code>unreal</code> in the <code>switch</code> folder on your SD card. *Copy the contents of your <code>Unreal</code> or <code>UnrealGold</code> folder into <code>/switch/unreal/</code>. *Extract the contents of the <code>.zip</code> file from the latest release into <code>/switch/unreal/</code>. Replace everything. The game will show an error message if it detects that anything is wrong. It will also output error messages to <code>SystemARM/fatal.log</code> and <code>SystemARM/UnrealLinux.log</code>. Please read those and check the relevant parts of your setup. If the error says <code>Could not patch ...</code> or <code>Could not load *.so</code>, that likely means you have the wrong Unreal version. You need 227j specifically. ==User guide== ===Notes=== *This will only work with Unreal/UnrealGold 227j right now. If 227k is released, the loader will most likely have to be updated to support it. *This will likely not work in applet/album mode. Use a proper game override. *You can bring up the on-screen keyboard by pressing Minus at any time. ===Settings=== *The performance is subpar, mostly because of the dynamic lights. You can disable dynamic lights to get a performance increase at the cost of all the pretty lighting effects in the game (including your flares and flashlight and any time a light turns on or off). To do that, in <code>SystemARM/UnrealLinux.ini</code> look for <code>NoDynamicLights</code> and set it to <code>True</code>. *You can also disable volumetric lights to get a small performance increase in some areas with less of an impact on visuals. To do that, in <code>SystemARM/UnrealLinux.ini</code> look for all instances of <code>VolumetricLighting</code> and set them to <code>False</code>. There might be other config parameters that affect performance, but I haven't explored that much yet. *You can enable the advanced XOpenGL renderer, though it hasn't been tested much, does not seem to improve performance and will probably explode. To do that, in <code>SystemARM/UnrealLinux.ini</code> change <code>GameRenderDevice=OpenGLDrv.OpenGLRenderDevice</code> to <code>GameRenderDevice=XOpenGLDrv.XOpenGLRenderDevice</code>. *Joystick sensitivity can be adjusted for each axis individually in the SystemARM/User.ini file. Search for for SpeedBase and edit the number for each axis to your liking. ===Troubleshoot=== *Trying to join a multiplayer game or opening the server browser will likely cause the game to crash. Hosting a multiplayer game or playing Botmatch seems to work, though. *Exiting and relaunching the game will cause it to crash. Quit out of hbmenu after exiting the game to avoid that. *If you see any <code>appThrowf</code> errors, first try to re-extract the .zip file again, replacing everything. *Return to Na Pali may crash on new game with an error about UPakFonts. To fix that get the original 3 MB <code>UPakFonts.utx</code> file from the <code>Textures</code> folder on your Unreal Gold CD or unpatched Unreal Gold install and replace the one in <code>/switch/unreal/Textures</code>. ==Screenshots== https://dlhb.gamebrew.org/switchhomebrews/unrealnx2.png https://dlhb.gamebrew.org/switchhomebrews/unrealnx3.png https://dlhb.gamebrew.org/switchhomebrews/unrealnx4.png ==Known issues== *The game can crash on any non-fatal error, such as missing textures for a map, and is probably generally unstable. *The performance sucks, mostly because of the dynamic lights. See the README for some potentially performance-increasing options. *Multiplayer does not work properly and will most likely just crash, except for Botmatch. ==Changelog== '''r2''' * Fixed crash when saving the game anywhere except Vortex2. * Perhaps made the game a bit more stable. '''r1''' *Initial release. ==Credits== *OldUnreal for the 227j patch. *Switchbrew for libnx. *devkitPro for devkitA64. == External links == * GitHub - https://github.com/fgsfdsfgs/unreal_nx * GBAtemp - https://gbatemp.net/threads/unreal-and-unreal-gold-port-loader.623728/