Merge pull request #105 from TitleOS/master

Added LaunchArguments to XEO3, and additional dotnet versions.

docs/development/installing-compatible-software.md

@@ -115,6 +115,22 @@ Profit!
   :---- | :----
   The system cannot find the file specified | If running your dotnetcore software on an external drive, move it to an internal one such as D: or T:
 
+  ## .NET 8
+
+  - Download the latest preview Windows 64 bit dotnet **runtime** from
+    https://dotnet.microsoft.com/download/dotnet/8.0.
+  - Unzip and copy the binaries to a flash drive or a location of your choice such as
+    D:\\DevelopmentFiles\\Dotnet.
+  - Optionally add the dotnet directory to your system PATH via `setx
+    path "%path%;D:\\DotnetPath"` using SSH.
+  - Execute your dotnet software via "dotnet program.exe" using SSH
+    in the dotnet diectory (or anywhere if you updated your PATH).
+  - Profit
+### Troubleshooting
+  Error | Solution
+  :---- | :----
+  The system cannot find the file specified | If running your dotnetcore software on an external drive, move it to an internal one such as D: or T:
+
 
 ## Java Development Kit
 

docs/games/xeo3-x360-classic-xbox-emulator.md

@@ -20,12 +20,17 @@ XEO3 is the Xbox 360 and Original Xbox emulator executable for the Xbox One/Seri
 | `-kernel filename` | Specify host path to the guest kernel binary    | -kernel D:\xboxkrnlce.exe|
 | `-hvdata filename` | Specify host path to the guest hypervisor data blob | -hvdata D:\xboxkrnlce.hvdata |
 
+## LaunchArguments.txt
+Additional arguments can be passed to XEO3 via a text file placed next to emu.exe, named LaunchArguments.txt. One X and Series consoles can take advantage of additional arguments (Mainly graphical improvements like Auto HDR) via a similar file named ScorpioLaunchArguments.txt, reflecting the One X's codename. These arguments appear to have to include the media ID and title ID of the 360 game. Halo Reach (Xbox 360 Backwards Compat) for example, has a launcharguments.txt containing the following arguments:
+```
+?disableAudioOnConstrained&insecureUtilityDrive&mediaId=96abdab3-1852-4046-8020-af38b985010f&titleId=4D53085B&shaderCompilerLegacyTexValuePatch&forceDurangoGammaRamp
+```
+
 ## Notes
 * xboxkrnlce.exe and .hvdata can be found in the Flash folder of a Backwards Compat game's XVC. Version 17003 has leaked publicly.
 * The emulated Xbox 360 does not display a serial number.
 * If a BC Game is deployed in Dev Mode, the XDK's Xbox Console Manager (The GDK dropped this functionality) can be used to capture kernel debug logging from the emulated kernel, when launching the game from the Console Manager.
 
-
 ## Discovery
 XEO3, known as emu.exe, was first located by TitleOS, who dumped it from a plaintext XVDP of eratools captured from a Xbox Live update before releasing it via Twitter.
 
@@ -35,3 +40,6 @@ Little is currently known about the XEO3 shader format, for example how the orig
 These shaders appear critical to running any graphical xex, as evidenced by attempting to run [XeXMenu on the emulator](https://web.archive.org/web/20210414133418/https://twitter.com/XB1_HexDecimal/status/1382326180490010630). 
 
 Example: `xeo3_3bfc9c1a_932fc286_956f016e_98ef8821_6b9d46d0.dll` (From CastleCrashers)
+
+### BackgroundShaderCompiler
+Dumps of Xbox 360 Backwards Compat games (Obtained via [Durango Dumplings](https://xboxoneresearch.github.io/games/2024/05/15/xbox-dump-games.html)) contain a runtime shader (re)compiler executable called BackgroundShaderCompiler.exe. This would appear to be the reason not all BC games shipped with precompiled xeo3 DLL shaders.