Problem
Users operating a tModLoader server on the hosting platform may encounter situations where the available tModLoader version is outdated, leading to incompatibility with newer mods. To ensure optimal functionality and support for the latest modifications, it is necessary to update the server to a specific, desired tModLoader version.
Solution: Updating Your tModLoader Server Version
To configure your tModLoader server to run a specific version and ensure compatibility with current mods, follow these detailed steps:
-
Identify the Desired tModLoader Version Tag
The first step is to locate the precise version tag for the tModLoader version you intend to use. These tags are publicly available on the official tModLoader GitHub repository.
- Visit the tModLoader GitHub Tags page.
- Browse the list of tags and make a note of the exact tag corresponding to your desired version (e.g.,
v2025.12.3.0).
-
Configure the Server Startup Argument
Access your server's control panel to apply the chosen tModLoader version.
- Navigate to the Startup tab within your server's control panel.
- Locate the input field or argument designed for specifying the tModLoader version (this may be labeled as
TML_VERSIONor similar). - Enter the exact version tag you identified in Step 1 into this designated field.
-
Prepare for Reinstallation
To prevent conflicts and ensure a clean installation of the new version, existing tModLoader files must be removed.
- Proceed to the Settings tab in your server's control panel.
- Important: Delete all files on your server. Ensure you exclude any world files you wish to preserve before initiating the deletion process. This step is crucial for a successful version update.
-
Reinstall the Server Files
Once the old files are removed, trigger a reinstall to download and set up the correct files for the specified tModLoader version.
- On the Settings tab, locate and click the "Reinstall" button.
- The system will then download and install the tModLoader files corresponding to the version you specified in the Startup tab.
Upon completion of these steps, your tModLoader server will be running the chosen version, enhancing compatibility with the latest mods and features.
