Before installing this script, make sure you have installed (and enabled) a user script manager on your browser. At least one of the following extensions should be available for your browser: Tampermonkey, Greasemonkey, Violentmonkey.
Warning: On Mozilla Firefox, do not use Greasemonkey (at least, not Greasemonkey 4) because this script does not work in Greasemonkey 4. Luckily, every other browsers supporting Greasemonkey should have an earlier version of it available (in case of doubt, just check the version). The other script managers will work without any issue, no matter the browser.
With this user script, you will be able to choose between different swf players to play Flash games on Kongregate:
- Adobe Flash Player, provided you got a working version of Flash and a browser that supports it (otherwise, the "Flash" button will make the game load in Ruffle)
- SuperNova
- Ruffle (if you use the Kong Flash API patcher user script from Colin969 on top of mine, games will submit high scores!)
- AwayFL
To switch player (or simply reload the game), click on the appropriate button, right above the game.
When loading a Flash game page, the player used to load the game is chosen based on your plugins, browser and operating system: Flash if you can use it, else SuperNova for Windows users and Ruffle for the others. If this choice does not suit you, you can use this second script to set the swf player that you would want to use by default.
Note: the Kongregate Flash games fixer is not meant to work on games that are hosted outside the Kongregate servers (in other words, the multiplayer games [more or less]; for example Crusaders of the Lost Idols). If you really want it to be compatible with one of these games, send me a message on my Kongregate profile and I will see what I can do (however, I cannot guarantee I would succeed).
Additional features
- Kongai's match chat is working.
- Kongai's in-game "card album" button opens the correct URL.
- When viewing someone else's card album, one can switch between different card sets without being redirected to their own card album.
- An old bug related to cinematic mode (game seemingly not loading but reappearing when toggling on and off the cinematic mode) is fixed (for every games, actually).
Known issues
When using Flash, if you are only seeing a black screen while still being able to hear the game audio, then this page should help you solve your problem.
SuperNova (no control over that): parts the Kongregate API do not work (including high scores submission), there is no right-click menu, and the player only works on Windows.
Ruffle is still in development, so not all game will work and not all games that work will work perfectly. However, once Ruffle is 100% finished, all issues should disappear. Combine my user script with the Kong Flash API patcher from Colin969 to make games submit high scores with Ruffle.
AwayFL is still in development.
Kongai is only playable with Flash right now (because they build their games like they built their website...).
If a player does not work, switch to another one, or switch browser. The Kongregate Flash games fixer has been successfully tested on Firefox, Edge, Chrome, Pale Moon, White Star, Basilisk and Waterfox Classic. However, current versions of the first three no longer support Flash.
Feel free to report any not-mentionned bug or give suggestions by leaving a review here or a message on my Kongregate profile.
If you get good results on any unmentioned browser, then I would love to know it, too, so I can add it to the list.
Changelogs
(June 6th 2024) Version 8.3:
- Games for which the main file is missing CORS headers will now be automatically detected and will be taken from their konggames.com associated subdomain instead of the normal one.
(June 6th, 2024) Version 8.2:
- Removed CORS workaround in the AwayFL part for games that no longer need it.
- A few games are somehow still lacking CORS headers so I added a list of games to which the previous workaround should still apply. This list has to be updated manually, and contains for now The Space Game, The Space Game: Missions and Dibbles 4: A Christmas Crisis.
- Updated AwayFL's javascript URL.
(May 26th, 2024) Version 8.1:
- Kongregate fixed the cross-origin ressurce-sharing issues on their end, so I removed the workarounds related to them in the Ruffle part.
(May 18th, 2024) Version 8.0:
(March 25th, 2024) Version 7.3:
- Fixed the buttons not showing up on localized game pages.
(March 24th, 2024) Version 7.2:
- The script is now working on "localized" game pages (like https://www.kongregate.com/fr/games/drakonian_lord/wondrous-lands). That bug had gone unnoticed until now (why did not anybody warn me?!).
- Fixed loading issues in some very old browsers such as Mozilla Firefox 52.9.0esr.
- Prevented potential loading issues to arise in the future.
(December 9th, 2023) Version 7.1:
- Replaced the URL which AwayFL was loaded from to the official one (the latter did not previously work on Kongregate).
- Enabled blend modes and filters in AwayFL.
(November 26th, 2023) Version 7.0:
- Added AwayFL as a fourth swf player.
(August 9th, 2023) Version 6.2.1:
- Corrected the bug fix released in the previous version: it was accidentally breaking the cinematic mode (oups!).
(July 23rd, 2023) Version 6.2:
- Fixed an old Kongregate bug that sometimes makes games not load (or look like they did not load).
(July 18th, 2023) Version 6.1:
- swf hosted on assets.kongregate.com and internal.kongregate.com can now be played in Ruffle from their original URL instead of konggames.com thanks to Kongregate finally adding the appropriate CORS headers.
- Added scroll bars to the SuperNova interface.
- Minor changes to the Ruffle configuration.
(June 9th, 2023) Version 6.0:
- Ruffle stopped polyfilling (in other words, automatically converting as Ruffle content) Flash content on browsers with Flash supported (and installed?). I updated the script accordingly, which fixed the bug that I could not fix completely in version 5.9.
(May 31st, 2023) Version 5.9:
- Fixed the Flash embedding in certain browsers (like Pale Moon), which had been broken by a Ruffle update. It was not fixed for every browsers.
(March 28th, 2023) Version 5.8:
- Files loaded in Ruffle will now always load over the protocol of the game page, as the "download" option is affected by CORS.
(March 22nd, 2023) Version 5.7:
- Modified flashvars passed to Ruffle, fixing various problems (for example, making hitBox playable).
- Flashvars' initialization will now occur in a separate function than the game loading. This will have no impact on users' end, but may have testing interests.
(March 10th, 2023) Version 5.6:
- Fixed Kongai's match chat images not loading under certain circumstances.
- Fixed buttons not loading under certain circumstances.
- Prevented a potential new bug from happening in the future, should the proper reuirements ever be met.
(March 10th, 2023) Version 5.5:
- Changed the source of the SuperNova javascript to an archived version (on archive.org), as the script apparently break when the original is unaccessible (oups, sorry!).
- Changed the source of the SuperNova logo to an archived version (on archive.org).
(March 4th, 2023) Version 5.4.1:
(February 3rd, 2023) Version 5.4:
- The script is now able to tell the difference between AVM1 games and AVM2 games when Kongregate sets all of them to load with Ruffle. For now...
(December 2nd, 2022) Version 5.3:
- Changed the execution time of each part of the script, improving various loading times.
- Fixed some execution issues on the game pages.
- Minor changes and bug fixes.
(November 11th, 2022) Version 5.2.1:
- Set the wmode Flash parameter to "direct" for every games, because its value can no longer be found when it is needed. It might or might not break something... Time will tell.
(October 18th, 2022) Version 5.2:
- Flash games set by Kongregate to load with Ruffle can now be played again with Flash in any browser supporting Flash (sorry for taking so long!).
- Added the option to play AVM1 games inside their game shell to the unofficial SuperNova interface.
- Changed the Ruffle logo's source to an archive.org one to fix a random loading error for it.
- Fixed a random loading error for my fix to Kongai's match chat in some browsers (I think).
- Revamped a good portion of the code (141 less lines!). Users will not be impacted, besides seeing previously local variables becoming global, and seeing the iframes URL being modified differently when switching swf player.
(October 10th, 2022) Version 5.1.2:
- Divided the "play" button of the unofficial SuperNova interface into two buttons: one that opens the http version of the game file and another one that opens the https version.
(October 6th, 2022) Version 5.1.1:
- On Windows, games that Kongregate set to load with Ruffle will now load again by default in SuperNova (instead of Ruffle) if Flash is not installed.
(October 1st, 2022) Version 5.1:
- Added missing Flashvars when playing in SuperNova, which fixed a loading issue with Bloons TD 5 (and maybe other games).
(September 29th, 2022) Version 5.0.4:
- Fixed a loading issue with Bloons TD 5 (and maybe other games) when using Flash.
- Fixed a loading issue with Enigmata: Stellar War in SuperNova.
- May have fixed other loading issues in SuperNova.
(September 29th, 2022) Version 5.0.3:
- Fixed a loading issue with Kingdom Rush Frontiers in SuperNova.
(September 28th, 2022) Version 5.0.2:
(August 29th, 2022) Version 5.0.1:
- Fixed some color glitches.
(August 27th, 2022) Version 5.0:
- Fixed almost every problems that were caused by the changes made by Kongregate on August 24th.
- Only one issue remains: in browsers that are compatible with Ruffle, games that Kongregate set to load with Ruffle does not load with Flash, but with Ruffle.
(August 20th, 2022) Version 4.0.1:
- Set the buttons' position to match the one of the normal buttons.
(August 20th, 2022) Version 4.0:
- Added the option to play games with Ruffle, even though only a third of Kongregate games may currently be playable.
- Changed the default swf player to Ruffle for non-Windows users without Flash.
- Most important feature ever: added icons to the buttons!
(August 7th, 2022) Version 3.4.3:
- When playing Kongai, private conversations will now occur in both the "chat" and "match chat" tabs, so that players no longer miss messages.
- Last update related to Kongai's match chat (and Kongai in general): added the error notice for too long messages, added the "characters remaining" count and visually improved the tab to make it look neater (and normal).
(July 22nd, 2022) Version 3.4.2:
- Added the missing wmode Flash parameter to the cases where it is needed.
- Kongai's match chat is now working!
- When viewing someone else's Kongai card album, users can now switch card sets without being redirected to their own card album.
(April 17th, 2022) Version 3.4.1:
- Fixed my previous fix of the images in Kongai's match chat... They were only loading if Flash was allowed to run after the page loaded.
(April 10th, 2022) Version 3.4:
- Fixed images in Kongai's match chat.
- Kongai's in-game "view card album" has been opening the wrong link for ages, so I have decided that a URL of the type www.kongregate.com/accounts/username/card_album shall be redirected to www.kongregate.com/accounts/username/card_albums.
(February 26th, 2022) Version 3.3.3:
- If your browser is not fully compatible with the SuperNova code (which would lead to the SuperNova interface not loading), then instead of a white/black/whatever screen, you will see a replacement to the interface which allows to download the SuperNova player and launch the game (in other words, it is a simplified but maybe better version of the official one!). It may also appear if the loading of a game page is too slow, but I guess it is not a big problem.
- Changed how certain values were obtained, which might prevent some bugs in the future.
(February 22nd, 2022) Version 3.3.2:
- Changed how certain values were obtained. This fixed a few bugs and may prevent some future bugs.
(February 18th, 2022) Version 3.3.1:
- Fixed a bug that appeared with last update, which made the games load twice instead of once with SuperNova in some browsers.
(February 17th, 2022) Version 3.3:
- Partially fixed SuperNova in most (if not all) browsers that are incompatible with it: the interface will not load (thus, you will see a blank screen, a black screen or something like that in the game area), but as long as the SuperNova is already installed on you computer, the games should load. (Successfully tested on Pale Moon and Basilisk.)
(February 9th, 2022) Version 3.2.3:
- Trying to play with Flash in a browser that does not support it should now always bring some kind of "this plugin is not supported" message.
(February 8th, 2022) Version 3.2.2:
- It seems that the API and other things were not loading on certain browsers (like Pale Moon) because the game was loading too early for them. Oups! Fixed.
(February 7th, 2022) Version 3.2.1:
- Fixed an oversight on my part regarding certain game shell games. They should now be loading.
(February 7th, 2022) Version 3.2:
- Games that are supposed to load inside a game shell now do so when using Flash.
- The Kongregate score API should now be loading at least in every games that still had a working API before 2021!
(February 6th, 2022) Version 3.1:
- The API is now working with all the Flash games that are not supposed to load inside a game shell, except the games on which the API broke prior to 2021 and maybe a few other games.
(February 5th, 2022) Version 3.0:
- It looks like I found how to get the score submission API to work for a few games (examples: Epic Coaster, Mission in Space: the lost colony, Road of the Dead). I do not know why it does not fix it for more games, but I am working on it.
(January 23rd, 2022) Version 2.9.1:
- Fixed the bgcolor parameter for Flash playing, after realizing that it was not supposed to be the same for every games.
(January 17th, 2022) Version 2.9:
- Simplified the code for SuperNova, which fixed some issues. Now it should always load properly (as long as the browser is itself compatible with the SuperNova player).
- When going for SuperNova, both the interface and the game will load. One less click, yay!
- Configured the default player to be SuperNova for non-Windows users and users whose browser does not accept Flash, Flash for the others.
- Added code for Ruffle, but sadly, unless the Ruffle appears magically and SPECIFICALLY somewhere on the Kongregate servers, it will be useless. Though, if it happens, I will just have to activate the code.
(January 14th, 2022) Version 2.0.1:
- Configured Flash to truly be the default player to use when the game page loads... (Oups!)
(January 14th, 2022) Version 2.0:
- Added the SuperNova player as a way to play Flash games.
- Added buttons above the game to switch player.
- Configured Flash to be the default player to use when the game page loads.
(January 10th, 2022) Version 1.0 released.
