Title: Setting up Beamdog IE Games to install Mods onto an Android Device Version: 1.1 Date: 16 July 2018 Author: @Gusinda on Beamdog Forums (https://forums.beamdog.com/) Appreciation goes to: - @Isaya for kockstarting the topic, explaining how to install mods, and proof reading the procedure. - @junyangche for taking time to explain the syntax of the command 'fsutil'. - @trinit for proof reading and testing the proceedure. - @Cavak for proof reading and testing the proceedure. - and of course Beamdog for enhancing the games and bringing them to life on an Android platform. ====== Section 0 - Introducton ====== With the update to 2.5, there have been some dialog.tlk conflicts when loading modfiles onto an Android device. One solution to make the games compatible for modding is to reposition the dialog.tlk from it's current location within the patch.xxx.gamename.obb to a new location in the Android\data\gamename\files\lang folder. An updated dialog.tlk can then be used without the potential for conflict with the original version. This document will describe how to repackage your game's patch.xxx.gamename.obb to enable modding the game for Android devices. It will also describe generally, the process in building a modfile. It will not cover installing mods or the order in which that occurs as there is already enough discussion on these topics within the forum. Testing Environment ~~~~~~~~~~~~~~~~~~~ The test environment used: Generic Gaming Notebook: CPU: Intel, OS: Windows 10 Android Device: Samsung Note 4, Snapdragon/Adreno, OS: Android v6.0.1 Language: us_EN (English). If someone can test with other languages, thanks. As of version 1.1 of this document, the following games have been tested: - BG1EE v2.5.16.4 Beta (Did not work, games crashed upon spell casting) - BG2EE v2.5.16.6 (Vanilla seemed to work fine and various mods tested which worked) - BGSoD (Requires a different method of repacking patch.obb, but vanilla works as well as various mods) Read addendum for the method used. This method also worked for other games patch.obb. - IWDEE v2.5.16.3 (Vanilla works, no mods tested) - PSTEE (Vanilla works, no mods tested) Didn't get the verson number but I expecet it is the latest. Notes: - Rather than talking about opening the Command Prompt for those who are unsure how, I will describe the creation of some batch files to do the job. For those who do know how to access the Command Prompt, then I am sure you also know what the commands are doing. - Some of you know how to associate .obb files with your compression software. I will rename the files to .zip in this discussion but you can do either. - The method described is performed using a Windows platform. I don't have any iDevices or MacPCs to test for Apple, so I am unable to comment on the Apple Mac platform. Same for Linux. If someone knows which tools and would like to take the time to document for those platforms, it would be appreciated. This document will describe three steps, Preparation, Repackaging the patch.xxx.obb, and Modfile creation and installation onto your device. There is an additional section which explains how to install EEKeeper and NearInfinity to enable editing your saved game and modifing game content (when you really want that particular spell to work with your solo fighter!). ====== Section 1 - Preparation ====== Collecting Tools ~~~~~~~~~~~~~~~~ - Gather the following tools: - centralfix.exe (http://www.scottbrooks.ca/centralfix.exe) - A compression tool that allows for creating a STORE only (uncompressed) .zip containers. I use WinRAR or 7Zip. Working File Structure ~~~~~~~~~~~~~~~~~~~~~~ - Create the following folder structure on your computer. E: drive is used but any drive will do the job. Ony BG2EE will be documented, but you can interpret the procedure to suit any or all of the games. You can also rename the folder structure to suit your needs. Do not name the folders with any special characters in the name (and do not include anything in the parens, they are for information only). E:\BD Android (Beamdog Android) E:\BD Android\BG2EE 2.5.16.6 (This is where the mods are installed) E:\BD Android\BG2EE 2.5.16.6 Modfile (This is where modfile is created) E:\BD Android\BG2EE 2.5.16.6 Modfile\lang\en_US (where to copy the dialog.tlk, you will need to change this to whatever in game language you use) E:\BD Android\BG2EE 2.5.16.6.Clean (A clean copy of the game files if you have enough HDD space) E:\BD Android\patch.570.com.beamdog.baldursgateIIenhancededition (or whatever the name of the patch obb file is) (This is where the repackaging of the patch .obb occurs, can be deleted once complete) Unpacking .obbs ~~~~~~~~~~~~~~~~ - After installing the game onto your device and running once (to create the \data game file structure and baldur.lua), connect device to PC, and copy the 2 x .obb files from: 'sdcard/android/obb/com.beamdog.baldursgateiienhancededition/' (this is the internal SDCard) to E:\BD Android\BG2EE 2.5.16.6 - You can now disconnect your device. - Rename the 2 x .obb to .zip. For those that know how, you can register the .obb extension with your compression tool rather than rename. - Unpack (using WinRAR or 7Zip) main.xxx.com.beamdog.baldursgateIIenhancededition.zip into 'E:\BD Android\BG2EE 2.5.16.6' making sure the folder structure remains the same. - Unpack patch.xxx.com.beamdog.baldursgateIIenhancededition.zip into E:\BG Android\BG2EE 2.5.16.6 maintaining the folder structure. - Move patch.xxx.com.beamdog.baldursgateIIenhancededition.zip to E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition - Delete main.xxx.com.beamdog.baldursgateIIenhancededition.zip (or move to another location for backup) - You should now have the following folders inside BG2EE 2.5.16.6: E:\BD Android\BG2EE 2.5.16.6 E:\BD Android\BG2EE 2.5.16.6\data E:\BD Android\BG2EE 2.5.16.6\lang E:\BD Android\BG2EE 2.5.16.6\movies E:\BD Android\BG2EE 2.5.16.6\music E:\BD Android\BG2EE 2.5.16.6\override E:\BD Android\BG2EE 2.5.16.6\scripts and chitin.key should be in the root of E:\BD Android\BG2EE 2.5.16.6 - If you have the space on your HDD, you can now copy the contents of 'E:\BD Android\BG2EE 2.5.16.6' to 'E:\BD Android\BG2EE 2.5.16.6.Clean'. This allows you to delete the modded folder and quickly start again, or recover if you have an error, by copying these contents back to 'E:\BD Android\BG2EE 2.5.16.6'. - Select E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition - Unpack patch.xxx.com.beamdog.baldursgateIIenhancededition.zip into the folder maintaining folder structure. - Find the file size (in bytes) of patch.xxx.com.beamdog.baldursgateIIenhancededition.zip (look at the properties of the file) eg: (1,675,151,987 bytes), and keep note of it. To find, right click on the file and select 'Properties'. Under the General Tab, there are two information lines showing size. Use the amount (in bytes) that is shown beside 'Size:' and not 'Size on disk:'. - Delete patch.xxx.com.beamdog.baldursgateIIenhancededition.zip (or move to another location for backup) - Your folder structure should look like: E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition\data E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition\lang E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition\movies E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition\music E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition\scripts - Copy centralfix.exe to E:\BD Android\BG2EE 2.5.16.6 Modfile - Copy centralfix.exe to E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition Note: PSTEE only has one .obb (main.obb). This can be repacked using the method below as if it were the patch.obb. ====== Section 2 - Repackaging Patch.obb ====== Repackaging Obb ~~~~~~~~~~~~~~~ This procedure needs only to be done once per game version. Once it is done, the modified patch.obb replaces the original patch.obb on your device. You can either keep a copy of the original on your device (renaming it so it doesn't conflict), or on your PC. Another method of course, is to reinstall the game if problems arise or you want to revert back to original. - Move 'E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition\lang\en_US\Dialog.tlk' to 'E:\BG Android\BG2EE 2.5.16.6 Modfile\lang\en_US' (you will need to adjust which dialog.tlk and folder for your language). - Sitting in the folder 'E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition\lang\en_US\', create a text document called 'CreateEmptyFile.bat'. Right click on the file and edit (I use Notepad++ but Notepad will also do the trick). Add the following lines into the .bat (a copy is with this document): @Echo Off Rem This creates an file with no contents called 000.000 fsutil file createnew 000.000 0 - For those who know how, you can open Command Prompt in the folder and use the command: fsutil file createnew 000.000 0 (Note: For Mac users, the command is MKFILE, and of course it's own syntax, instead of fsutil) - Save and close. Run the .bat file by double clicking on it. This creates an empty file called 000.000 that will be filled later to bring the patch.obb to its correct size. - Move CreateEmptyFile.bat to 'E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition'. - Sitting in the folder 'E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition', select all folders ie:\data, \lang, \movies, \music, \scripts. Do not select any files in the root of the folder. - (Repacking method described using WinRAR) Right click on blocked folders and select 'Add to Archive...'. The name in Archive name should be 'patch.xxx.com.beamdog.baldursgateIIenhancededition'. Change Archive format to ZIP and change Compression method from 'Normal' to 'Store'. Click OK. WinRAR will now create an uncompressed ZIP container and close. - Find the file size (in bytes) of the newly created patch.xxx.com.beamdog.baldursgateIIenhancededition.zip (look at the properties of the file) eg: (1,663,475,108 bytes), and keep note of it. - Using the file size from the original patch.obb that was gathered in the preparation phase, and the file size from the newly created patch.obb, determine the difference between the two (original size - newly created size): 1,675,151,987 - 1,663,475,108 = 11,676,879 This means that the file size of 000.000 needs to be 11,676,879 bytes in length to make the patch.obb correct. - To do this, copy CreateEmptyFile.bat back into 'E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition\lang\en_US\' and edit the .bat file. Change the command to reflect the new file size. The number at the end of the command should be the same number you got by calculating the difference (no commas). fsutil file createnew 000.000 11676879 - Save and close. - Delete the current file 000.000 and double click on CreateEmptyFile.bat. This should now create a new empty file that is 11,676,879 bytes in size. - Delete CreateEmptyFile.bat from 'E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition\lang\en_US\' - Delete the newly created patch.obb. - Recreate a new patch.obb by repeating the steps used to create an uncompressed file: Sitting in the folder E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition, block all folders ie:\data, \lang, \movies, \music, \scripts. Do not select any files in the root of the folder. - Right click on blocked folders and select 'Add to Archive...'. The name in Archive name should be 'patch.xxx.com.beamdog.baldursgateIIenhancededition'. Change Archive format to ZIP and change Compression method from 'Normal' to 'Store'. Hit OK. WinRAR will now create an uncompressed ZIP container and close. - Find the file size (in bytes) of 'patch.xxx.com.beamdog.baldursgateIIenhancededition.zip' (look at the properties of the file) eg: (1,675,151,987 bytes). It should now be exactly the same size as teh original patch.obb. If it isn't, delete and repeat the steps above. - The newly created zip file now needs to be prepared using Centralfix (which fixes the Central directory in the zip file). Sitting in the folder 'E:\BD Android\patch.xxx.com.beamdog.baldursgateIIenhancededition', select 'patch.xxx.com.beamdog.baldursgateIIenhancededition.zip', drag and drop it onto centralfix.exe. A windows should open, showing the central headers being fixed, and close - Rename 'patch.xxx.com.beamdog.baldursgateIIenhancededition.zip' to 'patch.xxx.com.beamdog.baldursgateIIenhancededition.obb'. - Copy to your device, placing it into (Internal SDCARD) 'Android/obb/com.beamdog.baldursgateIIenhancededition' folder. If you still have the original patch.xxx.obb, you can rename to patch.xxx.obb_BU if you have enough space or keep it backed up on your PC and delete. Prior to testing, the original dialog.tlk needs to be prepared. This will confirm whether patching the patch.xxx.obb has been successful or not, and should be done before any attempt at modding is performed. Vanilla dialog.tlk ~~~~~~~~~~~~~~~~~~ To play the game unmodded (generally called vanilla), the original dialog.tlk needs to be used. There are two methods of using the original dialog.tlk, one is copying the file and the other is packaging it into a centralfixed zipped format. We are using the the copy method, but a general overview for the packed method is giving: Copy: - To play the game using the vanilla dialog.tlk, sit in the following folder on your device: 'Android/data/com.beamdog.baldursgateiienhancededition/files' - Create the folder 'lang', then create 'en_US' inside it. It should look like: 'Android/data/com.beamdog.baldursgateiienhancededition/files/lang/en_US' - Copy 'E:\BD Android\BG2EE 2.5.16.6 Modfile\lang\en_US\dialog.tlk' to that folder. If you wish to use the packed method, then zip up lang\en_US\dialog.tlk (in E:\BD Android\BG2EE 2.5.16.6 Modfile folder) which becomes lang.zip, centralfix it and copy it to the root of 'Android/data/com.beamdog.baldursgateiienhancededition/files/' on your device. Finishing up ~~~~~~~~~~~~ You are now ready to test the game to see whether it starts. Do not skip this step, and get straight into modding. This step will confirm whether the procedure has worked, giving the confidence that when you start modding and problems occur (and they will!), it is to do with the modding and not the base game. Disconnect the device and run the game. If it crashes on start, then it is likely something is wrong with the dialog.tlk (either folder names/location, or if packaged, it most likely hasn't been centralfixed). If it tries to redownload the game, then it is likely your patch.xxx.obb that is the problem (mostly a size difference). Hopefully all goes well. If it does, the your ready to mod the game.... ====== Section 3 - Creating the Modfile ====== Modding ~~~~~~~ This section isn't to explain the steps required to install mods, or in what order they should be. There are enough discussions about this already in the forum. It will provide a general outline only focussing on what to do once the mods are installed... I recommend starting with installing only one or two mods until you understand the process of setting these up on your mobile device. If problems occur with the process, it is easier to fault find and restart with two mods then it is with 20. Some mods only require them to be copied to the override folder as standalone files, so just place them in the override folder (if it doesn't exist, create override). Most mods use WeiDU to install. Starting with the folder structure (as detailed in Preparation section) in place... - Most mods are packed in a .zip or .rar file. Unpack the mod so that the WeiDU component ('setup-modname.exe') is in the root of the folder 'E:\BD Android\BG2EE 2.5.16.6' (where chitin.key is). This means that the rest of the mod should be contained in a folder branching off (called 'modname'). Double click on 'setup-modname.exe' to install the mod. Rinse and repeat for other mods, taking care of the order in which they need to be installed. Most mods place their content only into the 'override' folder and change the dialog.tlk file. So these will be discussed first. - Once you have installed all the mods you want, copy (don't move) your 'override' folder complete from 'E:\BD Android\BG2EE 2.5.16.6' to 'E:\BD Android\BG2EE 2.5.16.6 Modfile' - Copy 'E:\BD Android\BG2EE 2.5.16.6\lang\en_US\dialog.tlk' to 'E:\BD Android\BG2EE 2.5.16.6 Modfile\lang\en_US'. If you still have the original dialog.tlk in this folder, you can back it up elsewhere or if you have it on your device already, you can delete it. My preference is to rename the lang folder to lang.vanilla and create another '\lang\en_US' folder structure (this is why I have almost no room left on my HDD) and keep it backed up in my modding environment. Creating the Modfile ~~~~~~~~~~~~~~~~~~~~ - Sitting in 'E:\BD Android\BG2EE 2.5.16.6 Modfile', select both 'lang' and 'override' folders, right click and 'Add to Archive...'. The name in Archive name should be 'BG2EE 2.5.16.6 Modfile'. You can change the name of the archive to something that has more meaning now or later. Change Archive format to ZIP. The file can be either compressed or set to STORE. Hit OK. WinRAR will now create a ZIP container and close. We are only creating the file container (zip file) to reduce the amount of time to copy the files to your device (copying thousands of files to your device can test the best of patience), and only using .zip as it is a common format. If your Android File Manager can handle .rar compression, then why not... Note: If you are going to keep everything in a single package, then you will need to have the .zip (yes it needs to be a zip) uncompressed (STORE Only) and apply centralfix.exe to the modfile. Be aware however that if you have more than a certain (not sure what it is exactly, but somewhere around 4000) amount of files in your override folder, the game will crash. If you are going to uncompress the file, or you don't understand what I just said, then ignore this paragraph and continue on. - Connect your device and copy the modfile.zip. Where you place the file on your device depends on which File Manger (FM) you are using and how it handles .zip files. If your FM requires you to place the .zip into the folder you are going to unpack it in, then place the file into: 'Android/data/com.beamdog.baldursgateiienhancededition/files/' Otherwise you can place it into a specially created folder to hold modfiles. I place the modfiles into the game folder above Files (ie: Android/data/com.beamdog.baldursgateiienhancededition/) and unpack when I want to test/play. I also keep my vanilla modfile (which only contains dialog.tlk) in this folder as well as unpacked in lang.vanilla (on the device). - Disconnect device - Open your Android File Manger. Since you already have the original Files\lang\en_US\dialog.tlk installed, you will need to rename the 'lang' folder to 'lang.vanilla' (if you want to keep it there). At this point, you are ready to unpack the modfile. - Using your Android File Manager, select the archive and unpack (keeping the folder structure) into: 'Android/data/com.beamdog.baldursgateiienhancededition/files/' You should now have the following: Android/data/com.beamdog.baldursgateiienhancededition/files/ Android/data/com.beamdog.baldursgateiienhancededition/files/lang Android/data/com.beamdog.baldursgateiienhancededition/files/override You may also have other folders such as Android/data/com.beamdog.baldursgateiienhancededition/files/character Android/data/com.beamdog.baldursgateiienhancededition/files/lang.vanilla Android/data/com.beamdog.baldursgateiienhancededition/files/portraits Android/data/com.beamdog.baldursgateiienhancededition/files/save etc - If you had the Modfile.zip in the root of the Files folder, then you will need to delete or move it elsewhere. If it is left in place, the two dialog.tlk (one in your lang folder and one in you zipfile) will clash and the game will crash. - You can now test the game by running it. Hopefully, everything should start up fine and you can 'play on'. If it doesn't, then some fault finding needs to occur. It could be anywhere from all the way back when the mods were being installed through to leaving the modfile.zip file in the root folder of Files on your device. This is why it is good not to install every mod known straight up and go slowly until you are confident with the process first, then explore the boundaries. After the frustrating time of long and drawn out fault finding session, take a break and try again... Mods that add or modify content in folders other than 'override' ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - Some mods can also place changes into lang\sounds, movies, music, or scripts folders and these will need special attention... - If you are not aware of what the files are, you may be able to look at the mod folders and the install .tpa to determine what the maybe. Unfortunately, I can't tell you which ones they are so it is a case of bringing in the Sherlock part of you to do some investigating. - If you are aware of what the modded/additional content is, then you can create the file structures below, copy individual files across adding them before creating your modfile. For additional sound (voice) packs/files... - Install the sound pack mod. The additional voice files are generally installed to \lang\en_US\sounds. - Create a new folder called: E:\BD Android\BG2EE 2.5.16.6 Modfile\sounds (not \lang\en_US\sounds) - Copy the additional sound files to this folder. Add the folder to your modfile when you create it. For addition scripts... - Create a new folder called: E:\BD Android\BG2EE 2.5.16.6 Modfile\scripts - Copy the additional scripts to this folder. Add the folder to your modfile when you create it. Not tested, but should work: For additional music... - Create a new folder called: E:\BD Android\BG2EE 2.5.16.6 Modfile\music - Copy the additional music to this folder. Add the folder to your modfile when you create it. (Note: This did not work for @trinit. His methods was to place the music folder and dialog.tlk into a centralfixed .zip file and place it into the root of /Files). According to IESDP (https://gibberlings3.github.io/iesdp/) ,the '\music' folder is not an override folder. Using PC installed Mods ~~~~~~~~~~~~~~~~~~~~~~~ If you also have the game (must be the same version) installed on your PC and you wish to use the same mod configuration on your Android device, there is no need to reinstall the mods. - Sitting in your Game folder, right click on 'override' and copy the entire folder to: E:\BD Android\BG2EE 2.5.16.6 Modfile\ - Copy your \lang\en_US\dialog.tlk to: E:\BD Android\BG2EE 2.5.16.6 Modfile\lang\en_US\ - If the mods used also adds additional content in other folders, create appropriate folders in the modfile folder and copy content. Create the modfile (eg: BG2EE.2.5.16.6.Modfile.Gus.PCGameMods.zip or whatever suits), copy to device and unpack as detailed above. ====== Section 4 - Editing Your Saved Game\Modifying Game Content ====== Some, or is that most, players would like to be able to open their saved game, character file, or just play with EEKeeper to adjust their game as they see fit. The same for NearInfinity. This can't be done natively on your Android device, however, using the environment setup for modding, you now have the opportunity. EEKeeper ~~~~~~~~ To setup EEKeeper: Create additional folders called: E:\BD Android\BG2EE 2.5.16.6 Files (This emulates the Files folder of your game on the device) E:\BD Android\BG2EE 2.5.16.6 Files\character (This is where to place your .chr files) E:\BD Android\BG2EE 2.5.16.6 Files\portraits (This is where to place your custom portraits) E:\BD Android\BG2EE 2.5.16.6 Files\save (This is where to place your saved games) E:\BD Android\EEKeeper (This is where to copy EEKeeper) I also keep a backup of my modified 'baldur.lua' in 'E:\BD Android\BG2EE 2.5.16.6 Files' keeping all my game data together. It is also a good place to backup your vanilla dialog.tlk in 'E:\BD Android\BG2EE 2.5.16.6 Files\lang.Vanilla\en_US\'. - Unpack EEKeeper into 'E:\BD Android\EEKeeper' and run once to create the eekeeper.ini file. You can setup your paths by one of two methods: 1. Run EEKeeper, select 'Settings' then 'Installation Directory' - Create or Add a Profile called 'BG2EE 2.5.16.6' (do not use the quote symbols). This of course is not prescriptive and you can call it whatever you want. Tis only a suggestion. - Set the Installation Directory to 'E:\BD Android\BG2EE 2.5.16.6'. This is a little bit more restrictive. It needs to be the name of the folder that you use to install the mods into. The one that contains 'chitin.key' in the root... - Select Game Language (English in my case) - Setup User Save Data Directory to 'E:\BD Android\BG2EE 2.5.16.6 Files' (recommended). This is also slightly restrictive. If you decide to use E:\BD Android\BG2EE 2.5.16.6 Files\save, then you also need to tick 'Use Custom Save Location'. If you use the recommended location, do not tick the box. The difference is that when using Custom Portraits and the recommended path, your portrait will show in the saved game (assuming you have it copied there). You can also allocated a custom portrait within EEKeeper from here and it will show in the game. or 2. Copy the lines below into eekeeper.ini (changing the paths were necessary: [BG2EE 2.5.16.6] Install Path = E:\BD Android\BG2EE 2.5.16.6\ Save Directory = E:\BD Android\BG2EE 2.5.16.6 Files\ Language = lang\en_US\ Custom Save Directory = false You can also quickly create other profiles such as BG1EE etc..., just place a blank line between each section. [BG1EE 2.5.16.4 Beta] Install Path = E:\BD Android\BG1EE 2.5.16.4\ Save Directory = E:\BD Android\BG1EE 2.5.16.4 Files\ Language = lang\en_US\ Custom Save Directory = false - To copy your saved game and any other game data, connect your device and navigate to: Android/data/com.beamdog.baldursgateiienhancededition/files/ You can copy the character, portraits, save folders (if they exist) directly into there respective folders in E:\BD Android\BG2EE 2.5.16.6 Files\ - If you only want one (or just not all of them) game, then navigate to 'Android/data/com.beamdog.baldursgateiienhancededition/files/save' and copy the entire saved game folder (ie '000000001-Gus - Start') to the following folder: E:\BD Android\BG2EE 2.5.16.6 Files\save You should now have 'E:\BD Android\BG2EE 2.5.16.6 Files\save\000000001-Gus - Start' with the game files inside the last folder. You are now ready to start playing with your saved game files. When you open EEKeeper, you should now be able to select the BG2EE 2.5.16.6 Profile (Files, Profiles, BG2EE 2.5.16.6 for those who haven't used it before), then open a saved game, and it should be in the Open Single Player Saved Game dialog box. Select it and click OK. If you also want to be able to edit Black Pits or Multiplayer games, then you will need to create the folders that their games are saved into, ie: E:\BD Android\BG2EE 2.5.16.6 Files\bpsave E:\BD Android\BG2EE 2.5.16.6 Files\mbpsave E:\BD Android\BG2EE 2.5.16.6 Files\mpsave etc NearInfinity ~~~~~~~~~~~~ NearInfinity requires Java Runtime to run so make sure you install that first. I haven't used NearInfinity much in the Android Modfile environment, but you can copy NearInfinity.jar to each game folder (where chitin.key is and where you setup your mods) and run it from there. This will open the game and allow you to play around with the game files. If you want to open a saved game, it is likely you need to 'Open File' and navigate to the saved game file (Unless someone can tell me how to modify the default locations). If you just want the one NearInfinity.jar, then you can copy it to the root of 'E:\BD Android' and, using Open Game, navigate to the game that you want to edit. End of Story ~~~~~~~~~~~~ Well, that is about it. It is a lot to take in so read and step through it a couple of times. Once the process is understood and your confident, you will be doing it with your eyes closed... If something else comes up through finding errors, questions or game changes etc, I will update this document. I hope you enjoy and get the most out of modding your game! Gather Your Party... Gus ====== Addendum 1 - Repackage method for BG SoD ====== When attempting the procedure above to repack the BGSoD patch.obb, it was found that there were duplicate files (UPPERCASE and lowercase names) in the '\music' folder. This meant that the patch.obb could not be unpacked on file systems that are not case sensitive like Windows. The idea then is to leave the patch.obb complete extracting the dialog.tlk then replacing it with the empty file (000.000) to bring the patch.obb back to size. Conducting tests, this procedure worked on the other games patch.obb as well, and will most likely replace the method above in future releases of the document (if any required). Repackaging the BGSoD .obb ~~~~~~~~~~~~~~~~~~~~~~~~~~ - Copy patch.xxxx.com.beamdog.siegeofdragonspear.obb to E:\BD Android\patch.xxxx.com.beamdog.siegeofdragonspear.obb - Find the file size (in bytes) of 'patch.xxxx.com.beamdog.siegeofdragonspear.obb' (look at the properties of the file) eg: (1,873,806,917 bytes). - Rename the patch.obb to patch.zip. - Open patch.obb using WinRAR or 7Zip and navigate to the lang/en_US folder. - Copy the dialog.tlk to 'E:\BD Android\BGSoD 2.5.x.x\lang\en_US' to setup as the vanilla as detailed above. - Leaving WinRAR/7Zip Find the size new of the patch.zip, - Determine the diffence between the original size and new size to determine the size of 000.000. - Remove a futher 148 bytes. original patch.obb size - new patch.obb size - 148 = size of 000.000 1,873,806,917 - 1,865,125,529 = 8,681,388 8,681,388 - 148 = 8,681,240 - Build 000.000. fsutil file createnew 000.000 8681240 - Drag and drop 000.000 to the /lang/en_US in the patch.zip and close WinRAR/7Zip. - Check the file size of the patch.zip. If the size is different, caclulate the file size that 000.000 was supposed to be, then create new 000.000, delete the old version and place the new version in. Ceck size again. Repeat until file size is correct. - Drag 'patch.xxxx.com.beamdog.siegeofdragonspear.zip' onto centralfix. - Rename from .zip to .obb. The file is now ready to place onto your device. Testing needs to occur as detailed above with a vanilla dialog.tlk to confirm repacking worked as expected. Once this is done, you can move onto modding. What's with the 148 bytes ~~~~~~~~~~~~~~~~~~~~~~~~~ I repacked a couple of different games using this method. The outcome of creating 000.000, adding to the .zip, checking the size, recreating 000.000 with a new size etc, for a couple of these games was that the 000.000 was always 148 bytes to large. For future attempts, I just remove the 148 first before making 000.000 and there wasn't a need to create a new 000.000 again. Why 148 bytes you may ask? Yeah, I would like to know as well but, I am guessing here, it may be the size of an entry in the index of the zipped file. Modding ~~~~~~~ Modding BGSoD and creating modfiles are conducted as detailed above. The only thing that needs to be remembered is that the Android BGSoD is a standalone game and doesn't contain some files or references that are in BG1EE (which may be required by a mod being installed). Some way around it, for files, would be to copy the necessary files to the override folder prior to installing the mod (or the second time you install the mod because it didn't work in the first instance...). It will be a hit and miss event and some mods may not work at all that were successful with BG1EE and SOD as a DLC. --------------------------------------------------------------------------- File Log: v1.1 - 16 Jul 2018: Added BGSoD repackage method; minor text and format changes v1.0 - 12 Jul 2018: Initial Release --------------------------------------------------------------------------- ====== End of File ======