rscplus

RuneScape Classic is made and owned by Jagex Ltd. and this project is not in any way affiliated with them.

There is no guarantee this client mod will not get you banned, use at your own risk.

The code is licensed under GPLv3 in hopes of protecting people from malicious modifications.

Contributing

• Fork the project
• Work on it
• Pull request the branch

I will not accept any game automation features (macroing, etc.)

Discord

Join our Discord server (Invite link)

Features

• Game resolution changing (about 80% complete)
• NPC Dialogue options with 1-9 on keyboard
• Roof hiding
• Option to always show combat style menu, and persistent combat style setting
• XP Drops
• Screenshots
• Mouse wheel zoom
• Middle mouse camera rotation
• HP, Prayer, and fatigue bars on the bottom right of the screen
• Fatigue on-screen alert at 100%
• Integrated Twitch chat into in-game chat
• Inventory free space counter
• Highlight friends and show their names when they're near you
• Notifications for PMs, trades, duel requests, low HP, and high fatigue
• Configurable item name patching
• And more...

Controls

Most keybinds are configurable via the Settings GUI

• Middle mouse click - Rotate camera
• Mouse wheel scroll - Zoom camera
• Ctrl + o - Open the options/settings window
• Ctrl + s - Take screenshot (Saved in the screenshots directory)
• Ctrl + r - Toggle roof hiding
• Ctrl + c - Toggle combat experience menu
• Ctrl + f - Toggle fatigue alert at 100%
• Ctrl + v - Toggle inventory full alert
• Ctrl + e - Toggle inventory count overlay
• Ctrl + u - Toggle Hits/Prayer/Fatigue display
• Ctrl + g - Toggle Friend info
• Ctrl + d - Toggle debug mode
• Ctrl + t - Toggle twitch chat hidden/shown
• Ctrl + i - Toggle Item info
• Ctrl + n - Toggle NPC info
• Ctrl + p - Toggle Player info
• Ctrl + h - Toggle hitboxes for NPC info
• Ctrl + [ - Toggle XP drops
• Ctrl + ] - Toggle fatigue drops
• Ctrl + l - Logout
• Ctrl + z - Toggle colored chat text in terminal
• Ctrl + 1-5 - World switch on login screen

Chat Commands

::help - displays all keyboard commands and chat commands in game

::[skillname] - Tells skill level and xp in chat

::next_[skillname] - Tells how much xp needed until next level in chat

::total - Shows total level and total xp in chat

::fatigue - Shows the fatigue percentage accurately in chat

::screenshot - Take screenshot (Saved in the screenshots directory)

::toggleroofs - Toggle roof hiding

::togglecolor - Toggle colored text in terminal

::togglecombat - Toggle combat experience menu

::togglefatigue - Toggle fatigue alert at 100%

::debug - Toggle debug mode

::togglelogindetails - Toggle IP/Dns login details shown at welcome screen

::toggletwitch - Toggle twitch chat hidden/shown

::toggleiteminfo - Toggle Item info

::togglenpcinfo - Toggle NPC info

::toggleplayerinfo - Toggle Player info

::togglehitbox - Toggle hitboxes for NPC info

::togglexpdrops - Toggle XP drops

::togglefatiguedrops - Toggle fatigue drops

::fov <value> - Change FoV to specified value (range of 7 to 16)

::logout - Logout

::togglefriendinfo - Toggle Player info for Friends only

::toggleinvcount - Toggle the overlay of current inventory used

::togglestatusdisplay - Toggle Hits/Prayer/Fatigue display

::cmb - WARNING! Because of color codes, this command will break the character limit and may be bannable. Don't send this command across PM to RS2/RS3 because they'll see a bunch of RS1 color codes and you may get banned if you're reported. Mimic's osbuddy's !cmb; outputs combat level (with decimal), Att, Str, Def, Hits, Ranged, Magic, and Prayer levels.

::cmbnocolor - Mimic's osbuddy's !cmb; doesn't use color codes and is within character limits

::xmas - Formats your message in festive Red Green and White colours

::rainbow - Formats your message in all the colours of the rainbow (or at least 6)

::system - Hides your username and outputs your message

