https://i.imgur.com/LEIs277.png
https://img.shields.io/discord/67875...d&logo=discord
RuneJS is a RuneScape game server written entirely using TypeScript and modern JavaScript. The aim of this project is to create a game server that is both fun and easy to use, while also providing simple content development systems.
The server runs on the 435 revision of the game, which was a game update made on October 31st, 2006. There are not any plans to convert it to other versions at this time.
RuneJS is completely open-source and open to all pull requests and/or issues. Many plugins have been added by contributor pull requests and we're always happy to have more!
Come checkout the project over on Github!
Features
Game Server
✔️ Game Update Server
✔️ Authentication
✔️ Packet queueing
✔️ RSA + ISAAC ciphering
✔️ Server side cache loading
✔️ Client pathing validation via cache mapdata
✔️ Item/object/npc definitions
Game World
⚡ Bank
✔️ Withdraw/Deposit 1,5,10,All⚡ Audio
✔️ As note
✔️ Swap slot
✔️ Insert mode:
⚡ Deposit box
⚡ Music✔️ Climbing ladders
✔️ Playing music⚡ Sounds
❌ Music Regions
❌ Music Player tab
✔️ Playing sounds
⚡ Sound effects for actions
⚡ Climbing stairs
⚡ Lumbridge mill
❌ Replacing objects for local player only✔️ Cow milking
✔️ Grain in hopper
✔️ Operating levers
✔️ Removing flour if and only if grain has been processed
✔️ Container filling
✔️ Buckets, Jugs, Wells, Sinks, Fountains⚡ Home Teleport
✔️ Emptying Containers
⚡ Emotes
⚡ Skillcape⚡ Shops
✔️ Normal emotes
✔️ Shop logic⚡ Inventory
⚡ World Shops
✔️ Al Kahrid gem trader
✔️ Louie Armoured legs
✔️ Dommik craftin shop
✔️ Raneal Super skirt
✔️ Bob's axes
✔️ Swap Items✔️ Pickables
✔️ Drop Item
✔️ Pickup item
⚡ Equip item
⚡ Complete equipment stats and slot info
✔️ Wielding logic (Weight, Stats, Equipping)
✔️ Wheat, Flax, Potato, Onion, Cabbage⚡ Doors
✔️ Door logic❌ Clue Scrolls
⚡ Door ids
Skills
⚡ Combat
⚡ Melee❌ Prayer
❌ Ranged
❌ Magic
❌ Cooking
❌ Fletching
❌ Fishing
⚡ Firemaking
⚡ Fire lighting❌ Herblore
⚡ Chain fires w/ clipping & movement
❌ Agility
❌ Thieving
❌ Slayer
❌ Farming
❌ Runecrafting
❌ Construction
⚡ Woodcutting
✔️ Formula for success⚡ Mining
✔️ Chopping Trees
✔️ Axes
✔️ Birds nests
⚡ Stump ids
❌ Canoes
✔️ Formula for success⚡ Crafting
✔️ Mining ores
✔️ Pickaxes
✔️ Random gems
✔️ Gem ores
✔️ Essence mining
⚡ Empty Rock ids
✔️ Spinning wheel⚡ Smithing
✔️ Smelting ore to bars
⚡ Forging
✔️ Correct items
⚡ Hiding non applicable items
Quests
✔️ Cook's Assistant
Setup
- Download and install NodeJS version 13 or higher: https://nodejs.org/en/
- Clone the Github repo: https://github.com/rune-js/server
- Install dependencies by navigating to the project in your Terminal or command prompt and running the command npm install
- Copy the data/config/server-config-default.yaml and paste it into the same folder using the name server-config.yaml.
- Go into your new server-config.yaml file and modify your RSA modulus and exponent with the ones matching your game client.
- You may also modify the server's port and host address from this configuration file.
- Run the game server and REST service by inputting the command npm start
The game server will spin up and be accessible via port 43594. The REST service can be accessed via port 8888.
Cache Parsing
A separate package was created that RuneJS uses to parse the 435 game cache. This package decodes item definitions, npc definitions, location object definitions, widgets, sprites, and map data (tiles and location objects) for any implementing app to make use of.
The RuneJS cache-parser package can be found here:
Github: rune-js/cache-parser
(also published on NPM under the namespace runejs)
REST API
Online players can be polled via the REST protocol for web applications.
API Endpoints:
GET /players : Returns a list of players currently logged into the game server.
GET /items?page=x&limit=y : Returns a list of item metadata loaded by the game server.
GET /items/{itemId} : Returns details about a specific item by id.
PUT /items/{itemId} : Updates an item's configurable server data.
Media
Spoiler for Media:
Contributors
Check out our list of contributors over on Github: github.com/rune-js/server/graphs/contributors