Troubleshooting Guide

The following describes a number of common issues and the solutions to them. Following rules apply:

  1. Read this page carefully and in its entirety before heading to the forums to ask for help.
  2. This Troubleshooting Guide was originally made for the previous version of the WesterosCraft Launcher.
  3. A full breakdown of the new launcher can be found at WesterosCraft Launcher Wiki .
  4. If you have to ask for help on the forums, use the Support Subforum.
  5. Always include as much information in your post as possible. Always include the launcher log using a pastebin.
  6. See here if you're using the Technic Launcher or the standard Minecraft Launcher.
"Why can I not connect to"

You cannot join the server using the normal Minecraft launcher. To enter you need to use our custom-built launcher, which allows us to implement a number of modifications to the game.

Simply download the Launcher and follow the installation steps as described there. The launcher will automatically choose the appropriate minecraft version, texture pack etc., set everything up for you and directly connect you to the server.

"I'm using the latest WesterosCraft Launcher, but I still can't connect."

There are several fixes you can attempt in order to connect to the WesterosCraft Server through the custom launcher:

  1. Ensure that you are using the most updated version of the WesterosCraft Launcher. Found at the WesterosCraft Launcher Download
  2. Ensure that you have the WesterosCraft Production Server selected in the bottom right-hand corner of the launcher.
  3. Ensure that you are have Java 8 installed on your computer. This can be accomplished by searching: "About Java" in Start.
  4. Allow both Minecraft and WesterosCraft through your firewall in Security settings.
  5. Attempt to generate a new client token by logging out of the Launcher (Settings>Account>Cursor over Selected Account>Log Out) and then logging back in.
  6. Attempt to generate a new client token by manually deleting the config.json file located in: C:\Users\[name]\AppData\Roaming\.westeroscraft and then restarting the WesterosCraft Launcher.
"What do I do if the game is out of date?"

Your version is not up to date with the server and you need to update the launcher. Simply hit the Update button, wait for the update to finish and try launching again. Rarely, it doesn't update all files correctly and you need to go through the update process a couple times before it works.

"How do I launch the game?"

On the lefthand side of the launcher select the WesterosCraft Production Server When prompted, enter your MineCraft credentials, so the same e-mail address and password you use to log into regular Minecraft.

"What do I do if the connection times out?"

If you cannot reach the server, make sure you are connected to the internet and that Java is not blocked by your antivirus or firewall.

As a server we depend on both the Minecraft infrastructure and our server hosts. Contact Mojang to see if the session and login servers are down. If the server is down due to maintainance on our or our server host's side we will inform you via the forums. In either way, be patient, we will be back as quickly as possible.

"How do I get whitelisted on the server?"

You do not require to be whitelisted to join WesterosCraft, everyone is welcome to visit at any time, as long as you have a valid Minecraft account.

Very rarely we have to whitelist for maintenance issues. If that is the case, refer to our Website and Forums for status updates. And again, please be patient.

"What if I can not start the launcher?"

The launcher requires you to download the latest and correct version of the Java Runtime Environment in order to work correctly. If you can't even start the launcher, or if the launcher fails to start the game, you're most likely not using the correct version.

"I can connect but I lag really badly, what can I do?"

Not using the correct version of Java may lead to performance issues. Make sure you're using the most recent, 64bit version of Java.

If you're using a Laptop you might accidentally use your built-in graphics card instead of the better, additional one. Make sure Java programs are set to use the better GPU by default. Refer to your graphics card's manual.

"Why do I keep crashing from the server?"

Not using the correct version of Java may lead to crashes. Make sure you're using the most recent, 64bit version of Java.

In rare cases, server issues may lead to crashes. If that is the case it's likely that we are already aware and working on resolving the issue as quickly as possible.

"How do I know I'm not using the correct version of Java?"

Your launcher gives you a detailed overview of what it's doing under the Log tab. If something goes wrong this is the place to look first.

The easiest way to find out which Java version the launcher is using is to copy the log into a text file and to search for the "launch args".

If you are using a 32bit version of Java, you will find the following line:

"C:\Program Files(x86)\Java\jre1.8.0_xxx\bin\javaw.exe" ("xxx" = version numbers, e.g. 101)

In this case the game may not launch, or you may experience performance issues or crashes.

64bit Windows systems are by default set to install 32bit software under C:\Program Files(x86)\... while they install 64bit software at C:\Program Files\... If you're using a Java version installed at the former location, it means that it is a 32bit program, which will most likely lead to issues with our launcher.

"Where do I get the correct version of Java from?"

The most recent Java download can be found on the oracle website .

The version you want to pick is Windows x64 Offline:

If you're using a Mac, download the OSx version.

"The game crashes and I found something about a heap size in the log, what do I do?"

The error message reads:

'Error occurred during initialization of VM. Initial heap size set to a larger values than the maximum heap size'

This may occur when previous Java installations set environment variables which are no longer needed. Please check out this post for more information.

"I made sure Java is up to date, but it's still not working. Is there anything else I can do?"

The launcher was probably not able to download and set up everything correctly. This may, for instance happen if you have a weak internet connection.

As a general approach a soft reset of the launcher can solve some common problems.

  1. Hitting the Windows-button (between ALT and CTRL) and R simultaneously prompts the execute tab
  2. Enter %appdata% and hit enter.
  3. Find the WesterosCraft folder
  4. Delete the WesterosCraft folder. Make sure you made backups of screenshots and similar before doing this!
"What do I do if I was banned from the server?"

You've potentially broken one or more of our Rules. You are potentially allowed to appeal via our forums.

"Do I need to purchase Minecraft in order to play WesterosCraft?"


"What do I do if it's still not working?"

Post your problem on our Support Forum, but read the tech support guidelines first.

Shield Logomark



WesterosCraft is a free, volunteer fan project not affiliated in any way with GRRM, Mojang, or HBO.