Add Register DTMM as handler for Nexus downloads

Lucas Schwiderski 2023-11-24 15:04:10 +01:00
parent 9a2565f871
commit fe8bd52087

@ -0,0 +1,42 @@
Nexusmods uses a custom link style (i.e. a custom URI) to connect the "Mod Manager Download" button in the browser with the application running on your machine.
The connection between those two, and the way for a user to select the application (e.g. Vortex, MO2, DTMM) is through a so-called "URI handler".
In Windows, these are stored in the Registry. Usually, the typical "setup.exe" installers will create them for you, but DTMM isn't quite there yet, so for now, you will have to do it with a script or manually.
See [learn.microsoft.com](https://learn.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-developer/platform-apis/aa767914(v=vs.85)?redirectedfrom=MSDN#app_reg) for official details how this works.
**The recommended approach is to set up NXM Proxy from https://www.nexusmods.com/site/mods/288**.
## NXM Proxy
Usually, only one application can be registered as URI handler, regardless of the game. The purpose of NXM Proxy is to check the game and forward these URIs to different applications.
1. Install NXM Proxy for Vortex from https://www.nexusmods.com/site/mods/288 and make sure its enabled.
2. Add DTMM as a new manager for NXM Proxy. The command line should look somewhat like `"C:\path\to\dtmm.exe" %1` (adjust the path as necessary).
3. Select `Darktide` in the list of games, and map DTMM as its manager
## Script
1. Copy the following content into _Notepad_ or a similar text editor
2. Adjust the paths to point to where you saved `dtmm.exe`
3. Save the file as `dtmm_uri_handler.reg` (make sure to set the file type to "All files (*.*)").
4. Double-click the file
```reg
Windows Registry Editor Version 5.00
[HKEY_CLASSES_ROOT\nxm]
"URL Protocol"=""
@="URL:Nexusmods Mod Manager"
"DefaultIcon"="\"C:\\path\\to\\dtmm.exe\",1"
[HKEY_CLASSES_ROOT\nxm\shell]
[HKEY_CLASSES_ROOT\nxm\shell\open]
[HKEY_CLASSES_ROOT\nxm\shell\open\command]
@="\"C:\\path\\to\\dtmm.exe\" \"%1\""
```
## Manual
Open `regedit.exe` and perform the steps described in the script above.