How to Set Up Crossplay on Your Terraria Server

Terraria does not support crossplay between PC and Mobile Edition out of the box, they run on completely different codebases. The good news is that a community-made TShock plugin closes that gap, letting PC and Mobile players connect to the same server and play together.

Which plugin you need depends entirely on which Terraria version your server is running, so read the version note below carefully before installing anything.

💡 Check Your Versions First: The Crossplay plugin exists to bridge a version mismatch between the PC and Mobile clients. If your PC and Mobile players are already on the exact same Terraria version (for example, both on 1.4.5.6), a connection failure is very unlikely to be a version problem, and installing the plugin will not fix it. In that case, jump to the Troubleshooting section below before installing anything.

⚠️ Important Warning: Always make sure your server is completely stopped on your MintServers panel before uploading plugin files. Crossplay also requires TShock, an enhanced Terraria server type. If your server is currently running Vanilla or tModLoader, you will need to switch it to TShock first, which reinstalls your server software.

Step 1: Switching Your Server To TShock

Crossplay is a TShock plugin, so your server needs to be running TShock before you can install it. If you are already on TShock, skip ahead to Step 2.

Log into your MintServers panel and click the Stop button to safely shut down your server.
Take a backup of your world first! Switching server types reinstalls your server files, and while your world save is preserved, it is always safer to have a backup on hand.
Open Game Swap on your panel and change it to Terraria TShock.
This first boot generates your TShock configuration files and can take a minute longer than usual.

💡 Pro Tip: On first boot, TShock prints a one-time setup code to the console that looks like To setup the server, join the game and type /setup xxxxxxx. Join your server and type that command in chat to claim ownership, then use /user add yourname yourpassword owner to create your permanent admin account.

Step 2: Finding The Right Crossplay Plugin For Your Version

The original Crossplay plugin and its most active fork target different Terraria version ranges. Installing the wrong one for your server's version can prevent the plugin from loading correctly, so check your server's Terraria version before downloading.

Which Version Do I Need?

Terraria 1.4.4.X servers: Use the original Crossplay plugin.
Terraria 1.4.5.X servers (and newer): Use the TerrariaCrossplay fork instead, which is built specifically for 1.4.5 and later.

For 1.4.4.X: Original Crossplay Plugin

Download Crossplay.dll from the official GitHub releases page.
Open the Files tab on your MintServers panel and navigate to the ServerPlugins folder.
Upload the Crossplay.dll file into that folder.
Restart your server.

For 1.4.5.X and Newer: TerrariaCrossplay Fork

Download the latest Crossplay.dll release from the TerrariaCrossplay releases page. Make sure the release version lines up with your server's Terraria version.
Open the Files tab on your MintServers panel and navigate to the ServerPlugins folder.
Upload the Crossplay.dll file into that folder, overwriting the old one if you are upgrading from the 1.4.4.X version.
Restart your server.

    📁 server (your server's TShock directory)
            📁 ServerPlugins (upload Crossplay.dll here)
        

Start Your Terraria ServerUnlimited RAM · Unlimited slots · From $9.99/month

Start My Server

Step 3: Connecting From Mobile

Once Crossplay is installed and your server has restarted, Mobile Edition players can join the same way PC players do.

Open Terraria on the mobile device.
Select Multiplayer, then Join via IP.
Enter your server's IP address and Port, both found on your MintServers panel.
Tap Connect.

🛠️ Troubleshooting Common Crossplay Issues

Mobile Terraria connects over non-standard, five-digit ports just fine, so a shared port allocation on its own is not a reason Mobile would fail to connect. Work through the items below before assuming a Dedicated Port is required.

Mobile hangs on "Connecting to Session" but PC connects fine: This is very often not a version or port issue. Open tshock/config.json and check the RequireLogin setting. When RequireLogin is set to true without Server-Side Characters also enabled, TShock can lock a connecting player out until they log in, and the login prompt itself never completes, so the client just hangs. Set RequireLogin to false, save, and restart your server. Desktop clients tend to power through this without visibly failing, which is why it typically only shows up as a Mobile-side symptom.
Mobile players cannot connect: Double-check you installed the plugin build that matches your server's exact Terraria version, mismatched versions are the most common cause of a failed handshake, but only when your PC and Mobile versions actually differ.
Server won't start after uploading the plugin: Confirm the file is named exactly Crossplay.dll and sits directly inside ServerPlugins, not a subfolder.
Upgraded Terraria version and crossplay stopped working: After any server-side version update, re-check whether you are still on the correct plugin build for the new version and swap it if needed.
Plugin folder is missing: The ServerPlugins folder is created by TShock itself. If it is missing, start your server at least once after switching to TShock so it can generate its default folder structure.

With Crossplay installed, your PC and Mobile players can finally share the same world! If you run into any trouble getting the right plugin version installed, no worries! Just open a support ticket and our team will gladly jump in and get it sorted out together.