Installing mods for The Witcher 3. Changes to graphics and game camera

So what is Script Merger for?

When installing multiple mods that modify the same game file, The Witcher 3 only loads one dominant version of that modified file. This kind of file conflict is common and can render a couple of mods you have installed completely useless (and sometimes not usable). And it is Script Merger that helps players avoid this problem.

So how does it work?

Despite its name, Script Merger finds conflicts not only in scripts (.ws), but also in other files (.bundle). After finding existing conflicts, it creates merged versions of the conflicting text files. At the same time, it does not change the original files, but simply replaces them. The program cannot fix non-text conflicts, but it can help you manage the load order (mods.settings file) in order to run certain mods bypassing others.

Notes

The KDiff3 tool simply concatenates text. In most cases, it works fine. But due to the fact that this tool doesn't quite understand the game code, sometimes it merges the files in the wrong order. There is no guarantee that automatically resolved conflicts will be resolved correctly. If such a problem occurs, user intervention will be required.
Script mods can have logical conflicts that the tool cannot detect. In this case, even if the text is merged without direct conflicts, the output script will not work correctly. For example, if Mod A hides the elements GUI, and Mod B, on the contrary, displays them, then Mod A will not work. To solve this problem, again, user intervention is required.

For NMM (Nexus Mod Manager) users: So far, Script Merger does not support NMM's multi-HD mode (or any symlinks).

Installation and use

1) Download, extract and run Script Merger.
2) Specify the path to the installed game in the field at the very top.
3) Press the "Refresh" button above the "Conflicts" list.
4) If fixable conflicts are identified, repeat these steps until the conflicts are resolved:

• Select two or more versions of the same file that you would like to merge.
• Press the "Create Selected Merge" key.
• If mods don't have matching diffs, KDiff3 can merge them automatically.
• If the mods have matching differences, a KDiff3 window will appear and you can merge them manually. This is shown in more detail in the video below.
• If Script Merger does not find the original version of the modified file, you will have to manually merge the mods when the KDiff3 window appears.

• By default, the game loads mods in the standard order: numbers first, then underscores, then letters (case-insensitive).
• You can click right click mouse over one of the mods and select its priority (from 1 to 9999, lower numbers are loaded first). You can learn more about this from Kad_Venku's explanation.

Tutorial Videos (Script Merger: The Basics)

This video takes you further into the wild.

Usage example

• content\scripts\game\cameras\combat\customCamera.ws
• content\scripts\game\player\playerInput.ws
• content\scripts\game\player\r4player.ws

• content\scripts\game\player\r4Player.ws

If you have successfully merged all three versions of r4Player.ws, then Script Merger will by default move the merged script here:

• content\scripts\game\player\r4Player.ws

The new directory starts with "0000_" so that the game loads it first. (B3 is loaded in ASCII order) Since the merged version of r4Player.ws is loaded first, non-merged versions are simply ignored by the game.

Removal

To remove all merged files and restore mods to their original form, delete the directory with merged mods (mod0000_MergedFiles in version 0.5, mod__MergedScripts in version 0.4.3).
To completely remove Script Merger from your computer, delete the files that were in the downloaded archive and the generated MergeInventory.xml file, if any.

Updates 2018! Gameplay and graphics innovations, as well as utilities to improve the game.

The Witcher 3 is a great game that contains a subset of equally good mini-games. Gwent is the card game that Geralt plays throughout the story. In truth, it is not considered unusual here if a player prefers a party to Gwent instead of a bloody battle. Now you can do both! This mod replaces all battles with Gwent parties. You will earn the same experience and loot as in a real battle.

This mod seems to have left no stone unturned. Combat, obstacles, economics, alchemy, skills, weapons, armor and more have all been changed to make the game more challenging. It's in beta, so if you're interested, you can help test it out.

Hunter's Config is a great utility for adjusting game settings, even those that you don't have access to from the game menu. There's even a utility to revert to your previous configuration, and a button to install or uninstall SweetFX.

Torches are the unsung heroes of The Witcher 3, allowing Geralt to travel to the darkest corners of his world and are a great alternative to the Cat's elixir, which, although it allows you to see in the dark, but at the same time paints everything in gray tones. In the same fashion, the torch becomes a faithful companion of the hero. Geralt can now cast spells, ride a horse, climb rocks, and block enemy attacks while constantly holding a burning torch.

