Changes: Installation guide/Troubleshooting

Latest revision as of 22:07, 13 April 2020

This is a Guide page.
This means the page will walk you through a specific task, strategy, or enemy/boss fight.

Installation guide/Troubleshooting is a complete guide on installing the launcher and client for Super Terraria World. You will find all requirements that need to be fulfilled in order to play, aswell as all known problems that can occur during the installation process of the launcher and client.

You can download the Super Terraria World Installer from the Terraria Community Forums

For ingame bugs, please report them at the STW Bug reporting site and provide as many details of the bug as you possibly can.

If for some reason you are still having an issue after doing the steps in this guide or you have found an issue not listed here, then it is recommended you join the Super Terraria World Discord, for further assistance.

**Launcher settings**
You can navigate to the launcher settings at the top left of the launcher.

Before trying any of the solutions, please make sure you meet the following requirements met:

Agree with the Disclaimer & Agreements
Ensure you have a 64-Bit Computer architecture (32-Bit needs testing).
Ensure you are using either Windows 7, 8 or 10 (Mac and Linux support will be added later on).
Ensure you have a legally owned Steam copy of vanilla Terraria installed and have run it atleast once after installing.
Ensure you have launched Terraria atleast once, to make sure you have .NET framework installed and updated.
Ensure that your steam name does not contain any weird/non standard characters. (If it does, you can change it back once you've launched STW for the first time).

If you do not have Terraria installed to the standard path (C:\Program Files (x86)\Steam\steamapps\common\Terraria) ensure that the Launcher has the correct path input in the 'Terraria Game Files' section of the settings.

If you do not use the standard Terraria saves path (C:\Users\<user>\Documents\My Games\Terraria) ensure that the Launcher has the correct path input in the 'Terraria Save Files' section of the settings, with <user> being your computers username, which you are trying to install STW on.

Below you can find a Contents menu, you can click the error you are having issues with to quickly navigate to it.

Launcher Troubleshooting

Launcher not opening/installing

If for some reason the launcher does not open or install when you run it, try running it as administrator, check to make sure you meet the requirements above and make sure your antivirus is not blocking it.

Steam login is a blank/white screen

This is an issue related to steam and not the launcher itself, there are several things that can potentially fix this. Run Steam and the STW launcher as administrator, wait a few seconds for it to load the steam elements and the login page should appear. If that does not work try reinstalling Steam (if you use a custom install folder try using the default installation path).

If that does not work then one of the following solutions can potentially help.

Clear the Steam Web Browser Cache. In Steam, go to the Web Browser section of the Steam settings and delete the Cache and Cookies.
Disabling DirectWrite for font smoothing. Again within Steam settings, go to Interface and uncheck “Enable DirectWrite for improved font smoothing and kerning”
Clearing the htmlcache directory. Go to Users\yourusername\AppData\Local\Steam and delete all the contents of the htmlcache folder. Do not delete the folder itself!
Disabling Compatibility Mode. Right click on Steam.exe (standard path is C:\Program Files (x86)\Steam), choose Properties. Next click on the Compatibility tab and uncheck any boxes that are checked, and click Apply.
Add Exceptions for Steam and SteamWebHelper. Add both Steam and SteamWebHelper as exceptions inside of your installed firewall, if none is installed then you can skip this.
Disable Chrome Embedded Framework Sandbox. Create a short-cut to Steam with the “-no-cef-sandbox” switch, if you use the default install location it would be "C:\Program Files (x86)\Steam\Steam.exe" -no-cef-sandbox

Launcher closing on Steam login

If you have Steam family sharing enabled on you steam account you will not be able to play Super Terraria World, simply disable this and you should be able to get past the Steam login screen in the STW launcher.

Unauthorized User

If you are getting the Unauthorized User error, go into your launcher settings, click Logout of steam, then close and reopen the launcher. You can find the settings button at the top left of the launcher.

Ensure that Steam is running

If you have Steam running when trying to play STW and still get this error, then run the STW launcher and Steam as administrator. If this does not work, try logging out of steam in the STW launcher and restart the launcher to log back in.

Client installation getting stuck

During the installation progress, the launcher can appear to get stuck installing, most likely this is not the case and it is installing. If however you have waited for a while and believe it is stuck, you can do the following steps to restart the installation process. Close the launcher and reopen it, then in the launcher settings located at the top left of the launcher, click Uninstall STW. This will reset the client install so you wont have missing files during your next attempt. If none of that works try rebooting your computer then try to install again.

CSteamworks error, when trying to launch the game

Make sure your paths in the launcher settings are setup correct and check to see if you have the file 'CSteamworks.dll' in your Steam\steamapps\common\Terraria folder.

Game not starting with no error message

If you do not get any error message when you try to start the Super Terraria World client, then navigating to your 'Terraria Game Files' location and run the SuperTerrariaWorld.exe as administrator and it should work.

Texture2D Crash Message

Currently, STW does not support resolutions above 1920x1080p. As a workaround, please lower your Windows resolution to 1920x1080p (not your in-game resolution).

Client Troubleshooting

Missing Tile Data

There are two issues that can cause this, the most common is if your game/save file paths are setup incorrect, please ensure that they are targeting the correct folders. If the paths are setup correct then it is most likely due to the installation process not having installed the required files, to solve this go into the launcher settings and click uninstall STW. Please refer to "Client Installation Getting Stuck" for how to uninstall the client.

Stuck ingame

If you happen to get stuck whilst playing Super Terraria World, please type the following command in the ingame chat: /player-report-bug-stuck. If the previous command does not work, then an alternative is /player-report-bug-spawn.

Once that is done, it will teleport you to the last entrance for the first command, or the world spawn point with the second, and open the STW Bug reporting site, which you are highly recommended to fill out to your best abilities.

Your previous game session has not ended yet

Very rarely when you log out of Super Terraria World you may encounter this issue, simply wait and you should be able to rejoin. The wait time can vary, and in extreme cases a server restart may be required before you can join the server again.

@@ Line 1: / Line 1: @@
+{{guide header}}
 '''Installation guide/Troubleshooting''' is a complete guide on installing the launcher and client for Super Terraria World. You will find all requirements that need to be fulfilled in order to play, aswell as all known problems that can occur during the installation process of the launcher and client.
+You can download the Super Terraria World Installer from the [https://forums.terraria.org/index.php?threads/super-terraria-world-mmorpg-style-mod-server-and-client-mod.936/ '''Terraria Community Forums''']
-For ingame bugs, please report them at the [https://docs.google.com/forms/d/1PxMXo9NrEgl5uQR0ewCLL8Ya493T-MsoXs3YMJ28uyg/edit STW Bug reporting] site and provide as much detail of the bug as you possibly can.
+For ingame bugs, please report them at the [https://docs.google.com/forms/d/1PxMXo9NrEgl5uQR0ewCLL8Ya493T-MsoXs3YMJ28uyg/edit STW Bug reporting] site and provide as many details of the bug as you possibly can.
@@ Line 10: / Line 14: @@
 [[File:Launcher settings.png|framed|right|'''Launcher settings'''<br/>You can navigate to the launcher settings at the top left of the launcher.]]
 '''Before trying any of the solutions, please make sure you meet the following requirements met:'''
+* Agree with the [https://forums.terraria.org/index.php?threads/super-terraria-world-mmorpg-style-mod-server-and-client-mod.936/#Disclaimer%20and%20Agreements '''Disclaimer & Agreements''']
-* ''Ensure you have a 64-Bit Computer architecture (32-Bit needs testing).''
-* ''Ensure you are using either Windows 7, 8 or 10 (Mac and Linux support will be added later on).''
+* Ensure you have a 64-Bit Computer architecture (32-Bit needs testing).
-* ''Ensure you have a legally owned Steam copy of vanilla Terraria installed and have run it atleast once after installing.''
+* Ensure you are using either Windows 7, 8 or 10 (Mac and Linux support will be added later on).
+* Ensure you have a legally owned Steam copy of vanilla Terraria installed and have run it atleast once after installing.
+* Ensure you have launched Terraria atleast once, to make sure you have .NET framework installed and updated.
+* Ensure that your steam name does not contain any weird/non standard characters. (If it does, you can change it back once you've launched STW for the first time).
-* ''If you do not have Terraria installed to the standard path '''''(C:\Program Files (x86)\Steam\steamapps\common\Terraria)''''' ensure that the Launcher has the correct path input in the 'Terraria  Game Files' section of the settings.''
+* If you do not have Terraria installed to the standard path '''''(C:\Program Files (x86)\Steam\steamapps\common\Terraria)''''' ensure that the Launcher has the correct path input in the 'Terraria  Game Files' section of the settings.
-* '' If you do not use the standard Terraria saves path '''''(C:\Users\<user>\Documents\My Games\Terraria)'''''  ensure that the Launcher has the correct path input in the 'Terraria Save Files' section of the settings, with <user> being your computers username, which you are trying to install STW on.''
+* If you do not use the standard Terraria saves path '''''(C:\Users\<user>\Documents\My Games\Terraria)'''''  ensure that the Launcher has the correct path input in the 'Terraria Save Files' section of the settings, with <user> being your computers username, which you are trying to install STW on.
@@ Line 28: / Line 35: @@
 ===Steam login is a blank/white screen===
-'''''This is more related to steam than it is to the launcher however here is how you solve it. Install the stw launcher then open steam, open the stw launcher as administrator then wait a few seconds for it to load the steam elements and the login page should appear. The rest is simply following the login instructions.'''''
+'''''This is an issue related to steam and not the launcher itself, there are several things that can potentially fix this. Run Steam and the STW launcher as administrator, wait a few seconds for it to load the steam elements and the login page should appear. If that does not work try reinstalling Steam (if you use a custom install folder try using the default installation path).
+If that does not work then one of the following solutions can potentially help.'''''
+* '''Clear the Steam Web Browser Cache.''' In Steam, go to the Web Browser section of the Steam settings and delete the Cache and Cookies.
+* '''Disabling DirectWrite for font smoothing.''' Again within Steam settings, go to Interface and uncheck “Enable DirectWrite for improved font smoothing and kerning”
+* '''Clearing the htmlcache directory.''' Go to Users\yourusername\AppData\Local\Steam and delete all the contents of the htmlcache folder.  Do not delete the folder itself!
+* '''Disabling Compatibility Mode.''' Right click on Steam.exe (standard path is C:\Program Files (x86)\Steam), choose Properties. Next click on the Compatibility tab and uncheck any boxes that are checked, and click Apply.
+* '''Add Exceptions for Steam and SteamWebHelper.''' Add both Steam and SteamWebHelper as exceptions inside of your installed firewall, if none is installed then you can skip this.
+* '''Disable Chrome Embedded Framework Sandbox.''' Create a short-cut to Steam with the “-no-cef-sandbox” switch, if you use the default install location it would be "C:\Program Files (x86)\Steam\Steam.exe" -no-cef-sandbox
+===Launcher closing on Steam login===
+'''''If you have Steam family sharing enabled on you steam account you will not be able to play Super Terraria World, simply disable this and you should be able to get past the Steam login screen in the STW launcher.
 ===Unauthorized User===
@@ Line 36: / Line 55: @@
 [[File:Unauthorized User.gif|framed|none|'''Unauthorized User Fix'''<br/>Make sure to close and reopen the launcher once you have done these steps.]]
 |}
+===Ensure that Steam is running===
+'''''If you have Steam running when trying to play STW and still get this error, then run the STW launcher and Steam as administrator. If this does not work, try logging out of steam in the STW launcher and restart the launcher to log back in. '''''
 ===Client installation getting stuck===
@@ Line 41: / Line 63: @@
 [[File:Client Installation.gif|framed|none|'''Uninstalling the Client'''<br/>If you try to uninstall and get the error message STW is not installed, you are safe to try and reinstall the client.]]
+===CSteamworks error, when trying to launch the game===
-== Client Troubleshooting ==
+'''''Make sure your paths in the launcher settings are setup correct and check to see if you have the file 'CSteamworks.dll' in your Steam\steamapps\common\Terraria folder.'''''
+===Game not starting with no error message===
+'''''If you do not get any error message when you try to start the Super Terraria World client, then navigating to your 'Terraria  Game Files' location and run the SuperTerrariaWorld.exe as administrator and it should work.'''''
 ===Texture2D Crash Message===
 '''''Currently, STW does not support resolutions above 1920x1080p. As a workaround, please lower your Windows resolution to 1920x1080p (not your in-game resolution). '''''
+== Client Troubleshooting ==
 ===Missing Tile Data===
-'''''There are two issues that can cause this, the most common is if your game/save file paths are setup incorrect, please ensure that they are targeting the correct folders. If the paths are setup correct go into the launcher settings and click uninstall STW from there. Please refer to "Client Installation Getting Stuck" for how to uninstall the client. '''''
+'''''There are two issues that can cause this, the most common is if your game/save file paths are setup incorrect, please ensure that they are targeting the correct folders. If the paths are setup correct then it is most likely due to the installation process not having installed the required files, to solve this go into the launcher settings and click uninstall STW. Please refer to "Client Installation Getting Stuck" for how to uninstall the client. '''''
 ===Stuck ingame===
-'''''If you happen to get stuck whilst playing Super Terraria World, please type the following command in the ingame chat: /player-report-bug-stuck.'''''
+'''''If you happen to get stuck whilst playing Super Terraria World, please type the following command in the ingame chat: /player-report-bug-stuck. If the previous command does not work, then an alternative is /player-report-bug-spawn.'''''
-'''''Once that is done, it will open the [https://docs.google.com/forms/d/1PxMXo9NrEgl5uQR0ewCLL8Ya493T-MsoXs3YMJ28uyg/edit STW Bug reporting] site, which you are highly recommended to fill out to your best abilities.'''''
+'''''Once that is done, it will teleport you to the last entrance for the first command, or the world spawn point with the second, and open the [https://docs.google.com/forms/d/1PxMXo9NrEgl5uQR0ewCLL8Ya493T-MsoXs3YMJ28uyg/edit STW Bug reporting] site, which you are highly recommended to fill out to your best abilities.'''''
 ===Your previous game session has not ended yet===
-'''''Very rarely when you log out of Super Terraria World you may encounter this issue, simply wait and you should be able to rejoin. The wait time can vary and in extreme cases a server restart may be required before you can join again.
+'''''Very rarely when you log out of Super Terraria World you may encounter this issue, simply wait and you should be able to rejoin. The wait time can vary, and in extreme cases a server restart may be required before you can join the server again.