Alter

Alter is a modified version of RSMod a highly flexible user-friendly game server for use with the OSRS client. Implemented in a modular way, the framework allows developers to make and create any sort of plugin they wish without having to modify the core game module. Due to the plugin capabilities, even owners without programming experience can just have others make plugins for them and simply drop them into the plugins module to be automatically loaded on the next startup!

I found a bug, where can I report it?

• You can report them by creating Issue on GitHub or in Alter's Discord Server

Server setup

• Youtube tutorial: https://www.youtube.com/watch?v=2Tu-NTzMbf0

• First of all Download:

• Xteas Save as xteas.json inside /data/ Directory.

• cache-oldschool-live-en-b228-2025-02-05-11-45-05-openrs2 , And make sure you're using correct Java Version.

• Also make sure you have Intellij installed, how to install intellij: Youtube

• First open Intellij, (If you already have a project open, either do File -> Close, or File -> New -> Project from Version Control)

• If you decided to use Close method you will see this window, click on Get from VCS

• Second paste https://github.com/AlterRSPS/Alter in URL Field and hit Clone.
  

• Hit Clone and Let the project fully load.

• Now open the cache-oldschool-live-en-b228-2025-02-05-11-45-05-openrs2 file that you downloaded. and drag out Xteas.json and Cache folder and pull it to /Data/ Folder.

• Xtea.json has to be in same folder like: Data /api.yml, etc..

• Now click on Gradle button on right side.
  
• Expand Alter -> other and double click install
• And now wait until you get this result in your Terminal at the bottom:
• Now instead of Install task do Run Gradle -> Alter -> game -> Tasks -> Application - Run
• Now the server should be running, you should see inside your terminal:
• If you only see Alter Loaded up in x ms. you messed up somewhere.
• You can connect what ever client you want (ofc it has to follow OSRS protocols.)

Note

When you have Intellij Open, navigate to File -> Project Structure -> And make sure SDK is set to 17 java version 17.x.x

It is also recommended to install the rscm-plugin in IntelliJ for enhanced Entity references support.

Client setup:

Tip

As for now, RSProx is the only OSRS client that should be used. It's developed by the most trusted and experienced developers in the RSPS scene.

For Windows users: Just press ⊞ + R and in text field area write: %USERPROFILE% and locate folder named .rsprox create a new file named: proxy-targets.yaml and inside paste:

config:  
  - id: 1  
    name: Alter  
    jav_config_url: https://client.blurite.io/jav_local_228.ws  
    varp_count: 15000  
    revision: 228.2  
    modulus: YOUR_MODULUS_KEY_HERE  

Modulus key will be found inside Alter Project root directory make sure to copy every character, And replace YOUR_MODULUS_KEY_HERE inside proxy-targets.yaml with your modulus key. For more information on it you can find at: RSProx-Private-Server-Usage

If you haven't used RSProx before, You won't have .rsprox folder inside %USERPROFILE%

Warning

And stay away from client's like Devious, as they have been caught adding Account Stealer into their client.

Acknowledgments

• This project uses OpenRune-FileStore for cache management.
• RsMod2 Route finder: RouteFinder

Credits:

• Credits are given out to everyone who helped out with information or contributed in some form to the project. And can be found in: Here