::update - Manually check if RSC+ is up to date

Config Options

User configured via the settings GUI or config.ini only

name_patch_type

Range: 0 to 3
Sets how item names are patched:

0. No item name patching
1. Purely practical name changes (potion dosages, unidentified herbs, unfinished potions)
2. Capitalizations and fixed spellings on top of type 1 changes
3. Reworded vague stuff to be more descriptive on top of type 1 & 2 changes

save_logininfo

Range: true or false
Sets whether login information is retained between logins during the same session

software_cursor

Range: true or false
Sets whether a custom cursor overrides the default cursor

twitch_channel

Your Twitch channel name

twitch_oauth

Your Twitch OAuth token (not your Stream Key)

twitch_username

Your Twitch username

view_distance

Range: 2,300 to 10,000
Sets max render distance of structures and landscape

fatigue_figures

Range: 1 to 7
Sets max number of digits to display after the decimal point on fatigue drops

Automatically configured via user input in game or the settings GUI

combat_menu

Range: true or false
Sets whether the combat style choices are displayed outside of combat

combat_style

Range: 0 to 3
Sets combat attack style

0. Controlled
1. Aggressive
2. Accurate
3. Defensive

custom_client_size

Range: true or false
Enables resizing the client on startup to the specified size. When set with the settings GUI, it will resize the game immediately.

custom_client_size_x

Min: 512
Default width of client at startup

custom_client_size_y

Min: 346
Default height of client at startup

debug

Range: true or false
Sets whether debug mode is enabled

duel_notifications

Range: true or false
Sets if notification is shown when receiving a duel request

fatigue_alert

Range: true or false
Sets whether a large notice is displayed when fatigue approaches 100%

fatigue_notifications

Range: true or false
Sets if notification is shown when fatigue gets over a specified value

fatigue_notif_value

Range: 1-99
Sets fatigue value when a high fatigue notification is triggered

hide_roofs

Range: true or false
Sets whether rooftops are hidden

inventory_full_alert

Range: true or false
Sets whether a large notice is displayed when the inventory is full

logout_notifications

Range: true or false
Sets if notification is shown when about to log out from not moving

low_hp_notifications

Range: true or false
Sets if notification is shown when players HP is below a specified percent

low_hp_notif_value

Range: 1-99
Sets HP percent value when a low HP notification is triggered

notification_sounds

Range: true or false
Sets if a sound is played when a notification is triggered

pm_notifications

Range: true or false
Sets if notification is shown when receiving a PM

show_hitbox

Range: true or false
Sets whether the clickable areas on NPCs and players are visible

show_iteminfo

Range: true or false
Sets whether item names appear over dropped items

show_npcinfo

Range: true or false
Sets whether NPC names appear over NPCs

show_playerinfo

Range: true or false
Sets whether player display names appear over players; does not affect players on your friends list

show_logindetails

Range: true or false
Sets whether login details such as IP or DNS will appear at the login screen

show_xpdrops

Range: true or false
Sets whether XP drops appear on screen

show_fatiguedrops

Range: true or false
Sets whether fatigue drops appear on screen

trade_notifications

Range: true or false
Sets if notification is shown when receiving a trade request

tray_notifs

Range: true or false
Enables or disables all notifications

tray_notifs_always

Range: true or false
If false, notifications will only trigger when the client window is focused. If true, notifications will always trigger, regardless of client window focus.

twitch_hide

Range: true or false
Sets whether Twitch chat is shown in game chat

use_system_notifications

Range: true or false
Sets if system notifications are used instead of custom notifications. Set to false if your system doesn't support notifications or if you don't like the appearance of your system's notifications

world

Range: 1 to 5
Sets current world to login to

Building

You must have git, apache-ant, and jdk 1.7+ installed to do this.

git clone https://github.com/OrN/rscplus
cd rscplus
ant dist

The result should be in the bin folder.

Before submitting a pull request, please update the version number using ant:

ant setversion

There is also an Eclipse project in the source root you can import.

Contributors

Check here

Thanks to Warriorccc0 (Brinner) for testing various things on Windows.

Download

The latest release can be found here (rscplus.jar).