xlitekt
Introduction
XliteKt is an open-source, and forever open-source Kotlin based OSRS Emulator for educational purposes. Currently built around the game update: #202 (Nex)
The goal behind this project is to provide the community with a powerful, yet simple to use framework that is heavily documented.
Xlite is currently built by two developers:
Getting Started
Make sure to download the Jan 6th #202 cache version from one of the archives below. We don't push this to github for obvious reasons.
Download a cache from one of the archives:
Place the cache you downloaded into the ./cache/ folder inside of the project. This path is configurable in the application.conf.
Generate RSA tokens and update your application.conf file
This will eventually be a gradle task to generate new RSA keys. For now, you can reference the rune-server thread: any-revision-enabling-rsa
Download and install the #202 xteas inside of the map folder in resources.
You can find this file on the runstats repo, called xteas.json
Application configuration
Most everything will be setup and configured already for you around the build #202. So unless you're porting to a recent revision you'll really only need to worry about updating the RSA Keys in the application.conf file.
Configuration for ktor can be found in the ktor block.
ktor {
development = false
deployment {
port = 43594
watch = [ classes, resources ]
}
application {
modules = [ com.runetopic.xlitekt.ApplicationKt.main ]
}
}
Configuration for game related properties. You will need to generate your RSA exponent and modulus, as well as the packet sizes.
We will be writing a tutorial in the future for dumping packets sizes and other information from the current OSRS client as well as the gradle task to generate RSA tokens.
Please change the RSA tokens for a production based environment, these keys are just an example. Do not use this for anything other than local development.
game {
build {
major = 202
minor = 1
}
packet {
sizes = [ 3, 8, 16, -1, -1, 8, 2, 1, 8, 0, 8, 8, 0, 2, 16, 16, 8, 9, 11, 8, 8, 7, 2, 4, 7, 4, -1, 7, 15, 8, -1, 8, 9, 7, 15, 6, -1, 3, 11, 15, 4, 8, 8, 8, -1, -2, 3, 3, 5, -1, -1, -1, -1, 7, 7, 0, 7, -1, -1, 3, -2, 3, 8, 3, 8, 0, 8, 4, 7, 11, 3, 6, 8, 11, 3, 8, 7, 4, -1, 2, 15, 7, 8, 3, 14, 3, -1, 10, 8, 13, 3, -1, 3, -1, 7, -1, 0, -2, -1, -1, 2, -1, -1, -1, 3, -1 ]
}
cache {
path = "./cache/"
}
rsa {
exponent = "74319506585812759823290259020934858088666404737094871101540670473424793671202076033582991318775440709937362678616598621443723414224839661646087632908361014054642952231258678163322462341878133664959918342102621655539431162351843502897522597279543226584696172903586455624355061037387268986011976499046968675073"
modulus = "101152132894052393265886644489429469067887733993499471826334750806131431774995232950094045980615261210482740859538462033841944288877997111341162261129657268035424385776764492943939466200272309679088830878857767599863397432612329236019641861788901097158810527108145428907942159175673330991981851896173021952237"
}
xteas {
path = "/map/xteas202.json"
}
}
Configuration related to network.
network {
timeout = 10000
}
Maps
Maps are loaded using the xteas provided from Runestar, which follows this format:
[
{
"mapsquare": 4662,
"key": [
327206325,
671317497,
652416162,
-982088476
]
}
]
1 Oct 16, 2022
0 Nov 23, 2021
16 Jan 31, 2023
11 Oct 12, 2021
2 Aug 29, 2022
50 Dec 5, 2022
132 Jan 2, 2023
20.2k Dec 30, 2022
12 Dec 25, 2022
437 Dec 23, 2022
2 Feb 27, 2022
7 Dec 19, 2022
3 Dec 2, 2022
0 Dec 9, 2021
0 Jan 14, 2022
3 Feb 9, 2022
420 Nov 29, 2022
7 Jul 26, 2022
2 Jun 25, 2022