ReLinker

[Ganda]

ReLinker

Hishy had the idea of making a little tool to allow us to merge mods with scripts - it takes the merge maps that are produced when you merge something, grabs all the scripts and LODGen files from you active mod list (BSAs included) and replaces the old plugin name and formIDs with the new plugin name and formIDs.

We all know what a fantastic tool Merge Plugins is. However there are certain mods which cannot be merged due to the use of certain scripting functions which are called on the original plugin name. Functions including GetFormFromFile, GetModByName, checkModPresence, and IsPluginLoaded look for specific .esp names. When you create a merge the original .esp name(s) no longer exists (unless you rename the merged plugin back to one of the original plugin names but this in itself can cause problems including broken MCM menus and is therefore not ideal) and therefore any function call looking for them will no longer trigger. These functions can be called by one of the scripts included in the mod being merged, or by scripts from other mods outside the merge.

A prime example of this is how the 'self-patching' in Legacy of the Dragonborn works by looking for the existence of a whole host of plugin names and activating the various additional displays if the mods are loaded. ReLinker actually came about out of a conversation regarding merging the four BadGremlins treasure hunt mods and patching the LotD activator script to make sure all four displays were still activated.

ReLinker is run outside ModOrganizer and runs on whichever profile you last had open before closing out of MO. It scans your load order looking for merges, and for every merge it finds it reads the contents of plugins and map .txt files and creates a reference list of the original plugin names and the new merged plugin name, along with the original and renumbered FormIDs. It then scans every script in your load order looking for any of those functions mentioned above and editing the scripts to reflect the new plugin names and formIDs. So in the example above once we've merged all four treasure hunts into Treasure Hunts.esp and run ReLinker, the DBM script will now look for Treasure Hunts.esp four times and activate all four displays. Likewise if you were to merge a mod like Sneak Tools whose scripts contain numerous Sneak Tools.esp lookups, ReLinker would then edit all of the Sneak Tools scripts in the merge itself to ensure they now look for the new merged plugin name and renumbered formIDs instead.

ReLinker works on both loose files (if you unpack your BSAs) and on scripts within BSAs. It directly edits the .pex files, doing away with the need to decompile and recompile the scripts which has greatly sped up the process over in the release version.

Instructions:

1. Make sure you have the profile you want to ReLink active in Mod Organizer and that you have completed and activated all of your merges.
2. Exit Mod Organizer
3. Run ReLinker and follow the on screen instructions to specify the required paths.
4. Check on screen output to ensure ReLinker has completed successfully.
5. Close the ReLinker window and open Mod Organizer.
6. Scroll to the bottom of the left pane and locate the new ReLinker Output mod.
7. Activate ReLinker Output and leave it at the bottom of the left pane to ensure the new ReLinked scripts have priority over the originals.
8. That's it, there is no 8

If you add/remove/update any mods or create any new merges and want to ReLink again then simply remove the existing ReLinker Output mod completely, exit MO and repeat the process again.

Prerequisites:

• Mod Organizer - does not work with other managers;
• Do not remove the merge folder after completing a merge.

Download it here. The tool will ask you for some things and will try to guess them properly. If the values between square brackets are correct, simply press ENTER without inputting any value. The output scripts and LODGen files will be stored in a new mod folder named "ReLinker Output". To revert the changes from this tool simply disable or delete the folder.
 
Good Practices:

• ReLinker will run with the latest profile used in MO;
• Close MO before running it.

By default, the following BSA's are ignored to speed up the process and because they don't contain any scripts with the functions that are affected:

• Skyrim - Misc.bsa
• Skyrim - Shaders.bsa
• Skyrim - Textures.bsa
• Skyrim - Interface.bsa
• Skyrim - Animations.bsa
• Skyrim - Meshes.bsa
• Skyrim - Sounds.bsa
• Skyrim - Voices.bsa
• Skyrim - VoicesExtra.bsa
• Update.bsa
• Dawnguard.bsa
• HearthFires.bsa
• Dragonborn.bsa
• HighResTexturePack01.bsa
• HighResTexturePack02.bsa
• HighResTexturePack03.bsa
• Unofficial Skyrim Legendary Edition Patch.bsa
• Falskaar.bsa
• Wyrmstooth.bsa

If you have specific issues or suggestions post it directly to the this topic. I'm always happy to receive questions and feedback. Happy merging!

 

EDIT: Thanks dunc for the much better description!

Edited February 20, 2017 by hishutup

[Ganda]

The actual error would help :p If nothing else, I'd know which line it died on

[LordOfLA]

