Mac Instructions (experimental)
Important: We are now logging important updates here.
Please check it out as the information there is very important.
Video version of the guide (Thanks Halondrus!): https://www.youtube.com/watch?v=1fYXmqy-h6o&pp=ygUYbmVvcGV0cyBmbGFzaCBndWlkZSAyMDIz
This contains your login cookies! If you do seek help from anyone, including myself, always logout which will invalidate your session cookie, and then log back in, to ensure that noone can use your cookies to login.
This guide is confirmed to work on Windows 10 and 11. The steps SHOULD work on Windows 7/8, also, but some things might be different, like installation paths.
This guide is overly detailed to make it approachable, so don't be put off by all the steps. It should be as easy to follow as possible. Some computer knowledge will definitely help.
Please read this entire guide before starting. You don't need to memorize it, but some information later on will definitely prove useful during installation, and there is no way to order everything perfectly for all use cases.
Flash and Shockwave are dead content. Do not use flash/shockwave enabled browsers for anything other than Neopets (or other trusted flash game sites). Even then not I, nor anyone else can guarantee your safety using these extensions, so do so at your own risk!
You must install Fiddler Classic. This is because Neopets forces SSL (HTTPS) now, and the games were never updated to support SSL/HTTPS. There are also some other game-specific issues that Fiddler allows us to fix.
Fiddler, as configured, will act as a Man-in-the-middle (which is a good thing in this case, because YOU are the man-in-the-middle), which allows your browser to connect to Fiddler over HTTP, and then Fiddler bridges the connection to Neopets over HTTPS.
This is absolutely required in order to play nearly all Flash/Shockwave/3dvia games, and is the most complicated part of the installation, but if you follow the steps as described, you will be okay! I will try to respond to Issues submitted to this repository for the short term, and update the guide accordingly.
Installation Instructions:
- Install Fiddler Classic (NOT "Fiddler Everywhere") There is no email confirmation, so just put in a fake email.
- Find fiddler script folder (usually Documents\Fiddler2\Scripts) and save CustomRules.js to that directory. Alternatively, you can copy/paste the file contents into Fiddler->Rules->Customize rules (erase everything in there first), and hit Ctrl+S to save. You should hear a slight ding.
- In Fiddler go to Tools -> Options -> HTTPS.
Enable:
- Capture HTTPS CONNECTs
- Decrypt HTTPS Traffic
- Ignore Server Certificate Errors.
- Click Actions->Export Root Certificate to Desktop (This is to make Pale Moon trust the localhost and not give you constant certificate errors)
- Click Actions->Trust Root Certificate. This will make other browsers (like Chrome), and Windows apps such as Discord, also trust the proxy (Fiddler). This isn't strictly necessary, but if it's not done, you won't be able to use Chrome/Discord/Etc while Fiddler is running and intercepting traffic.
- To install this certificate into Pale Moon, Open Pale Moon, and click the button/toolbar that says, "Pale Moon" at the top left of the browser (menu bar), and click Preferences. Then go to the "Advanced" tab, and then choose the "Certificates" sub-tab. Click "View Certificates" then click "Import" and locate the exported certificate on your desktop. It is named "FiddlerRoot.cer"
- Important: Add exclusions to your proxy: In Fiddler, go to Tools->Options->Connections, and add the following into the "Bypass URLs that begin with..." field:
<-loopback>;discord.com; discordapp.com; netflix.com; *.discord.com; *.discordapp.com; *.netflix.com; *.discordapp.net; discordapp.net; *.google.com; google.com; *.gmail.com; gmail.com; *.youtube.com; *.gstatic.com; *.cloudflare.com; *.googleapis.com; *.jquery.com; *.googlevideo.com; support.neopets.com
- Download the neopets folder in this project
- Find fiddler installation path (usually C:\Users\YOUR_USERNAME\AppData\Local\Programs\Fiddler or C:\Program Files\Fiddler), create a folder named "neopets" and extract the downloaded neopets.zip files into it. The extracted files should end up looking like C:\Users\YOUR_USERNAME\AppData\Local\Programs\Fiddler\neopets\games...
- Close Fiddler.
- Start Fiddler whenever you want to play Neopets games :)
Notes:
#5. You can remove this certificate later via Windows Certificate Manager (certmgr.msc->Trusted Root Certification Authorities->Certificates). The name of the certificate is DO_NOT_TRUST so that you're well aware it's a local certificate, and not from a trusted Certificate Authority (CA). It is safe to trust this certificate, BUT the implications are that you will not see any genuine certificate errors from websites, so you should keep Fiddler closed when you're not using it, and you should remove the certificate if you stop playing Neopets games.Fiddler seems to need "Capture Traffic" enabled in order to work consistently (feel free to experiment). This means it logs every packet that is proxied throuogh it. So while you can watch Youtube on Chrome while running Fiddler, you should clear out the history/restart Fiddler once in a while, otherwise it will start using up all your memory holding a copy of every video packet!
- Remove any existing installed Adobe Flash installations. If running less than Windows 10, restart after each removal/installation.
- Browser: Install Pale Moon 64-bit latest (31.4.2 at time of writing, so use that version if you have issues)
- Install Flash version 32.0.0.371 Download Flash Installer from Archive.org's Adobe Mirror | Alternate Link
- Disable Auto Update for Pale Moon
- That's it! As long as Fiddler is installed and running as directed, you should be able to play nearly all of the Flash games!
Make sure you have installed the FiddlerRoot.cer certificate as explained in Fiddler->Notes #4
- Browser: Install Pale Moon 32-bit, version 28, if not already installed. Download
- Disable Auto Update for Pale Moon
- Ensure Fiddler is configured and running, and then try to play a 3dvia game, like Shenku River Rush (just River Rush in the game list)
- This should automatically launch the installer the first time
- Enjoy!
Notes:
Make sure you have installed the FiddlerRoot.cer certificate as explained in Fiddler->Notes #4You can install both 64-bit and 32-bit versions at the same time, but the one you install second will overwrite the shortcut, so you should create a new shortcut to the first installation.
When you want to switch game-platforms, just close Pale Moon, and start the other version.
- Important! You need to follow the 'Bad Driver Bug' direction
- Browser: Install Pale Moon 32-bit, version 28, if not already installed. Download
- Disable Auto Update for Pale Moon
- Ensure all previous Shockwave installations are removed, and Pale Moon is closed.
- Ensure Pale Moon is closed, and then run the Shockwave installer. Download Shockwave 10.1.3.018 from Archive.org
- Important! Before starting Pale Moon again, you must copy "C:\Program Files (x86)\Pale Moon\plugins" From "C:\Program Files (x86)\Pale Moon", copy the "plugins" folder and paste it into your "%appdata%\Moonchild Productions\Pale Moon\Profiles\RANDOM_NAME.default" directory. RANDOM_NAME will be different for you, but you can put "%appdata%\Moonchild Productions\Pale Moon\Profiles" into the Run box (without quotes) and it should open up the directory containing your profile folder.
- Start Pale Moon (32-bit version) and try to play a Shockwave wave like Hannah and the Pirate caves!
- See notes below, and Troubleshooting farther below for resolutions to common issues.
- Recommended: Before you click the "Play" button to load the game, verify: Rules->Shockwave Tweaks->Enabled. I spent countless hours refining this selection of tweaks to get the best results out of each Shockwave game :)
Bad Driver Bug
- See full details here: https://gaming.stackexchange.com/questions/339173/how-can-i-play-dcr-shockwave-games?newreg=534f64e9e2ad4f698d7c1607667a48df
Quick fix:
- Open run box / start and type regedit and hit enter.
- Navigate to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Video
- Search (Ctrl+F) for InstalledDisplayDrivers
- Double click InstalledDisplayDrivers and remove all the paths / duplicates.
Example: If your InstalledDisplayDrivers looks like this:
C:\WINDOWS\System32\DriverStore\FileRepository\nv_dispi.inf_amd64_f840d03a202f8a32\nvldumdx.dll,C:\WINDOWS\System32\DriverStore\FileRepository\nv_dispi.inf_amd64_f840d03a202f8a32\nvldumdx.dll,C:\WINDOWS\System32\DriverStore\FileRepository\nv_dispi.inf_amd64_f840d03a202f8a32\nvldumdx.dll,C:\WINDOWS\System32\DriverStore\FileRepository\nv_dispi.inf_amd64_f840d03a202f8a32\nvldumdx.dll C:\WINDOWS\System32\DriverStore\FileRepository\nv_dispi.inf_amd64_f840d03a202f8a32\nvldumd.dll,C:\WINDOWS\System32\DriverStore\FileRepository\nv_dispi.inf_amd64_f840d03a202f8a32\nvldumd.dll,C:\WINDOWS\System32\DriverStore\FileRepository\nv_dispi.inf_amd64_f840d03a202f8a32\nvldumd.dll,C:\WINDOWS\System32\DriverStore\FileRepository\nv_dispi.inf_amd64_f840d03a202f8a32\nvldumd.dll
Change it to:
nvldumdx.dll
nvldumd.dll
You might get this error, just ignore it (it's from not having a blank line after the last entry, I believe):
Data of type REG_MULTI_SZ cannot contain empty strings.
Registry Editor will remove all empty strings found.
Additional Shockwave Notes: (See Troubleshooting below if you still have issues)
When a game does not load/gets stuck at loading, try enabling:
Fiddler->Rules->Performance->Simulate Modem Speed
and reload it. (More details in Troubleshooting section step #5. You can also try right-clicking in the game area and clicking Restart, and/or reloading the game a few times.
Hannah and the Ice Caves: if you get the "Sorry. It appears that this game is not running at its intended location" error, you need to press and hold Shift + o + k. If that doesn't work, try it while it's loading.
If you have gameplay issues/glitches, you can try the 10.1.0.110 installer, but I haven't had any trouble with 10.1.3.018, other than a rare freeze/restart being necessary.
Be patient, sometimes you have to wait for it load a while, or let it continue, or even restart. But it should work 99% of the time once you get it working.
Make sure you have installed the FiddlerRoot.cer certificate as explained in Fiddler->Notes #4
- You should try and load a page on Neopets just before you submit your score to try and prevent Stackpath errors.
- However, if your score fails to submit, you can visit the virtual URL: https://www.neopets.com/fixscore which will automatically resubmit the score in the browser, solving Stackpath naturally.
- If you see errcode=17 in the score output result (only visible via the fixscore link, or Fiddler logs), this is caused by the "session ID" being invalid. This can happen if you load up the same game twice, or at approximately Midnight NST, all sessions are cleared. (This prevents scores from being submit much later)
- If you don't even SEE a process_xxx_score.phtml packet, and you see a couple oddly-placed zeros instead of the score-submission screen, this seems to be caused by the Flash game being in a bad state. Try next two steps.
- In Fiddler, if you go to Rules->Performance->Simulate Modem Speeds, and then reload the game with cache disabled (open Pale Moon's Inspect Element tool inside the game window (try the outside edges outside the game area), click the Settings/Gear icon in the top-right of the Inspect window, and then enable "Disable HTTP Cache (when toolbox is open)", then reload the game with the Inspect window open and Simulate Modem Speeds enabled. This will make the game take a while to load, but it's worth it, because you don't have to reload it constantly and pray that your score will submit when you finally get a good one.
- If the game fails to load and gets stuck at the loading screen, try step #5, or reloading the game a couple times. Restart the browser if all else fails, especially with Shockwave, we're using old versions which can crash and freeze occasionally.
- If 3dvia games are the ones not working, go here and accept risk if prompted. (It probably means you didn't install/trust the certificate in the Fiddler instructions)
- If Hannah and the Ice Caves says, 'Sorry. It appears that this game is not running at its intended location', hold Shift + O + K (in that order) and it should start right up. Make sure you click inside the game window first. (letter O, like OK)
- If you have issues where the keyboard input isn't working, like in Faerie Bubbles, or Kiko Racing, you are probably running the Flash games in the 32-bit browser. Close Pale Moon, and restart it from the 64-bit installation. (You can fix it on 32-bit mode by adding "ProtectedMode=0" to c:\windows\SysWOW64\Macromed\Flash\mms.cfg and restarting the browser.)
- If you get the sad Usul saying Shockwave is not installed, either 1. You used your own "slim" installer for shockwave, or 2. You didn't copy the plugins directory to your user profile.
- If the game doesn't fit / runs outside the window, this is usually because you're zoomed out. Reset zoom to 100% and reload the game.
- Terror Mountain Tilt: If you can't distinguish the colors of the rings, try switching to OpenGL or another renderer by right-clicking the game and going to Properties, iirc.
- If Dice Escape is the only Shockwave game you can't get working, you need to do the "Bad Driver Bug" fix listed above.
- Pale Moon 64-bit default location: c:\Program Files\Pale Moon\palemoon.exe
- Pale Moon 32-bit default location: c:\Program Files (x86)\Pale Moon\palemoon.exe
- Thank you to juvian for the original version of this guide, got me a good deal of the way there, and I was only able to make this based off their amazing work with Fiddler.
- Thank you to andkon.com: their amazing FAQ is the first resource I found, which got me going early.
- andkon.com also has a "SECURITY CONSCIOUS WALKTHROUGH" on the linked page, which proves the authenticity and source of all provided binaries. (The linked binaries herein come from archive.org's adobe mirror)