About 2 years have passed since the release of The Witcher 3, and during this time some modders have abandoned their creations, which is why new fan additions and official patches often conflict with old mods. Mod Script Merger is designed to correct this situation. The principle of its operation is simple: the mod creates merged versions of similar text files, thus extending the life of mods outdated months ago. And don't be intimidated by screenshots with confusing menus - figuring out this mod will be much easier than it seems.

If it seems to you that the world around is too calm, kind, here is a mod that will help you cheer up. He will increase the chances of meeting with a crowd of monsters, winged monsters or with simple robbers. The mod contains settings, so be sure you can choose the balance of random encounters with opponents that suits you.

Utilities

Debug Console Enabler

If you are not going to be limited to installing only one mod, the divine powers of the debug console will come in handy. This utility gives you access to this console, allowing you to enter commands to change settings, spawn enemies, fix bugs, and more.

Nexus Mod Manager

All Witcher mods are tied to the Nexus, and the Nexus Mod Manager utility is The best way get rid of various bugs caused by incompatible mods. When installing new mods, be sure to pay attention to the warnings about possible problems, which may include problems with loading saves. With NMM, even mods that are fundamentally incompatible with each other can work perfectly if they are installed in the correct order.

If you install several mods at once, then follow our instructions: take your time, do everything carefully and be sure to pray.

Mod Merger

Did you know that the game has a mod limit? For us, this was news. If you exceed the allowable limit, then Mod Merger can come to the rescue. The whole process will take about 15 minutes, during which all compatible mods will be merged into one package. Too many mods you say? No, no, I install only one (albeit obscenely sized) mod.

But be careful. Merge only those mods that work without problems with each other, otherwise you will have to repeat everything over and over again.

Menu and travel

Mods that simplify travel and the interface, as well as shutting up Buttercup.

By default, Geralt's world has dozens of checkpoints for fast travel, but sometimes you have to cross several kilometers on a roach to get to the nearest one. If you are tired of such a routine, then this mod will allow you to teleport to any control point - something similar was in Skyrim. The main thing is not to abuse this feature, because teleporting too often leads to problems with several quests.

Of course, it's great that the map isn't filled with a bunch of icons like in some Ubisoft game, but sometimes you can regret it, especially if you can't remember where the healer is. This mod adds all possible icons to the map - from nearby merchants to quest points, information about which is taken from your quest log. If you think it's too much, you can always hide the icons you don't need.

A chest with your items can be found at several points on the map, but the creators of this mod asked themselves: “Why not add more chests?”. After installing the mod, 8 new points with chests will appear in the game, and 2 standard ones will be moved to more convenient places. This is quite handy, especially if you have a general realism mod installed, which takes into account the weight of the coins that Geralt keeps with him.

One of the best nuances of The Witcher is that every major contract needs to be thoroughly prepared at the beginning. We create oil from ghosts, stock up on moon dust, meditate and, of course, sharpen a silver sword.

In this fashion, meditation becomes a more meaningful process. During meditation, you spend experience points on leveling up skills, replenish stocks of alchemical items and oils, and also repair the necessary things. By default, you can't eat or drink during battle in this mod, so make sure you're fully prepared to face some noon.

Friendly Meditation

Download

If you think the Preparations Mod makes the game more difficult, then you should check out Friendly Meditation. This mod still replenishes potions while meditating, but you don't have to look at the boring menu. On the contrary, the entire interface temporarily disappears, and you can only watch clouds slowly floating across the sky, shining stars and the sun rising from behind the mountains.

Sometimes a witcher just needs to be alone with himself, right? And don't forget to install the Unification patch for this mod.

The user interface in The Witcher 3 looks quite intricate, but disabling certain features will only make the game more difficult. This mod has several apps available from different downloads that fix interface issues. Hold the button down to meditate instead of visiting the menu, or hide the quest marker if you're not using the Witcher senses, plus some HUD controls that can be toggled on and off by pressing any button instead of bringing up the menu, and more.

Lamp on Player's Boat

Is this mod important? No. But he adds a lantern to your boat, and it looks good. We have to admit, quite an atmospheric detail.

