THIS SOFTWARE IS IN BETA. PLEASE LET ME KNOW IF YOU HAVE ANY ISSUES WITH THE APPLICATION. The TML GOG Patcher provides a simple cross-platform method for applying tModLoader (TML) patches to the Good Old Games (GOG) versions of Terraria. Table of Contents Table of Contents Description Known Bugs Application Features Installation Options Usage Guide Windows Installation Instructions Mac Installation Instructions Linux Installation Instructions Publishing Mods Downloads Patch Files Future Plans This application provides an easy way to install the client and server patches, as well as required dependency files, to allow those who own the GOG version of Terraria to create and utilize tModLoader mods. The process is straight forward: enter or browse for the directory containing the Terraria.exe and TerrariaServer.exe files, select the desired options, click the Install button, and wait for the installation process to complete. The actions taken during installation are displayed in the text box at the bottom of the application as well as written to a log file that can be accessed via the View Log button at the top left. Additionally, several buttons are provided at the top right which allow quick access to various TMLGOGPatcher, Terraria, and tModLoader folders (such as Patches, Mods, Players, and Worlds) and web pages, as well as the application About dialog which contains information about the application and licenses associated with it and the libraries and assets it makes use of. Additionally, next to the View Log button, there is a Patch Tools dropdown menu that allows the user to download a TML GOG Patch files. Lastly, on Windows, there are two buttons next to the Patch Tools menu that will allow the user to start Terraria (either from the unpatched client file or the backup client file) and tModLoader (either from the patched client file or the generated TML client file). Known Bugs On Linux, the logging text box does not always update properly when resizing or scrolling, resulting in black lines being drawn across the box at weird positions and obscuring the text. A solution is being looked into, but for now use the View Log button and read the log file to determine success or failure of installation. On Linux, occasionally the application will lock up when patch files are added or removed from the patches folder. There is currently no solution to this issue, so for now if it happens, then restart the application. As of 2016/12/17 v22.214.171.124, this dialog has been disabled on Mac. -- On Mac, the Patch Tools Download dialog does not work. A solution has not been found yet, so for now please manually download patch files from the TML GOG Patcher Website or Wiki, which can be found through the Visit Webpages menu, with your browser and manually place them in the patches folder, which can be found through the Open Folders menu. The Linux and Mac interfaces don't look great. This will be solved at some point in the future, but for now they are acceptable. Application Features Control which aspects of TML is installed: client, server, and/or dependency files. Control if the Terraria client and/or server is overwritten by TML or if new exe files are created. Keeps a log of installation attempts to help with trouble shooting should problems occur. Provides easy access to TML GOG Patcher, Terraria, and tModLoader folders and websites. Most important of all, the Terraria files are verified before and after installation to ensure that the proper patch is applied and that it is applied successfully. Installation Options Terraria and TML version selection dropdowns allow the user to select which version of Terraria is to be patched and which version of tModLoader it is to be patched with. These options will be automatically updated when patches are added or removed from the patches directory and will be set to the best matching patched if one is found. The ability to set non-matching values is allowed in case the version number of the Terraria files is not updated appropriately, which has happened occasionally with past updates to the game. Overwrite Client and Overwrite Server check boxes control whether the Terraria.exe and TerrariaServer.exe files are patched directly or if tModLoader.exe and tModLoaderServer.exe files are generated instead. The default on Windows is to overwrite Terraria.exe and to generate tModLoaderServer.exe. On Linux and Mac, the default is to overwrite both the client and server and it is recommended to leave both selected as there is currently no mechanism to launch TML if the original files are not overwritten. Install Client, Install Server, and Install Dependencies check boxes allow the user to install all or specific pieces of TML. This is useful if the user needs to reinstall lost dependency files, is just patching a server, or in other similar situations, though generally one will want all three boxes checked. Usage Guide The first step is to download the TML GOG Patcher application for your operating system from the download links below: Downloads After downloading the application, you will need to download the patch for the version of Terraria that you are currently using from the links below: Patch Files If you don't know what version you are using, then you can start Terraria and find the version in the bottom left corner of the main menu screen or you can start the TML GOG Patcher, browse to the location of the Terraria.exe file, and you will see the version number in the status bar at the bottom of the application. Once the patch file is downloaded, it needs to be placed in the TML GOG Patcher's patches folder. The patches folder is located in the TMLGOGPatcher folder which is located along side Terraria's players and worlds folders. The patches folder can also be opened from the Open Folders menu in the TML GOG Patcher's toolbar. Once the patch file is in the patches folder, TML GOG Patcher will see it if the application is already running, otherwise start the application. Lastly, select the Installation Options and click the Install button and the application will patch up Terraria with TML and then you should be ready to enjoy Terraria with mods. Windows Installation Instructions Download and unzip Windows TMLGOGPatcher_WindowsRelease.zip from below. The TMLGOGPatcher.exe should now be ready to run by double-clicking. Mac Installation Instructions Download and unzip Mac TMLGOGPatcher_MacRelease.zip from below. Download and install the mono package (Instructions): Download TMLGOGPatcher.exe should now be ready to run through the terminal: Code: mono <location>/TMLGOGPatcher.exe Linux (Ubuntu) Installation Instructions Download and unzip Linux TMLGOGPatcher_LinuxRelease.zip from below. Install mono package through the terminal (Instructions): Code: sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF echo "deb http://download.mono-project.com/repo/debian wheezy main" | sudo tee /etc/apt/sources.list.d/mono-xamarin.list sudo apt-get update echo "deb http://download.mono-project.com/repo/debian wheezy-apache24-compat main" | sudo tee -a /etc/apt/sources.list.d/mono-xamarin.list TMLGOGPatcher.exe should now be ready to run through the terminal: Code: mono <location>/TMLGOGPatcher.exe Publishing Mods UPDATE: As of tModloader version 0.9.2.0, the TML gui will prompt GOG users to visit the TML Registration web page and to enter both their TML Passphrase and Steam ID, greatly simplifying the process of setting your installation up to publish mods to the ModBrowser. Pre-0.9.2.0 Publishing Setup Steps As of tModLoader version 0.9.x.x for Terraria 126.96.36.199, it is now possible for modders who use GOG TML to publish mods to TML's ModBrowser. To set up your TML installation to make mod publishing possible, follow the below steps: Visit http://javid.ddns.net/tModLoader/register.php in your browser and log in using your Steam Account. That web page will display your Steam ID and your TML Passphrase, take note of both of these. Open TML's /Terraria/ModLoader/config.json file in a text editor. Find the SteamID64 element in the config.json and enter your Steam ID from the web page. Code: "SteamID64": "00000000000000000" Find the ModBrowserPassphrase element in the config.json and enter your Passphrase from the web page. Code: "ModBrowserPassphrase": "a0000a0000000a00000a0000a0000a00" Save the config.json file and you are all set to publish, manage, and unpublish your mods. Downloads Version: 188.8.131.52 (2016/12/17) Tested On: Windows 7 | Mac 10.7 Lion | Linux Ubuntu 16.04 Download: Windows | Mac | Linux Thread: <HERE> Wiki: http://wiki.vinlandsolutions.net/doku.php/terraria/tools/tml_gog_patcher Gitlab Repo: https://gitlab.com/terrariatools/TMLGOGPatcher All Releases: https://gitlab.com/terrariatools/TMLGOGPatcher/tags Patch Files Terraria v184.108.40.206: TMLGOGPatch_0.9.2.3_Windows.dat Older Windows Patches Terraria v220.127.116.11: TMLGOGPatch_0.9.2.2_Windows.dat Terraria v18.104.22.168: TMLGOGPatch_0.9.2.1_Windows.dat Terraria v22.214.171.124: TMLGOGPatch_0.9.2.0_Windows.dat Terraria v126.96.36.199: TMLGOGPatch_0.9.1.0_Windows.dat Terraria v188.8.131.52: TMLGOGPatch_0.9.0.3_Windows.dat Terraria v184.108.40.206: TMLGOGPatch_0.9.0.2_Windows.dat Terraria v220.127.116.11: TMLGOGPatch_0.8.3.5_Windows.dat Terraria v18.104.22.168: TMLGOGPatch_0.8.3.4_Windows.dat Terraria v22.214.171.124: TMLGOGPatch_0.8.3.3_Windows.dat Terraria v126.96.36.199: TMLGOGPatch_0.8.3.2_Windows.dat Terraria v188.8.131.52: TMLGOGPatch_0.9.2.3_Mac.dat Older Mac Patches Terraria v184.108.40.206: TMLGOGPatch_0.9.2.2_Mac.dat Terraria v220.127.116.11: TMLGOGPatch_0.9.2.1_Mac.dat Terraria v18.104.22.168: TMLGOGPatch_0.9.2.0_Mac.dat Terraria v22.214.171.124: TMLGOGPatch_0.9.1.0_Mac.dat Terraria v126.96.36.199: TMLGOGPatch_0.9.0.3_Mac.dat Terraria v188.8.131.52: TMLGOGPatch_0.9.0.2_Mac.dat Terraria v184.108.40.206: TMLGOGPatch_0.8.3.5_Mac.dat Terraria v220.127.116.11: TMLGOGPatch_0.8.3.4_Mac.dat Terraria v18.104.22.168: TMLGOGPatch_0.8.3.3_Mac.dat Terraria v22.214.171.124: TMLGOGPatch_0.8.3.2_Mac.dat Terraria v126.96.36.199: TMLGOGPatch_0.9.2.3_Linux.dat Older Linux Patches Terraria v188.8.131.52: TMLGOGPatch_0.9.2.2_Linux.dat Terraria v184.108.40.206: TMLGOGPatch_0.9.2.1_Linux.dat Terraria v220.127.116.11: TMLGOGPatch_0.9.2.0_Linux.dat Terraria v18.104.22.168: TMLGOGPatch_0.9.1.0_Linux.dat Terraria v22.214.171.124: TMLGOGPatch_0.9.0.3_Linux.dat Terraria v126.96.36.199: TMLGOGPatch_0.9.0.2_Linux.dat Terraria v188.8.131.52: TMLGOGPatch_0.8.3.5_Linux.dat Terraria v184.108.40.206: TMLGOGPatch_0.8.3.4_Linux.dat Terraria v220.127.116.11: TMLGOGPatch_0.8.3.3_Linux.dat Terraria v18.104.22.168: TMLGOGPatch_0.8.3.2_Linux.dat Future Plans Write up a proper usage guide with images and step by step instructions. Implement better looking interfaces for Linux and Mac versions. Provide standalone versions for Linux and Mac that don't require installation of Mono. Provide the Mac version as a bundled .app package. Provide Windows, Linux, and Mac installers instead of or perhaps in addition to the zips. This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. Utilised assets are released under various licenses, see the included Lincenses.txt file for details.