Repository files navigation

Void

Void is a lightweight, high-performance back-end game server emulating the 2011 MMORPG RuneScape (revision 634). It serves as a modern and user-friendly base for others to built-off of.

Features  • Quick setup  • Development  • Blog  • Documentation  • Bugs

• Capable of handling thousands of concurrent players
• Wide range of emulated content
• AI driven player bots
• Developer friendly content creation
• Low memory usage

1. Make sure you have java 19 or above installed. (java --version on command line)

2. Extract thelatest void.zip released bundle into a directory.

3. Extract thelatest pre-modified game files cache.zip into/void/data/cache/.

4. Run either therun-server.bat on Windows, orrun-server.sh on Linux.

   [Main] - Void loaded in 2349ms[GameServer] - Listening for requests on port 43594...

   You should see these two messages followed by many[GameLoop] to know the server is up and running correctly.

   Ctrl + C to exit and shutdown the server when running from a command line terminal.

5. Run thelatest client.jar and login with any username and password to create a new account.

It is recommended to use IntelliJ IDEA to develop with Void.The community edition can be downloaded for free from thejetbrains website.Seethe installation guide for more instructions.

Once inside the IDE, you can create a new project by going toFile | New | Project from version control... |

Selectinggit version control and entering the void project URLgit@github.com:GregHib/void.git found under the<> Code button on theGitHub page.

Press clone and after a little while the project will be opened for you, the JDK indexed and gradle setup.

Extract thecache files into a new directory called/cache/ inside of the/data/ directory.

From here you can navigate in the left panel to/game/src/main/kotlin/world/gregs/voidps/ where you will findMain.kt which you should be able to right-click and run.

You can also run in the command line using the gradle wrapper.

./gradlew run

Once the server is up and running; setup thevoid-client repository or download one of theprebuilt client.jars and run to log into the game.

Don't forget to check out ourContributing guidelines before submitting your first pull request!

For further guides on how to write content please refer to theVoid Wiki.

If you run into any problems or find any bugs please report them by creating aNew Issue on our Issues Page describing the problem, so it can be fixed.

• All contributors
• Kris -osrs-docs
• Ebp90
• Jarryd
• Tomm -RSMod Pathfinder
• Graham -OpenRS2