Some of us (let's not point fingers) would be happy to put the overly talkative Buttercup in an industrial meat grinder. But, since nothing like this has yet been invented in the Kingdoms of the North, it remains to be content with this mod, which disables the video from Buttercup's diary.

Oh my god, finally. Jumping aground.

Mods that change the combat system

Make fights harder, easier, or more importantly, more spectacular.

Critical Slow Motion Combat Mod

Download

If you thought that the combat in The Witcher 3 lacked cinematic quality, then you should definitely install this mod. It slows down time at the moments when Geralt deals critical hits, allowing you to see in detail how the hero gracefully blows his head off the shoulders of another bandit. Is this not enough? Then at your service is the More Blood mod from modder KNGR, which increases the amount of blood in the game.

One of the best RPG elements in The Witcher 3 is undoubtedly the set of oils applied to the blade before combat. But even the biggest fans of the genre admit that over time, finding the right substance in Geralt's inventory and using it becomes too monotonous. And the Auto Apply Oils mod can fix this. As soon as an enemy appears in front of you, to kill which you need to use a specific type of oil, it will automatically be applied to the blade, and therefore you can immediately start the fight without any preparations.

AutoLoot

Tired of digging into the inventory of defeated opponents after each battle? This mod will allow you to automatically collect everything that can be found in the area - both after a fight with monsters in the swamps, and in numerous lockers in the houses of Oxenfurt. But main feature the Auto Loot mod is that Geralt cannot automatically pick up valuable items that can cause problems. It is also convenient that the mod allows you to choose in advance which game items you need to pick up and which not to touch.

FCR3

Looking for mods officially approved by the creators of the game? How about FCR3, developed by Chief Gameplay Designer at CD Projekt Red. This includes many improvements, nerfs and buffs to make the fantasy world more dangerous and balanced. If you're looking for a mod that makes subtle yet meaningful changes, then this is the one for you. There are no graphic additions here, so the screenshot shows the usual photo of Geralt. Simple and modest.

Enemies of Rivia

This mod changes the combat system and the behavior of enemies so much that it should be placed in the section of mods that completely change the game itself. The enemies here are smarter, faster and don't hesitate to block. And therefore, during each fight, they behave quite unexpectedly - the repetition of the same techniques remains in the past. If you are a student of the Bear School and are looking for a worthy test, then you will get it.

E3DodgeSystem

Download

Longtime fans of the Witcher series remember the game's golden era. Then the wine was sweeter, the swords were sharper, and the ghouls were more stupid. They call this era E3 2014. There are several E3 2014 mods that bring The Witcher 3 closer to the demo version that is still alive in the memories of the players.

We certainly don't abuse nostalgia, but the E3-era dodge system was just great. Geralt had not yet mastered the acrobatic tricks, stood firmly on the ground with both feet and aimed his sword straight in front of him. This mod is suitable for anyone who wants to bring this system back into the game, getting rid of all the Cirque du Soleil-style show.

In addition, if you have a free second during the fight, Geralt will stretch his arms and swing his sword impressively. Looks very menacing!

Equipment and trade

Mods designed to lighten your burden, rebalance your loot, and give your gear a chic look.

Over 9000 – Weight limit mod

Geralt already carries a lot of things in his bag, not counting the two heavy swords on his back, but if you are one of those who simply cannot get past the new sword from the witch hunter collection, then this mod is a must for you. So what will be the final weight limit? Yes, you guessed it. More than 9000. From now on, you won't have to worry about the fact that trophy weapons, which can be useful in very rare cases, take up too much space in your inventory. Just take it with you and do not bother your head with such trifles.

The game could be called the Wild Hunt, but hunting creatures and monsters is not the best way to make a living. If you are tired of killing a lot of deer and getting only a little meat, then this mod increases the chance that animals will leave behind a supply of meat or some ingredients.

It's a bit of a shame when you bring a lot of unwanted junk into the city to sell, and the local merchants are so poor that they can't afford to buy it all at once. This mod makes merchants more prosperous, so they are willing to pay more for each item. Unfortunately, the patch conflicts with version 1.31, but you have two options: install an unofficial patch or an unofficial version of the mod by another creator.

In the game, we travel either to find work or to have fun - it's quite difficult to combine both, isn't it? If your Geralt doesn't mind playing Gwent from time to time, but doesn't want to run around looking for new cards, The Gwent Dealer mod will save him a lot of effort. This mod turns Quartermaster Baron into a real card collector. Now you can buy not only ordinary things from him, but almost any card.

As with the Gwent Dealer, this mod transforms the humble tavern owner into one of the most prominent merchants in the game. Now the owner of Dandelion's tavern sells almost all potions, oils, bombs, runes, mutagens and arrows. Balance imbalance? Maybe. But it's damn convenient.

Ugly equipment. It's sad, but it can happen to even the best witchers, no matter how hard they try to look stylish. If the new sword you've been tinkering with for hours has a sheath that isn't the prettiest and doesn't fit in with your color scheme, then just download Black Scabbards to fix the problem. We think that black is perfect for everything, including scabbards.

On the one hand, this is a minor cosmetic change that does not affect gameplay in any way. On the other hand, this is perhaps the best of all created mods. If in a single player RPG you are most concerned about the appearance of the hero, then you should not pass by this mod. Geralt looks incredibly cool in his new robes. Moreover, there are keys to raise or lower the hood. But it already depends on your mood.

There are quite a few gear changing mods out there, but our favorite is the Sezon Burz. Based on the book Season of Thunderstorms by Andrzej Sapkowski, this set of equipment fits perfectly into the Witcher universe and at the same time looks surprisingly fresh. What's more, the new items are tiered, so you can level up your character and upgrade to a new set of gear.

Depending on your playstyle, some elements of the daily routine of a witcher can become unbearable - especially after a couple of hundred hours in the game. If you are tired of spending money and time on repairing equipment, then the Indestructible Items mod will come in handy, thanks to which weapons no longer wear out. Extremely useful little thing.

Graphics and game camera changes

Photo mode, redesigned textures, interface changes and more.

Absolute Camera

Download

Are you unhappy with the way the camera behaves while you are running, fighting, riding or swimming? Absolute Camera not only changes the distance and angle of view, but also provides dozens of fully customizable options for the position of the camera during Geralt's various activities. In the video above, you can see how flexible the camera setup becomes.

If you want to diversify the weather conditions in Novigrad and its surroundings, then this recently released mod will help you. It greatly improves the fog and rain animations, and adds a lot more snow to the Skellige Isles. At the same time, you can always disable certain innovations using the console commands indicated on the mod description page.

Want to capture some memorable shots of Geralt in action? This mod will allow you to stop time, then move the camera in three dimensions to take great pictures. There is also a switch that allows you to make Geralt invisible (useful if you are taking pictures of the environment and nature), and an option that allows you to add fog, or a slight mist, to give the shots even more atmosphere.

HD Reworked

Download

If you're on the hunt for prettier, sharper, more detailed models and textures, please your eyes with this mod. Rocks, trees, roofs, floors - everything went over, improved resolution, brightness, and, apparently, this is just the beginning.

Craving to see the game in a brighter and richer light? The mod removes the bluish tint to the image in the game, and adds a slight adjustment to the lighting in order to give the game a truly fabulous look.

The kingdoms of the North, especially Velen and Novigrad, are quite dirty places full of clay and dust, and therefore it is almost impossible to take decent screenshots in these areas. But now you can wipe down your game camera like a professional photographer. The No Dirty Lenses mod removes drops of water and dirt from the screen, however, when diving or during rain, these drops reappear.

more blood

Download

The Witcher 3 is good. Even great. But what if the game was more like a Tarantino movie? The More Blood mod adds literally liters of blood to the game. Now Geralt constantly gets dirty during battles, his swords are always stained with fresh blood, and it naturally flows from demons in buckets. Are you ready for a bloody adventure?

If you have a powerful graphics card, why not make the most of its capabilities by increasing the draw distance? The open world in The Witcher has an impressive scale, but it looks much more spectacular with drawing several kilometers ahead. The mod has many settings where you can set a specific draw distance. But be careful - the performance of the game may drop if you set all the settings to maximum and send it to Novigrad (but this depends on the capabilities of your PC).

The mod falls into the same “will not work for everyone” category. More Shadows adds dynamic shadows to all lights in the game. Torches on the walls now cast shadows directly below them, and huge braziers in cities will be the source of all kinds of shadows on the cobbled streets. Guards walking around with torches will also get dynamic shadows. And if you have display problems, then there is an alternative version of the mod that removes some shadows.

Vampires Have No Shadows

It's almost like More Shadows, but with some differences. With serious differences, to be honest. Vampire NPCs, as they should, no longer cast shadows even when walking directly under the sun! Creepy, but effective.

Mods that completely change the game

These mods make massive changes to the combat, alchemy and other The systems Witcher 3.

Are you missing a variety of weapons and armor? This mod makes other character's equipment available, such as Imlerich's great mace and a few others. Geralt can get it through merchants or make it himself. New blueprints in shops will allow you to get even more weapons, and don't forget about upgrading relics.

The Witcher 3 Enhanced Edition

Download

More recently, we wrote about this mod: this is a complete rethinking of the combat system of The Witcher. The main innovation is the removal of auto-aim. Now Geralt no longer jumps from one enemy to another like a pinball, but only hits where you point him. This means that you can prepare a strike and quickly go behind the enemy's back or break through his shield.

It's a big change, but it's far from the only one in TW3EE. It also adds new animations, new ways to parry, and new ways to set up attacks from a distance. Each attack can also affect your hero - there is a chance that Geralt will get out of the next brawl with a broken arm or leg. These effects are directly reflected in the leveling, alchemy system and equipment of the hero.

If you've been through New Game+ a few times and seen everything The Witcher 3 has to offer, then this improved version is the perfect excuse to re-install the game. It is advised to put the mod on a "clean" version of the game, after which you can safely install additional modifications.

Ghost Mode is no less ambitious than the Enhanced Edition, but the changes are more subtle. He does not abandon the basics of the original, but only polishes all the little things that required editing. For example, expensive plates can no longer be found on the shelves of the poor, all ingredients have a weight (but you need fewer ingredients for alchemy), and simple equipment has become more powerful and useful. Typos in item descriptions have also been fixed, enemies have received new armor bonuses and stamina limits, etc.

If you think that The Witcher 3 needs a complete overhaul of all systems, then the Enhanced Edition is waiting for you. If you think that the game just needs to be polished and balanced (which modders have been doing for two years), then feel free to install Ghost Mode.

And, of course, put the mod on the "clean" version of the game, and only after that add the rest of the mods to taste.

Description:

Why you need Script Merger
When you have multiple mods that modify the same game file, TW3 only loads one version of that file. This kind of conflict is common and breaks modifications, ie. when starting the game, an error pops up, and the game simply does not start. This program tries to fix this problem.

Update: 0.6.2
- Added recognition in the merge update of the source files and the base line to remove the affected merge.
- Added validation mods.settings.
- Re-added execution info in file config. Hope TypeLoadException escape at startup.
- Fixed: Fake "missing file" error after successfully batch merging 3+ mods.
- Fixed: "Dependency Locations" menu item stopped working in 0.6.1.
- Bug fixed: Crash when trying to open relative file paths.
- Fixed: Disabled mod flags in some situations.

Version history:

Version 0.6.1
- Added menu with options to open specific files/folders, repack merged bundle or exit and start the game.
- Aesthetic status bar.
- Quick "Set Priority" functionality.
- Removed flags from disabled mods.
- Added merge remove request including disabled mods.
- Added progress bar to the taskbar (Windows Vista or later).
- Added tooltips to the context menu.
- Hidden "Select / Expand All" context menu item for the right mouse button.
- Disabling missing mod priorities gives 9999 and lowest priority + 1.
- Added waiting for the path of the absence of a file selection dialog for troubleshooting.
- Fixed: Possible conflict crash is resolved in the load order of all crashed conflicts.
- Fixed: "Open Vanilla" context menu was shown when missing vanilla file.
- Fixed: Wrong text color when right clicking and selecting a checkbox.

Version 0.6.0
- Improved custom load order handling.
- Added context menu items to set mod priorities, enable/disable, remove from load order.
- Conflicts that are resolved in the custom load order are highlighted in purple.
- Mods that have priority in the custom load order are greyed out.
- Mods disabled in custom load order are in italics.
- Added option to auto-resolve conflicts that are resolved using a custom load order.
- Added option to disable checking custom load order.
- Fixed min and max priority limits according to CDPR documentation.
- Removed options and suggestions to disable custom boot order.
- Fixed: Load order confirmation crashed when empty file mods.settings.
- Added hot key F5 to update conflicts.
- Renaming "unsupported" to "not mergeable".
- Acceptable fix for misaligned icons in merge report

Version 0.5.11
- Fixed: custom load order modification was broken (mod0000_MergedFiles crashed and reassigned existing priorities incorrectly).

Version 0.5.10
- Corrected: bundled XML files have been interpreted incorrectly.

Version 0.5.9
- Added support for non-bundled XML files.
- Added fix when custom load order modification (file mods.settings) did not download the merged files in the first place.
- Renamed setting ScriptsDirectory in VanillaScriptsDirectory, because for some users it was not clear.
- "Witcher 3 Directory" has been moved to the text field above the UI.
- Added plus sign, arrow and colored text to make the merging report more clear.
- Added tooltips to menu items Options.
- Added error message about missing file config.
- Fixed: Incorrect progress numbers when merging multiple game files.
- Fixed: Empty conflict category left to update after conflict resolution outside of Script Merger.
- Possibly fixed a bug where the directory tempbundlecontent did not exist, causing QuickBMS to silently ask for confirmation.

Version 0.5.8
- Added support bundled files csv and TXT.
- Added sound when merging or packaging is completed (new option in menu Options and in config file).
- Merge process message: "conflict X c Y, file N c M" if applicable.
- Removed recommendation to copy scripts from wcc_lite because they are outdated.
- Fixed: Context menu items for deleting merge didn't work.

What does Script Merger do?
Script Merger detects conflicts in both .ws scripts and .bundle packages. She then creates a merged version of the conflict .ws scripts or .xml files inside .bundle. It also detects texture and model conflicts, but cannot merge them.

It also uses 3 other programs:
- KDiff3 by Joachim Eibl- merges text files.
- QuickBMS by Luigi Auriemma- scans and unpacks .bundle files.
- wcc_lite by CD Projekt Red- packs concatenated XML into .bundle files.

Note:
- When merging, KDiff3 just does a text merge. In many cases this works well. But since this program does not actually understand the code, sometimes it combines in the wrong order. In this case, the merging must be done manually.
- In addition, there may be logical conflicts in scripted mods that the program cannot detect. In this case, even if the text is merged without direct conflicts, the resulting script will not work properly. For example, if FASHION trying to hide the HUD, and ModB displays the HUD, then ModA will not work. In this case, the merging must also be done manually.

Instruction:
1. When you first start the program, you need to specify the path to the folder of the game "The Witcher 3 Wild Hunt".
- Steam version- \Steam\steamapps\common\The Witcher 3.
- GOG version-\GOG]\The Witcher 3 Wild Hunt.
2. A window will open with two halves.
3. Press the "Refresh" button above the "Conflicts" list.
4. If there are any mod conflicts, those mods will be shown in the left window. The right window will be empty for now. After merging mods, this window will show the already merged mods. Check the mods you want to merge.

