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 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/circle pad to control camera
• touch screen for mouse input
• hold L whilst tapping touch screen for right click
• tap R to toggle top screen zoom
• hold L whilst using d-pad or analogue stick to pan top screen zoom
• start to toggle on-screen keyboard
• select to toggle F1/interlace mode

• 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.

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.

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 = 127.0.0.1
port = 43594
; 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 =
rsa_modulus =
; 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"

; 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

; 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 doubleoriginal
; 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 = 1
; 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

; 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

• tiny-bignum-c for RSA encryption on login/registration
• micro-bunzip for decompressing cache archives
• libsdl2 for input/output on desktop
• glew for runtime opengl extension loading
• ini for parsing options.ini

Copyright 2022 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/.