Game Client

From Old School RuneScape Wiki
Jump to: navigation, search
(unf)
This article or section is incomplete and could do with improvement.
You can discuss this issue on the talk page or edit this article to improve it.
For the mobile client, see Old School RuneScape Mobile.
Loading...
WindowsMac

The Game Client is the Old School RuneScape launcher built by Jagex for desktop platforms. In the past, the client was an alternative to playing the game in a browser. However, due to multiple browsers discontinuing support for Java, Jagex was forced to drop support for browser play. Currently, Jagex has official clients for Windows, Mac, and Linux. The official client only uses the CPU instead of a GPU and it can only use one processor core. Its frame rate is capped at 50 frames per second.

Using third-party client software to play Old School RuneScape does not by default violate the Rules of RuneScape.[1] However, Jagex cannot guarantee the safety of third-party clients, and such clients may have features that violate rules.[2][3] In some instances, third-party clients may automatically trigger Jagex's bot detection.[4]

The official Game Client can be downloaded in the Download section of the Old School RuneScape website.

Troubleshooting[edit | edit source]

Editing the client's configuration[edit | edit source]

Windows[edit | edit source]

On Windows, the configuration is stored in the file %USERPROFILE%\jagexcache\jagexlauncher\oldschool\oldschool.prm

To edit this file, type %USERPROFILE%\jagexcache\jagexlauncher\oldschool into File Explorer's address bar and open oldschool.prm with Notepad. If you can't save, make sure the game is closed and try again.

macOS[edit | edit source]

On macOS, the configuration is stored in the file Runescape.app/Contents/Info.plist

To edit this file open Terminal and type the following:

open -a TextEdit /Applications/Old\ School\ RuneScape.app/Contents/Info.plist

Configuration options[edit | edit source]

Default configuration[edit | edit source]

-Djava.class.path=jagexappletviewer.jar
-Dsun.java2d.noddraw=true
-Dcom.jagex.config=http://oldschool.runescape.com/jav_config.ws
-Xmx384m
-Xss2m
-XX:CompileThreshold=1500
-Xincgc
-XX:+UseConcMarkSweepGC
-XX:+UseParNewGC
jagexappletviewer

Increasing maximum heap usage[edit | edit source]

You can increase the amount of maximum heap the Old School RuneScape client uses. This can help decrease lag.

To do this, change -Xmx384m to a higher value in the configuration file. -Xmx512m is the recommended heap size and should not be increased unless absolutely necessary. Allocating too much memory to the heap can cause game instability. If, after increasing the amount of maximum heap, your client begins to crash to desktop, decrease the maximum heap size and try again.

Using a different garbage collector[edit | edit source]

You can choose a different garbage collector for the Old School RuneScape client to use. This can improve map loading times and decrease lag caused by garbage collection.

To do this, make the following changes to the client's configuration file:

  • Remove the following flags
-XX:CompileThreshold=1500
-Xincgc
-XX:+UseConcMarkSweepGC
-XX:+UseParNewGC
  • Add the following flags:
-XX:+DisableExplicitGC
-XX:+AggressiveOpts
-XX:+UseAdaptiveGCBoundary
-XX:MaxGCPauseMillis=500
-XX:SurvivorRatio=16
-XX:+UseParallelGC

SSL connectivity[edit | edit source]

Enabling SSL connectivity can help decrease lag you if you're connecting via a mobile network, restrictive network, proxy, or firewall.

To do this, add one of the following flags to the configuration file:

-Dhttps.protocols=TLSv1.1,TLSv1.2

Recommended configuration[edit | edit source]

-Djava.class.path=jagexappletviewer.jar
-Dsun.java2d.noddraw=true
-Dcom.jagex.config=http://www.oldschool.runescape.com/jav_config.ws
-Dhttps.protocols=TLSv1.2
-Xmx512m
-Xms512m
-Xss2m
-XX:+DisableExplicitGC
-XX:+AggressiveOpts
-XX:+UseAdaptiveGCBoundary
-XX:MaxGCPauseMillis=500
-XX:SurvivorRatio=16
-XX:+UseParallelGC
-XX:+UnlockExperimentalVMOptions
-XX:+TieredCompilation
jagexappletviewer

Enable Dark Mode on macOS[edit | edit source]

On macOS Mojave and later, you can enable the system dark appearance by editing the Info.plist configuration file using Terminal. Close the game client, then copy and paste the folloinwg to a new Terminal Shell:

plutil -insert NSRequiresAquaSystemAppearance -bool NO /Applications/Old\ School\ RuneScape.app/Contents/Info.plist

This will append the NSRequiresAquaSystemAppearance key to the configuration file with a boolean value of NO. To revert changes, simply change the boolean value to YES.

Multiple client configuration[edit | edit source]

Old School RuneScape client icon (alternative).png
  1. Go to %USERPROFILE%\jagexcache\jagexlauncher
  2. Create a new folder and name it either "runescape" or "beta" for whichever version you'd like to create a client for.
  3. Copy the .prm file from %USERPROFILE%\jagexcache\jagexlauncher\oldschool
  4. Paste the .prm file inside the newly created folder named "runescape" or "beta".
  5. Rename the file to match the folder; runescape.prm or beta.prm
  6. Open the renamed .prm file in Notepad.
  7. Remove the flag:
    -Dcom.jagex.config=http://oldschool.runescape.com/jav_config.ws
  8. Replace it with the corresponding flag:
    • RuneScape: -Dcom.jagex.config=http://www.runescape.com/k=3/l=$(Language:0)/jav_config.ws
    • Beta: -Dcom.jagex.config=http://www.runescape.com/jav_config_beta.ws
  9. Save and close the file.
  10. Locate the Game Client shortcut and make a copy of it; By default, the Game Client shortcut is found on your Desktop.
  11. Right-click the new shortcut copy, and select "Properties" from the context menu.
  12. Under the shortcut tab, find the box right of the word "Target"; It should display C:\Users\<user_name>\jagexcache\jagexlauncher\bin\JagexLauncher.exe oldschool
  13. Change the oldschool on the end to match the folder name created in step 2.
  14. Click OK to save the changes made.

References[edit | edit source]

  1. The Old School Team. "Third Party Client Update." 16 May 2018. Old School RuneScape News.
  2. The Old School Team. "A Message About Unofficial Clients." 30 September 2019. Old School RuneScape News.
  3. The Old School Team. "Another Message About Unofficial Clients." 08 November 2019. Old School RuneScape News.
  4. The Old School Team. "Graphical Client Update." 12 June 2017. Old School RuneScape News.