5. Click the "Create Selected Merge" button.
6. If the program itself combined everything without problems, a small window "Conflicts" will pop up indicating the number of conflicting lines, the number "0" will be written in the last line. In this case, calmly click "OK". Then another bigger window pops up with the name of the mods that have been merged into the new mod. "mod0000_MergedFiles". Also click OK.
7. It happens that the program itself can not cope with the union. We must make a choice. After a small window pops up, numbers will appear in the third line showing how many lines the program has not combined and which need to be combined manually. Also press "OK".
8. A large window pops up, divided into 3 (sometimes 2) vertical columns: A, B, C. Window A usually shows lines from the game itself (original), AT and C- strings from merged mods. The program itself will highlight the conflicting lines in yellow, you need to click on the highlighted inscription at the bottom of the large window right click and select one of the options - AT or FROM, i.e. which mod do you prefer. Sometimes you have to choose AT and FROM or FROM and AT. If there are more than one conflicting lines, you need to scroll down the slider of the lower horizontal window until the inscription appears again or use the arrows in the form of triangles on the Toolbar, and merge. If the outermost triangle is red, then there are rows that have not yet been merged.

9. Then close the window. A small window will pop up, click "Save & Quit". The program will save and the large window will close. You can also just save by clicking on the icon in the Toolbar or by going to "File" and then "Exit".

