Client Troubleshooting

## Launcher does not launch the client when pressing 'Play'

#### Reason

This means that the ZodianX client process did not start successfully or was not closed properly.

#### Fixes

1. Open your 'Task Manager'
2. Press the 'Details' tab
3. Right click and end all Java processes
4. Try pressing 'Play' again
5. Still not working? Restart your computer

## Can't rename new jar to ZodianX

#### Reason

This means that the ZodianX client process is still running in the background on your computer and the launcher is trying to update the file.

#### Fixes

* Open up the Task Manager on your computer and find the Java process that is running and terminate it
* Restarting your computer will guarantee that the process stops working and will allow the launcher to update the file

## Black in-game screen

#### Reason

This problem can occur for a variety of reasons. Sometimes the ZodianX client did not download properly and the jar is broken or your cache did not download or update properly and is not allowing the client to display the required assets to load the game

#### Fixes

##### Deleting Java on your computer

1. Close all clients and programs that may be using Java and delete all ZodianX game files including this folder: C/users/user/.ZodianX\_v2
2. Go to C/Program Files/Java/
3. Delete everything inside.
4. Restart PC (VERY IMPORTANT)
5. Download latest version of Java (https://www.java.com/en/download/manual.jsp)
6. Restart PC (VERY IMPORTANT)
7. Download ZodianX client and try again (https://discord.gg/aM5YDghEHH)

##### Deleting your ZodianX cache

1. Close all ZodianX clients and/or terminate all Java processes using your Task Manager
2. Head to the cache folder (C:/Users/\*Your user\*/.ZodianX\_v2
3. Delete everything inside
4. Restart your client or launcher

## Client Crashing (White Screen or Client terminates)

#### Reason

This issue occurs for a variety of reasons. There is no single reason as to why this happens. Sometimes this problem does occur due to a lack of RAM memory on your computer and will terminate on its own to free up space.

#### Possible Fixes

* Restarting your computer
* Reinstalling Java (use method above)
* Reinstalling ZodianX cache (use method above)

#### Problem still not fixed?

If the problem is still not fixed then a developer will need to further investigate this issue. Please follow the steps to help resolve this issue as fast as possible.

1. Head to the cache folder (C:/Users/\*Your user\*/.ZodianX\_v2
2. Open the 'error\_logs' folder
3. Submit the error log with the date of the crash to a staff member

## Client looks pixelated, blurry or small

#### Reason

This occurs because your monitor has a high DPI and Java programs are not utilizing the computer system's scaling option

#### Fixes

Visit this link and follow the steps required to resolve this issue

## Client is not a Java program

#### Reason

This occurs because your computer is unable to associate the program with the Jar file type. This usually happens when Java is installed incorrectly on your PC or Java was updated from an old version to a new Java version

#### Fixes (Windows PC only)

###### Option 1: Downloading Jarfix (Difficulty: Easy)

1. Visit this link to download the Jarfix application (Jarfix is a program that will fix the Jar file type association problem your computer is facing)
2. Once Jarfix is downloaded run the program and it will fix the file-type association
3. Restart your PC if the client is not clickable after running the program

###### Option 2: Fixing the problem manually (Difficulty: Hard)

1. Right click the ZodianX file that you downloaded
2. Select the 'Open-with' option
3. Select the 'Choose another app' option
4. Tick the checkbox 'Always use this app to open .jar files'
5. Select the 'More apps' option at the bottom
6. Select the 'Look for another app on this PC' option
7. Navigate to your Java folder (C:/Program Files/Java/)
8. Select the folder with your current Java version (Example: jre1.8.\*)
9. Select the 'bin' folder
10. Choose the 'Javaw.exe' option and press open

## HD Client Issues

#### Reason

This issue occurs for a variety of reasons

* Your graphics card drivers are not up-to-date
* Your computer is incapable of utilizing the gpu driver the client requires
* Your computer does not have the necessary memory or processing required to load HD

#### Fixes

###### Updating your Nvidia Graphics Card driver

1. Open your GeForce Experience application
2. Update your GeForce Experience application (Optional: Sometimes it will not let you into the app without updating)
3. Press the 'Drivers' Tab in the top-left section of the application
4. Download the latest GeForce Game Ready Driver from the list

## Major FPS Drops w/ Resizable Mode

**Reason** This issue occurs because the standard 317 revision client was not created to work properly with the 'Resizable' mode. This feature was added much later and was optimized to work better in newer versions of the game. Due to the enlarged screen and farther view distance the client is required to perform many more operations to render the maps and objects on your CPU (This is known as software rendering) and is not optimized to do so.

Fixes - There are no concrete fixes, but ways to significantly improve your FPS

* Decreasing 'View Distance' to 40 or less
* Zooming in onto your character more
* Using HD mode [Note: You may need RAM to support the extra memory] (This will enable GPU rendering which would allow your GPU to render the maps rather than your CPU)

## RuneLite Client Randomly Freezing ("Message" pop-up)

Reason: Usually caused by the "Mouse Tooltips" plugin found on RuneLite

Fixes:

Please make sure the 'Disable <action><player>' checkbox is ticked

## Mac: Can't Open Application (Unidentified Developer)

Reason: Mac has a built in Security feature that will automatically block Applications that are unlicensed when being distributed. RSPS are incapable of being licensed. ZodianX is no exception.

Fixes:

Watch this YouTube video that explains how to open applications from an "Unidentified Developer" by visiting this link.