Terraria: TShock Crossplay Setup Guide
By default, the PC (Steam/GOG) and Mobile (iOS/Android) versions of Terraria are not compatible due to versioning differences. However, using the TShock API and the Crossplay plugin, you can enable a bridge that allows players from all platforms to collaborate in the same world.
1. Requirement: TShock
Crossplay does not work on vanilla servers. You must first install TShock for Terraria 1.4.4.9+ onto your dedicated server.
2. The Plugin
You need the Crossplay.dll file. This acts as a translator, adjusting packets from mobile clients so they "make sense" to the PC-based server.
3. Version Matching
Ensure your server version matches the current "Mainline" version on Mobile. If Mobile is on 1.4.4.9 and PC is on 1.4.5, crossplay will break until the plugin is updated.
Step-by-Step Installation
- Download the latest release of Crossplay from the Official GitHub Repository.
- Access your server via FTP or the built-in File Manager.
- Navigate to the
/ServerPlugins/directory. - Upload the
Crossplay.dllfile. - Restart your server to initialize the plugin.
Configuration & Troubleshooting
Upon the first launch, TShock will generate a configuration file located at /tshock/crossplay.json. You can edit this to customize the experience:
- ClientSideCharacters: It is recommended to enable this if you want mobile players to have persistent inventories that aren't tied to their local device.
- VersionSpoofing: The plugin automatically spoofs the version number to allow connections. If a player gets an "Outdated Client" error, check if
VersionSpoofingis enabled in the config.
Common Issues
| Problem | Solution |
|---|---|
| "Connection Lost" (Immediate) | Ensure your Firewall/Router is allowing the mobile device's IP. |
| Infinite "Found Server" | The Query Port (usually Port +1) might be blocked. Crossplay requires both the Game and Query ports. |
| Missing Items | PC-exclusive items may appear as "unnamed" or glitched on older Mobile versions. Update the Mobile app! |
Console Support: While Crossplay.dll primarily bridges PC and Mobile, some experimental versions also allow Xbox and PlayStation players to join if they use a "DNS Redirect" method on their consoles to point to your server IP.
Play with everyone, everywhere. Host your Terraria TShock server with Supercraft and enjoy instant plugin support and a pre-configured crossplay environment for your community.