If several mods are merged, the program will continue merging further. If the program refuses to write files and close, then there is some uncombined line left. You need to scroll through the lines in the bottom window again and find the line . After everything is merged, another window will pop up showing that the mods are being merged. Press "OK".

10. All merged mods will move to the right window.

11. Close Script Merger and start the game. TW3 should load merged files first, ignoring non-merged versions.

If errors pop up when starting the game, the merging went wrong or the versions of the mods do not correspond to the version of the game and are not adapted to it.

IMPORTANT!
Before uninstalling or updating one of the mods included in "Merge", i.e. which is merged with some other mod, you need to remove the merger by checking the mod group in the right box of Script Merger and clicking on "Delete Selected Merge". All mods will move to the left window. Then you can safely remove or update mods, then open Script Merger and re-merge the mods.

Example:
Mod 1 - modFOVTweak

Mod 2 - modManualCam
content\scripts\game\cameras\combat\customCamera.ws
content\scripts\game\player\playerInput.ws
content\scripts\game\player\r4player.ws
Mod 3 - modNoWitcherSense
content\scripts\game\player\r4Player.ws

If the union of all 3 versions r4Player.ws successful, Script Merger will deliver the merged script r4Player.ws default.

New mod - mod0000_MergedFiles
content\scripts\game\player\r4Player.ws

