FAQ

1. Can't run the script: permission denied.

This can happen on a Linux system if the file doesn't have execute permissions. You can check the file permission bits with ls -l and add execute permissions with chmod +x.

2. Error: You must give a valid path to a new resources.assets.resS file.

Make sure you have provided a resources.assets.resS file with the -swap option, like this:

./shadow_tune.pl -swap new_resS_file

The file doesn't have to be named "resources.assets.resS", in fact, but if it's not in the same directory like the script a path must be provided. Absolute paths are less likely to produce erros but relative paths should work as well as long as the shell expression can be resolved by Perl's glob() routine.

3. Error: Unable to locate Shadowrun game assets.

The script failed to locate the installation folder of the desired Shadowrun game. If you haven't already, try to run the script with the -i option:

On Unix systems:

./shadow_tune.pl -swap new_resources.assets.resS -e dragonfall -i /path/to/Dragonfall/Game/folder/
./shadow_tune.pl -restore -i /path/to/Dragonfall/game/folder/

On Windows systems:

perl shadow_tune.pl -swap new_resources.assets.resS -e dragonfall -i c:\path\to\Dragonfall\Game\folder\
perl shadow_tune.pl -swap new_resources.assets.resS -e dragonfall -i c:\path\to\Dragonfall\Game\folder\

Note: The path provided with the -i option should just point to the root folder of the specified Shadowrun game, not a subfolder within that directory! Some sample paths:

-i ~/my_custom_games_folder/Shadowrun\ Returns/
-i "/home/my_user/my_custom_games_folder/Shadowrun Returns/"

4. I provided the game path with the -i option but the script still can't find it!

First, make sure the path you used (absolute or relative) can actually be resolved by your shell. Second, check if the path corresponds to the game the script is trying to find. By default, the script will try to carry out its replacement operations on the files of Shadowrun Returns. When modifying either Dragonfall or Hong Kong, the game will have to be explicitly set with the -e commandline switch.

Examples of wrong script invocation:

./shadow_tune.pl -swap new_resources.assets.resS -i "/home/my_user/my_games/Shadowrun Hong Kong/"
./shadow_tune.pl -swap new_resources.assets.resS -e hongkong -i "/home/my_user/my_games/Shadowrun Returns/"

In both of these cases, the script will fail with the message that it can't find the installation folder. This is because in the first case the script is looking for Shadowrun Returns and thus has no use for the path to Shadowrun Hong Kong. Similarly, in the second case the game has been explicitly set to Shadowrun Hong Kong, rendering the path to Shadowrun Returns irrelevant.

Examples of correct script invocation:

./shadow_tune.pl -swap new_resources.assets.resS -i "/home/my_user/my_games/Shadowrun Returns/"
./shadow_tune.pl -swap new_resources.assets.resS -e hongkong -i "/home/my_user/my_games/Shadowrun Hong Kong/"

Here the path provided with the -i option is in line with the game that the script is looking for.