Connect to a tModLoader (modded) server

How to join a modded tModLoader server and get your client running the exact same mods, which is what nearly every failed connection comes down to.

2 min read · Updated Sep 24, 2026 · By GuavaHost Team

tModLoader is a modded version of Terraria. Joining a tModLoader server works almost the same way as vanilla, with one extra rule: your client has to be running the same mods, at the same versions, as the server. Get that right and the rest is easy.

Find the address in the panel

1. Sign in at customer.guavahost.com, open My servers and click Manage on your tModLoader server.
2. At the top of the server page, note the IP and port, for example 123.45.67.89:7777. There is a copy button next to it, and the Ports & network card on the Overview tab lists it too.
3. Confirm the server is up by opening the Console tab and waiting for it to finish loading mods and the world.

Get the same mods on your client

This is the important part. tModLoader will refuse the connection if your enabled mod list does not match the server.

1. Launch tModLoader (not plain Terraria) from Steam.
2. On the main menu, open Workshop, then Download Mods to open the in-game Mod Browser.
3. Download every mod the server runs. If you are not sure of the full list, ask the server owner or check the enabled.json file in the server's Mods folder on the Files tab.
4. Go to Workshop, then Manage Mods, and enable exactly those mods. Turn off anything the server does not run.
5. Click Reload Mods so your changes take effect.

Join the server

1. From the tModLoader main menu, click Multiplayer, then Join via IP.
2. Pick your character.
3. Enter the IP, then the port from the panel.
4. Enter the join password if the server has one, then connect.

Why the mod lists must match

Every mod changes items, enemies, or world data, so the server and every player have to agree on precisely which mods are loaded. If your list is missing a mod, has an extra one, or runs a different version, the two sides cannot stay in sync and tModLoader blocks the join to protect the world.

Troubleshooting

• "You cannot connect because the server requires the following mods": you are missing one or more of the server's mods, or have not enabled them. Download and enable that exact list, then Reload Mods.
• "Your version of a mod does not match the server": the mod is installed but the version differs. Update it in the Mod Browser so both sides are on the same version.
• tModLoader version mismatch: your tModLoader itself must match the server. Check the version under Startup settings on the server's Settings tab and make sure Steam has updated your copy to the same build.
• It connects then drops during load: a heavy modpack can take a while, and a low-memory server can stall. If it keeps happening, the server may need more RAM, which you can add with Manage plan in the server menu, then Change plan. Billing is prorated.
• Right mods, still refused: press Restart at the top of the server page so it fully reloads its mod list, then retry.

Still stuck? Jump into our Discord at discord.gg/GuavaHost and the team will help you out.

• tmodloader
• modded
• connecting
• mods
• multiplayer

Host a Terraria server From $2.49/mo, with instant setup and DDoS protection.

Still need help? Our team is online 24/7 to answer questions.

Contact support