The new mod starts with "0000_" so that the merged mod is loaded first (all mods in the "mods" folder are in alphabetical order), non-merged versions will simply be ignored by the game.

To undo all merges and return mods to their initial state, you need to delete the merged folder "mod0000_MergedFiles".

When updating:
You need to cancel the merging of all mods, the "mod0000_MergedFiles" folder should itself be deleted from the "mods" pack, delete the "Witcher Script Merger" folder from the game root folder. And then install the updated Script Merger, then launch the program shortcut and merge all the mods again.

Installation:
Unzip the archive and drop the folder "Witcher Script Merger" into the folder with the game "The Witcher 3 Wild Hunt" (not into the "Mods" folder). For convenience, the program shortcut can be displayed on the desktop.

Removal:
To completely remove Script Merger from your computer, you need to delete the "Witcher Script Merger" folder from the game's root folder, as well as the generated MergeInventory.xml file.

ADDITIONALLY:
Sometimes even with a successful merging of mods, when you start the game, a window with errors may pop up. Therefore, you can download from the additional link scripts that can resolve this error. In this case, you need to replace the folder scripts from the game along the way: The Witcher 3 Wild Hunt/Content/content0/ to a folder scripts from the archive, previously removing folder scripts from the game.

I advise you to first make a backup of the scripts folder from the game in case the error still pops up in order to return the game scripts back (if available).

