CrackedShell

a cracked copy of shell shockers, used for mod injection.

if you find a bug, open an issue and i'll do my best.

WTF is this??

CrackedShell is a modified copy of Shell Shockers that allows you to inject mods into the game.
This works with a combination of a server-side "proxy" & URL params.

How can I use this?

We do not offer any pre-deployed version at this time.
Here's how to set up your own copy:

Install Node.JS, NPM, & git.
Clone the repository from git: git clone https://github.com/VillainsRule/CrackedShell && cd CrackedShell
If it is not already on your machine, add PNPM: npm i -g pnpm
Install dependencies: pnpm i
Configure the game in config.js (see the Configuration section for more information)
Run the server: pnpm dev
Visit the game at localhost:6900!

If you want a public instance, try this:

Install ngrok.
Run ngrok http {{port here}} (example: ngrok http 6900) in another terminal.
Ngrok should input a URL you can visit on any device.

WARNING: THIS URL CONTAINS YOUR IP ADDRESS. Be careful who you give this to.

Configuration

Local CrackedShell instances can be configued in config.js. Here's what's going on in there:

port

This tells the server what port to run on.
If you're a developer and are using port 6900 for something else, change this. If not, ignore it.

cacheable

This specifies allowed script origins in the cache.
This prevents your server/computer from being IP logged from malicious scripts put in the /mod page.
If you don't care about your privacy, you can add the * script to disable this entirely.

Note: the default scripts are ALL trusted raw script sources that will not attack your computer.

server

This allows you to customize the Shell Shockers server host.

url

This specifies the URL of the server. You're best off using an official Shell Shockers instance such as shellshock.io.
If hosting locally, use localhost:port.

secure

This specifies whether or not the server is secure (wss:// or ws://).
For official servers, set this to true. For locally hosted servers, set it to false.

custom

This is a boolean that helps you make connect custom servers.
Keep this as false unless instructed to by the server provider.

Replacements

If you are the host of a CrackedShell instance, you can force files to be replaced.
Here's how:

Make a folder named replacements/ in the root CrackedShell folder.
Encode the file name in Base64 and then put it in replacements/. Do NOT add extensions.
Add the contents to replace into the file!

The server will replace the file when sending server data!

Developer Information

Hey, fellow Developers! Here's a bit of information on turning your Tampermonkey script into a CrackedShell script!

Supported GM values

CrackedShell supports a few GM values & defines them no matter what:

GM_getValue (using localStorage.getItem)
GM_setValue (using localStorage.setItem)
GM_deleteValue (using localStorage.removeItem)
GM_listValues (using localStorage)
GM_setClipboard (using navigator.clipboard.writeText)

If you need a GM value that isn't defined here, add a workaround or open a pull request!
These values are not exposed to the window, so don't worry about being detected!

shellshock.js Server Modification

In order to fix WebSocket issues, shellshock.js is modified on the server. Here's the list of patches:

['||location.host,', '||\'risenegg.com\','], // replace /matchmaker/ socket
['${location.hostname}', 'risenegg.com'], // replace /services/ socket
['dynamicContentRoot+', `"risenegg.com"+`], // replace /services/ socket
['window.location.hostname', '"risenegg.com"'], // replace /game/ socket
['isHttps()', 'true'] // fix socket http issues

This would prioritize anything done with injected scripts.
If you want an original copy of the Shell Shockers JS script before it's modified, you can fetch /js/shellshock.og.js.
Do NOT use this to replace script injection. It will cause WebSocket errors - the modified code is shown above.

isCrackedShell

You can detect CrackedShell clients with a isCrackedShell boolean on the scope of your script.
Like the GM modifications, this is undetectable.

Caching

The cache is a way we store large masses of code.
Storing them locally and removing the fetching requirement speeds up script injection.
In order to prevent the server IP from being logged, we only allow the following script sources:

You can add or remove these in the config.

More Information

Not all information is contained in these docs.
If you want to learn more, read the codebase - it's a small number of files with simplistic & modern code.

Memelite70 / CrackedShell