iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more
tModLoader must run on the server and on every player’s client. The reliable process is to build and test a mod pack on a PC, save the pack from tModLoader’s Workshop menu, copy its files to the server’s Mods folder, and start the server while watching the console. Clients and server must use the same mod versions. There is no verified, current ranking of individual mods in the available source material, so this guide explains how to choose a suitable pack and install it without pretending that one mod is universally “best.”
What “best Terraria mods” should mean
A good mod is not automatically the best choice for every world. The right pack depends on the experience your group wants, the server hardware and host, and whether everyone can keep the same files and versions. Treat “best” as a compatibility and fit decision rather than a permanent top-ten list.
Recommended Free Tools
Start with the group’s goal
- More content: Choose a pack whose progression, bosses, items and biomes all fit the amount of play time your group expects.
- Convenience: Quality-of-life changes can reduce repetitive work, but every added mod still has to be installed and kept in sync.
- Building and exploration: Prioritize mods that support the activities your players actually do instead of adding unrelated systems.
- Higher difficulty: Make sure everyone agrees to the extra challenge before creating the world; changing the rules mid-world can make progression confusing.
These are selection criteria, not endorsements of named mods. The available installation sources do not provide a tested ranking or a current recommendation list, and the title of one host article mentioning a particular mod is not evidence that it is the best choice.
Check compatibility before you subscribe
Read each mod’s current Workshop description and dependencies, then verify that the author supports the tModLoader branch your server will run. Do not assume that a mod that loaded last year will load after an update. Record the exact versions you tested and distribute the resulting pack rather than asking players to assemble it independently.
#1 Best Overall
- Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
- Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
- Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
- Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
- 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
How tModLoader multiplayer works
Terraria itself does not load server-side mods by simply placing files beside a vanilla server. The server must run tModLoader, and each player connecting to it must also launch tModLoader with the matching mods enabled. During connection, the game detects differences between the client and server lists or versions. A common result is the message “Mod Version Mismatch.”
The server’s Mods directory contains the compiled .tmod files and the pack metadata. On the client, the same mods are enabled through tModLoader’s interface. A successful connection therefore requires all of the following:
The Tool Desk
Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →- tModLoader installed on the server.
- tModLoader installed on every client.
- The same mod names enabled on both sides.
- The same mod versions on both sides.
- Any required dependencies present and enabled.
A vanilla world can remain on a host after a reinstall, but one hosting guide recommends giving a modded world a new name. That separates experimental mod changes from an existing vanilla save and makes rollback easier.
Prepare before installing anything
Choose where the server will run
| Server type | What the sources describe | Important consideration |
|---|---|---|
| Hosted control panel | Some panels expose tModLoader as an application or a Server Type setting. | Menu names and file access differ by host. Follow that host’s documentation for the exact path. |
| Self-managed Linux | A dedicated-server management script can install tModLoader from GitHub or SteamCMD. | The official wiki prefers SteamCMD for this workflow. |
| Docker | Docker is described as another recommended way to run the server. | Persist the world and Mods directories outside the container so recreating a container does not erase them. |
Back up worlds and configuration
Stop the server and copy the world files before changing the server type or mod set. Keep a separate copy of the current Mods folder, enabled.json, and install.txt. A backup is especially important when a host’s reinstall process preserves worlds automatically: preservation is useful, but it also means an incompatible mod can be applied to an old save by accident.
Agree on one pack
Have one person create the pack and test it first. Give the group the saved pack or a precise list of enabled mods, not a mixture of screenshots and manually typed names. This eliminates spelling differences and makes future updates reproducible.
Rank #2
- 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
- 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
- Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
- 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
- What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
Install tModLoader on a hosted server
Panels do not share a universal interface, but the workflow described by hosting guides is consistent.
Quick wins for a faster PC:
Repair Windows errors before they cause bigger problemsFix Now →Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Clear out junk files and repair common Windows errorsFree Scan →- Open the server’s control panel and stop the running server.
- Open the installation, application or server-type selector. Choose the entry labeled tModLoader or set Server Type to tmodloader.
- Apply the change. If the panel offers a reinstall, read its warning and confirm that your world and configuration backups are stored elsewhere first.
- Start the server once with no custom pack. Watch the console for a normal tModLoader startup, then stop it. This creates or confirms the expected directory structure.
- Use the panel’s file manager or SFTP to open the server’s
Modsdirectory. - Upload the pack files described in the next section, preserving their names and extensions.
- Start the server again and keep the console visible while each mod loads.
If your panel does not offer tModLoader, do not upload files into a vanilla server and expect them to work. Ask the host whether it supports tModLoader or use a server you control with the self-managed or Docker method.
Install tModLoader on a self-managed Linux server
The sources describe a dedicated-server management script that installs tModLoader from GitHub or SteamCMD. The official wiki prefers SteamCMD for this task. Because script commands and release packages change, use the current instructions from the official tModLoader documentation and the script’s own repository rather than copying an old command from a forum post.
- Create a dedicated, non-root account for the game server and a directory that will hold the installation and saves.
- Install the prerequisites specified by the current tModLoader documentation, then install SteamCMD if you are following the wiki’s preferred route.
- Run the dedicated-server management script or SteamCMD procedure to install the tModLoader server files.
- Launch the server once and stop it cleanly. Confirm that the generated world and
Modsdirectories are in the location your service will use. - Copy the tested pack into that
Modsdirectory, or configure the script to use the pack’s metadata when supported. - Run the server under a service manager or persistent terminal session, and record the exact startup command for the rest of the administrators.
Do not mix files from a different tModLoader installation into the directory. If you change the loader version, retest the entire pack before inviting players.
Build and save the mod pack on your PC
Build the pack with the same tModLoader branch that the server will use.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Rank #3
- Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
- Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
- Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
- Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
- What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
- Install and launch tModLoader on the PC that will manage the pack.
- Open the Workshop browser and subscribe to the mods you have selected. Subscription downloads the Workshop content to that client; it does not by itself configure your dedicated server.
- Return to tModLoader’s Mods screen and enable the selected entries.
- Use Reload Mods when prompted. Read the messages for missing dependencies or load failures before continuing.
- Open Workshop → Mod Packs and save the enabled list as a pack.
- Open the pack folder and verify that it contains the compiled
.tmodfiles,enabled.json, andinstall.txt. - Launch a test world locally. Check the features your group intends to use, then exit and keep the saved pack unchanged for upload.
The saved pack is preferable to manually downloading files because it captures the exact enabled set. Keep an archive of each tested pack with a date or version label so you can restore the previous set if an update breaks the world.
Upload the pack correctly
Copy the compiled files
Upload every required .tmod file from the saved pack into the server’s Mods folder. Do not rename the files, remove dependencies, or copy only the mod you consider the main feature. A dependency that is missing on the server can prevent the whole set from loading.
Keep install.txt
Workshop mods need install.txt because the Workshop does not identify them by the human-readable mod names alone. Keep the generated file in the pack and upload it with the other metadata. Do not replace it with a hand-written list unless your host’s documentation explicitly instructs you to do so.
Check enabled.json
enabled.json records which mods tModLoader should enable. Each name is written without the .tmod extension, quoted and separated by commas. A syntax example is:
["YourModName","AnotherMod"]Use the names generated by tModLoader, including capitalization, rather than the display text you remember from a web page. If you edit the file, keep it valid JSON; a missing quote or comma can make the server ignore the list or report a parsing error.
Rank #4
- Dual Converters, Infinite Potential：Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
- Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
- Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
- Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
- Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
Start the server and verify the result
- Start the tModLoader server with the uploaded pack in place.
- Watch the console from the first load line through world selection. Look for a completed mod-loading stage and note any warning or error that names a mod.
- Stop the server if a required mod fails to load. Fix the pack before players connect; repeatedly joining a half-loaded server makes diagnosis harder.
- Connect with one client that uses the identical saved pack. Confirm that the client reaches the world without a version warning.
- Test a second client before opening the server to the whole group. Have that player exercise the most important content or settings.
Console output is the authoritative first diagnostic. A server that reaches a world-selection prompt is not necessarily healthy if the log also reports disabled dependencies, skipped files or a load exception.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Fix common failures
“Mod Version Mismatch”
This message means the server and a client are running different mod versions. Stop both sides, compare the saved pack, and make the client subscribe to or copy the same release that is on the server. Do not solve it by disabling random entries: the enabled names must also match. Restart tModLoader after changing the client set, then reconnect.
A mod is missing on the server
Check that its .tmod file, install.txt and enabled.json are in the server’s actual Mods directory, not a similarly named upload or cache directory. Confirm that the panel has finished uploading before starting the server. If the host automatically manages Workshop downloads, follow its documented process; otherwise upload the complete pack manually.
The server loads but a dependency error appears
Return to the PC pack, enable the dependency identified in the error, reload mods and save the pack again. Upload the revised complete set rather than only the newly discovered file. If the dependency is incompatible with the chosen loader branch, remove the dependent mod or select a supported release.
The console reports a load exception
Record the first mod named in the error and the loader version shown at startup. Test the pack locally with that entry disabled, then re-enable it after updating or correcting its dependency. If the error persists, restore the last known-good pack and keep the affected mod out of the production world until its author provides a compatible version.
Best Value
- 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
- Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
- Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
- HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
- What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
A world behaves differently after a change
Stop the server and restore the world backup before experimenting further. Use a newly named modded world for testing, as one hosting guide recommends, so a failed experiment does not become the only copy of an existing save.
The host’s Workshop behavior is unclear
Published guides disagree about automatic Workshop downloads. One says the server does not download Workshop mods itself; another says the official script can download mods listed in install.txt. This behavior depends on the host and installation method. Check the host’s current documentation and inspect the server’s Mods directory after startup instead of assuming either behavior.
Updating, adding or removing mods safely
Updating an existing pack
Make a copy of the working pack and back up the world. Update one logical group at a time on the test PC, reload, and play far enough to exercise the affected systems. Save a new pack only after the test succeeds. Upload it during a maintenance window, then have every client update before reconnecting.
Adding a mod
Add it to the PC pack, resolve dependencies, reload and test a copy of the world. Save the pack and upload all files, not just the new .tmod. A client that connects with the old pack will trigger a mismatch.
Removing a mod
Check whether the mod added items, blocks or world data before disabling it. Make a world backup, remove the entry on the test PC, and load a copy of the world. If the world fails to load or loses required data, restore the backup and re-enable the mod.
Free tools Windows power users keep installed
One-click scans. No signup required.
Which installation route should you choose?
| Choose this route | When it fits | Main risk to manage |
|---|---|---|
| Hosted panel | You want a graphical control panel and the host explicitly supports tModLoader. | Panel-specific paths, reinstall behavior and Workshop automation differ. |
| Linux plus management script | You need direct control over files, services and backups. | Commands and release procedures change; follow current documentation. |
| SteamCMD-based install | You want the method preferred by the official wiki for a self-managed server. | You must maintain SteamCMD, permissions and the server process yourself. |
| Docker | You already operate containers and want a repeatable deployment. | World and mod directories must be persisted outside disposable containers. |
Practical checklist
- Pick a pack that matches your group’s goal; do not rely on an unverified “best mod” ranking.
- Install tModLoader on the server and all clients.
- Back up worlds and the current pack.
- Build and test the pack on a PC.
- Save it through Workshop → Mod Packs.
- Upload every
.tmod, plusinstall.txtandenabled.json, to the server’sModsfolder. - Keep mod names in
enabled.jsonextension-free, quoted and comma-separated. - Start the server and read the complete console output.
- Give every player the identical pack and versions.
- Use a new world name or a backed-up copy for major experiments.
The Bottom Line
The dependable answer to “how do I add Terraria mods to my server?” is: run tModLoader, create one tested pack on a PC, upload its complete metadata and .tmod files, and keep every client on the same versions. Choose mods by your group’s goals and compatibility rather than an unsupported universal ranking.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