Apply merge maps.
          Applying merge maps: [#-------------------------------------------------] 2.1% Done  File "<string>", line 340, in <module>
  File "c:\miniconda-x64\envs\relinker\lib\encodings\cp1252.py", line 15, in decode

<class 'UnicodeDecodeError'>: 'charmap' codec can't decode byte 0x81 in position 2: character maps to <undefined>

There we go.

[Ganda]

uggghhhhhhhhhhhh it's a codec error, thought these were fixed already <. try data-ipb="nomediaparse" href="https://a.uguu.se/rcN63c8IWKuG_Relinker.7z">this one, maybe pex uses utf-8 first 

[LordOfLA]

Worked.

[Ganda]

Awesome, I'll push it in a bit

[reddvilzz]

Hi Ganda, My skyrim keep crashing before the main menu showed up after I run ReLinker, I can confirm disabling ReLinker on left pane loads the main menu just fine.

Here is the script in ReLinker

 

https://imgur.com/a/Ew8m6

 

and the crashFix log keep showing this

 

 

02 Nov 23:54:29 Game has crashed with exception address 0xF5E8CB!

 

02 Nov 23:56:29 Game has crashed with exception address 0xF5E8CB!

 

02 Nov 23:58:34 Game has crashed with exception address 0xF5E8CB!

 

03 Nov 00:01:19 Game has crashed with exception address 0xF5E8CB!

 

03 Nov 00:03:18 Game has crashed with exception address 0xF5E8CB!

 

03 Nov 00:03:43 Game has crashed with exception address 0xF5E8CB!

 

03 Nov 00:05:32 Game has crashed with exception address 0xF5E8CB!

 

My load order is in my signature if that's needed, it is up to date.

Edited November 2, 2016 by reddvilzz

[Ganda]

 

Hi Ganda, My skyrim keep crashing before the main menu showed up after I run ReLinker, I can confirm disabling ReLinker on left pane loads the main menu just fine.

Here is the script in ReLinker

 

https://imgur.com/a/Ew8m6

 

and the crashFix log keep showing this

 

 

02 Nov 23:54:29 Game has crashed with exception address 0xF5E8CB!

 

02 Nov 23:56:29 Game has crashed with exception address 0xF5E8CB!

 

02 Nov 23:58:34 Game has crashed with exception address 0xF5E8CB!

 

03 Nov 00:01:19 Game has crashed with exception address 0xF5E8CB!

 

03 Nov 00:03:18 Game has crashed with exception address 0xF5E8CB!

 

03 Nov 00:03:43 Game has crashed with exception address 0xF5E8CB!

 

03 Nov 00:05:32 Game has crashed with exception address 0xF5E8CB!

 

My load order is in my signature if that's needed, it is up to date.

 

Since relinker produces no errors I'll need both the original pex and the relinker output pex (and if you could decompile both and also send me that I'd really appreciate it :D)

[reddvilzz]

What program do you recommend to decompile it?

I tried using Champollion and it can gave me psc and pas files, is this correct?

[Ganda]

What program do you recommend to decompile it?

I tried using Champollion and it can gave me psc and pas files, is this correct?

yup, that's good, send me the 4 files :)

[reddvilzz]

There are 2 scripts that failed to be decompiled mintymcmpatchquestscript.pex and IHOUtil.pex.

 

 

ERROR: Undecompiled\IHOUtil.pex : Invalid opcode0"

ERROR: Undecompiled\mintymcmpatchquestscript.pex : Invalid opcode0"

 

Here is the Decompiled files I hope I get it right

Edited November 3, 2016 by reddvilzz

[reddvilzz]

For some reason if I remove the error scripts the game loads, the weird thing when I decompiled both the original and the ReLinker output it will ended up with the same error. But when I removed the one from ReLinker output it works.

[hishutup]

 

There are 2 scripts that failed to be decompiled mintymcmpatchquestscript.pex and IHOUtil.pex.

 

 

ERROR: Undecompiled\IHOUtil.pex : Invalid opcode0"

ERROR: Undecompiled\mintymcmpatchquestscript.pex : Invalid opcode0"

 

Here is the Decompiled files I hope I get it right

 

I need the ones that threw the error. You don't need to decompile them.

Please send the original and the relinker versions. 

 

EDIT: to be honest I expected minty to break because someone decided using several symbols was a great name which conflict in various encodings.

[dunc001]

Weird that the minty script is causing an issue for red though, it's been in one of my merges an ReLinked ever since the beta tests and I've never had an issue with it.

[reddvilzz]

I need the ones that threw the error. You don't need to decompile them.

Please send the original and the relinker versions.

 

EDIT: to be honest I expected minty to break because someone decided using several symbols was a great name which conflict in various encodings.

I've deleted the scripts from ReLinker I'll upload it out when I run Relinker again and having the same problem. For now I'm nuking my modlist again because of the stutter and trying to lower the texture mods

[reddvilzz]

So here you go Hishy the problematic scripts from Minty Lighting, again new load order just ran relinker and the game CTD at start, hide the script and no CTD.

 

here is the original version from the mod

and here is the relinker version I've hidden it using mohidden so the extension is changed, just to make it easier to differentiate.

Edited December 4, 2016 by reddvilzz