portable, enhanced runescape classic client ported to C99. supports 204 and 177 protocols. original mudclient204 java source refactored by v0rtex/xetr0v and Isaac Eggsampler. compatible with openrsc and 2003scape.
prominent new features include:
- native ports for 3ds, switch, wii, web browser and desktop
- opengl/webgl renderer with customizable field of view
- dynamic resizable mode with interface scaling and new minimum resolution of 320x240
- 3D model ground items based on runescape 2 beta models
- runescape classic wiki button
- bank interface with scrollbar and search
- ...and more!
QR code for 3DS install:
- d-pad/circle pad to control camera
- touch screen for mouse input
- hold L whilst tapping touch screen for right click
- start to toggle on-screen keyboard
- select to toggle top screen's power
- A, B, X, Y, R to select option menus (context dependent)
- d-pad to control camera
- B for right click
- A for left click
- - to toggle on-screen keyboard
- B for backspace whilst keyboard is open
- + to press enter key
- 1 to toggle F1/interlace mode
a USB keyboard and mouse can also be used.
- d-pad/left stick to control camera
- A for Enter
- B for Backspace
- X for Tab
- Y for Home
- L for Escape
- R to toggle fps display
- ZR is reserved for future use
- touch screen for mouse input
- hold ZL whilst tapping touch screen for right click
- + to toggle on-screen keyboard
- - to toggle F1/interlace mode
install libsdl2-dev. if compiling with opengl support, also install libsdl2-image-dev, libglew-dev, libgl-dev, and pkgconf.
$ make
$ ./mudclient
distribute with ./cache directory.
install mingw-w64.
use wine to test locally.
$ make -f Makefile.windows
$ wine mudclient.exe
distribute with ./SDL2.dll, ./glew32.dll and ./cache directory.
building requires at least 256MB of ram and a pentium pro or greater processor
download gcc-win98.
download mingw.
extract gcc win98 to C:\gcc_win98
install mingw to C:\mingw
inside C:\mingw\bin copy the mingw32-make.exe as make.exe
edit autoexec.bat on drive C and add
PATH=C:\mingw\bin
then run the following in a command window
make -f Makefile.win9x
distribute with ./SDL.dll, ./SDL_image.dll, and ./cache directory.
test locally.
pentium pro or greater processor
64MB of ram
windows 95 or 98
note OS must have comctl32, winsock 2, and msvctr
on windows 95 might need to install ws2setup.exe, 401comupd.exe, and find a copy of msvctr.dll
install and activate emscripten emsdk.
$ make -f Makefile.emscripten
$ python3 -m http.server 1337 # @ http://localhost:1337/mudclient.html
host mudclient.{html,data,js,wasm} and ./cache/ directory.
follow the pre-requisites listed on SDL's website.
you should only need to run the following commands:
export ANDROID_HOME="/usr/src/android-sdk-linux"
export ANDROID_NDK_HOME="/usr/src/android-ndk-rXXx"
cd org.scape2003.mudclient/
./gradlew assembleDebug
the APK will be located at ./app/build/outputs/apk/debug/app-debug.apk. you
can also use ./gradlew installDebug to automatically build and install the APK
to a connected developer device.
tested with android-ndk-r24.
install
wii-dev package in devkitPro,
and optionally clone rgb-to-yuv2 to
re-build the _yuv .c files in ./src/wii/ from the PNGs in ./wii.
use dolphin-emu to test locally. enable LLE sound for sound-effects support. on real hardware you can also use a USB keyboard and mouse.
see ./build-wii.sh for building for Wii.
install
3ds-dev package in devkitPro,
and optionally bannertool and
makerom to build
an installable .cia file. use
citra to test locally.
see ./build-3ds.sh for building for 3DS.
install
switch-dev package in devkitPro,
switch-sdl2, and, switch-bzip2 to build
an .nro file. use
yuzu to test locally.
see ./build-switch.sh for building for Switch.
arguments:
[members]- pass any value other than "members" to load a free to play configuration
[ip address]- an IPv4 address where the RSC177/204 compatible server is hosted
[port]- network port number (e.g. 43594)
[RSA exponent][RSA modulus]- these two are used together to encrypt passwords, unique to each server. they must be converted to a hexadecimal representation 0-padded to a multiple of eight characters
for the desktop version, these are passed as command-line arguments. on the
web they're passed in the URL hash separated by commas
(http://localhost:1337/mudclient.html#free,127.0.0.1).
; IPv4 address with revision 177 compatible protocol support
server = game.openrsc.com
port = 43596
; Disable registration and load sounds, P2P landscape and items (requires
; restart)
members = 1
; If enabled, override members option and always show New User button
registration = 1
; Used together to encrypt passwords, Must be represented as hexadecimal string
; 0-padded to a multiple of eight characters
rsa_exponent = 00010001
rsa_modulus = 87cef754966ecb19806238d9fecf0f421e816976f74f365c86a584e51049794d41fefbdc5fed3a3ed3b7495ba24262bb7d1dd5d2ff9e306b5bbf5522a2e85b25
; Log out when mouse is idle
idle_logout = 0
; Remember username on login screen
remember_username = 0
; Remember password on login screen (not secure)
remember_password = 0
username =
password =
; System command to use to open the web browser (only on desktop)
browser_command = xdg-open "%s"
; Diversify NPCs sent by server (custom)
diversify_npcs = 0
; Rename Herblaw items for ease of identification (custom)
rename_herblaw_items = 1
; Scroll panel lists, chatbox, and camera (if zoom enabled) with wheel
mouse_wheel = 1
; Hold down middle click and move mouse to rotate camera (manual mode)
middle_click_camera = 1
; Use arrow, page, home keys and mouse wheel (if enabled) to zoom
zoom_camera = 1
; Respond to the last private message with tab key
tab_respond = 1
; Use number keys to select options
option_numbers = 1
; Adds a menu with different directions to face to the minimap compass
compass_menu = 1
; Adds right click menus to trades and duels
transaction_menus = 1
; Allow inputting item amounts
offer_x = 1
; Add another button to perform the last offer x amount
last_offer_x = 1
; Add RuneScape Wiki lookup button instead of report abuse
wiki_lookup = 1
; Combat style menu is usable outside of combat
combat_style_always = 0
; Hold to buy/sell items from shops in bulk (matches trade screen)
hold_to_buy = 1
; F1 mode - only render every second scanline
interlace = 0
; Display the FPS at the bottom right of the screen
display_fps = 0
; Double the UI size but keep the scene size if window is over double original
; size (GL only)
ui_scale = 1
; Enable multi-sampling
anti_alias = 1
; Change the field of view. scales with height by default and in
; software. About 36 degrees on the original height of 346 (GL only)
field_of_view = 360
; Show roofs unless inside buildings
show_roofs = 1
; Format large numbers with commas
number_commas = 1
; Show the remaining experience until next level in skills tab
remaining_experience = 1
; Show your total experience in the skills tab
total_experience = 1
; Show experience drops
experience_drops = 0
; Show a count of inventory items on the UI
inventory_count = 0
; Condenses item amounts with K and M and add their amounts to examine
condense_item_amounts = 1
; Also draw which item a certificate is associated with
certificate_items = 1
; Display the warning dialog near the wilderness border
wilderness_warning = 1
; Display hits and prayer bars
status_bars = 0
; Use ground item models instead of billboarded sprites
ground_item_models = 1
; Show text for valuable ground items to make them stand out
ground_item_text = 1
; Always animate objects like fires
distant_animation = 1
; Load less compressed (2001 era) sprites
tga_sprites = 0
; Show hover tooltip menu
show_hover_tooltip = 0
; Add filtering to the bank
bank_search = 1
; Adds capacity to the bank
bank_capacity = 1
; Adds total high alchemy value to the bank
bank_value = 1
; Expand bank item grid with client height
bank_expand = 1
; Use a scrollbar instead of bank pages
bank_scroll = 1
; Adds right click menus to bank items
bank_menus = 1
; Shows the inventory along with the bank interface, given enough width
bank_inventory = 1
; Maintain the selected bank slot when items change position
bank_maintain_slot = 1
- glew for runtime opengl extension loading
- ini for parsing options.ini
- isaac for authentic packet decoding
- libsdl2 for input/output on desktop
- micro-bunzip for decompressing cache archives
- tiny-bignum-c for RSA encryption on login/registration
Copyright 2024 2003Scape Team
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.