Tutorial: video
common use
(thanks to Gopher and wghost81)

Note: Tutorial Gopher "and quite useful in general, but his advice on editing a file config Script Merge is not needed manually, because this increases the chance of misconfiguration.

Using KDiff3
This Video shows a couple of KDiff3 basics.This Video more detailed.

Description:

When you have multiple mods that modify the same game file, TW3 only loads 1 of the modded versions of that file, overriding all over versions. This kind of conflict is common & can break mods. Script Merger tries to make the problem less painful.

Despite the name, Script Merger detects mod conflicts in .bundle packages as well as .ws scripts. Then, it helps you resolve them by creating merged versions of conflicting text files. It leaves the original files untouched, but overrides them. It can "t merge non-text conflicts, but for these it can help you manage your custom load order (mods.settings file) to make certain mods override others.

Uses these 3rd party external tools:

KDiff3 by Joachim Eibl, for merging text files.

QuickBMS by Luigi Auriemma, for scanning & unpacking .bundle files.

Wcc_lite by CD Projekt RED, for packing merged text files into .bundle files.

Also contains code from xxHash.NET by Wilhelm Liao, to detect when mod updates have changed files that you merged.

When merging, KDiff3 simply does a text merge. In many cases, that works fine. But understand because the tool doesn't actually the code, sometimes it can merge things in the wrong order. Auto-resolved conflicts aren't guaranteed to be correct. In these cases, it needs human help.

Also, script mods can have logic conflicts that the tool can't detect. In these cases, even if the text can merge without direct conflicts, the resulting script won't work properly. For example, if Mod A tries to hide the HUD, but then Mod B displays the HUD, Mod A won't work. Resolving this also requires human help.

NMM users: Currently, Script Merger doesn't support NMM's multi-HD mode (or symlinks in general).

instructions

1) Download, extract, & launch Script Merger.

2) Enter your game's installation path in the textbox at the top.

3) Click "Refresh" button above the "Conflicts" list.

4) If mergeable conflicts are detected, repeat these steps until the conflicts are resolved:

> Choose 2 or more versions of any file(s) to merge.

> Click "Create Selected Merge" button.

> If the mods have differences that don't overlap, KDiff3 can merge them automatically.

> If the mods have differences that overlap, KDiff3 will appear so you can merge them manually. See below for tutorial videos.

> If Script Merger can"t find the vanilla version of the modded file, you must merge all differences manually when KDiff3 appears.

5) If non-text conflicts are detected, Script Merger displays them but can "t merge them. So, one of the mods in each conflict will "win" & override the others. Here's how the winner is decided:

> By default, the game loads mods in order of folder names - numbers first, then underscores, then letters (not case-sensitive).

> Or, you can right-click one of the mods to set its priority (1 to 9999, lower number loads first). Here "s an excellent detailed explanation by Kad_Venku.

7) When you uninstall or update one of the mods included in a merge, Script Merger will detect the change & prompt you to delete affected merges. If you update a mod & Script Merger doesn't prompt you delete any of that mod's merges, then they weren't affected by the update.

Fans of playing The Witcher 3: Wild Hunt with mods often encounter mod conflict issues using the same system script files. As a result, either the game crashes at the script compilation stage, or some mods work inadequately! This utility will allow you to combine (glue) various modifications with each other in a semi-automatic mode without losing functionality!

Script Merger Features:
- Allows you to combine conflicting mods (from 2+) together into one single mod with working functionality.
- Allows you to find differences not only in scripts (.ws), but also in other files (.bundle).
- Also in the archive you will find the original scripts various versions games (patch 1.30, patch 1.31, patch 1.31 GOTY) for more correct adaptation of mods that affect system functions of scripts that are missing in older versions!
- User-friendly interface and program design.
- Embedded all the necessary tools (KDiff3, QuickBMS, wcc_lite) for unpacking/packing and editing various formats of modifications.

Attention!!! If possible, try to manually make changes to the code (using a tool), because a fully automatic merge can lead to a conflict between the code of old patches and new ones, be extremely careful and try to "read the code", as well as pre-compare the changes in patch 1.30/1.31/ 1.31 GOTY, so as not to accidentally transfer "changes" of patches from one version to another (where they no longer exist). Otherwise, you will get bugs, errors and crashes of saves.

Installing and using Script Merger:

Quote (http://modgames.net)

1) Download, extract and run Script Merger.
2) Specify the path to the installed game in the field at the very top.
3) Press the "Refresh" button above the "Conflicts" list.
4) If fixable conflicts are identified, repeat these steps until the conflicts are resolved:
- Select two or more versions of the same file that you would like to merge.
- Press the "Create Selected Merge" button.
- If mods don't have matching diffs, KDiff3 can merge them automatically.
- If mods have matching differences, a KDiff3 window will appear and you can merge them manually. This is shown in more detail in the video below.
- If Script Merger does not find the original version of the modified file, you will have to manually merge the mods when the KDiff3 window appears.

5)If non-textual conflicts are detected, Script Merger will show them, but will not fix them. This means that one of the mods in each conflict will “win” and replace the others. Here's how the winner is chosen:
- By default, the game loads mods in the standard order: numbers first, then underscores, then letters (case insensitive).
- You can right click on one of the mods and select its priority (from 1 to 9999, lower numbers are loaded first). You can learn more about this from Kad_Venku's explanation.

6) Enjoy the game!
7)When removing or updating one of the mods that is part of the merged file, Script Merger will detect the change and offer to delete the corrupted file. If you updated a mod and Script Merger didn't offer to delete the merged files with this mod, then the update didn't affect them.

Usage example

Quote (http://modgames.net)

Attention!!! In order to switch the interface language in the KDiff3 shell, replace KDiff3 0.9.98 with version 0.9.97 (available on the Internet). Because the current version of the utility has an error with switching the language.

Video guides on using Script Merger:

Screenshots of the Script Merger interface:

P.S. I also ask you to pay attention to the fact that often you will have to combine mods that are interspersed in system scripts of different patches. Thus, you can inadvertently transfer pieces of code from a patch of a minor version to an older version, which will lead to errors and crashes of saves. Be careful and careful, read the code.

P.P.S. Keep in mind that many functions can be changed (no arguments, or new ones added) in different patches and therefore mods on new patches may not work, even with proper porting. Here you will already need a little knowledge in understanding the structure of the code and coding.

If you manage to combine several mods together (thus creating a hodgepodge), leave the composition and links in the comments, I think other users of the site will be very grateful to you!

If you managed to adapt the mod of version 1.30 to 1.31/1.31 GOTY or other versions, duplicate the comments in the topics of the corresponding mods. Perhaps someone will help.

Successful adaptations and combinations!

downloaded: 1119 time(s)
The size: 55.80MB