Kongregate Flash games fixer

Matrix4348
2022-01-10T16:15:38Z

You can now chose between Flash, SuperNova, Ruffle and AwayFL to play Flash games on Kongregate!

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 (games written in Actionscript 3 will even submit high scores normally and if you use the Kong Flash API patcher user script from Colin969 on top of mine, then games written in Actionscript 1 or 2 will also do!)

AwayFL

To switch player (or simply reload the game), click on the appropriate button, right below the game.

You can change the default SWF player used on page load by clicking the "Set default SWF player" button, below the game.
Another button is there to let you change the preferred renderer used by Ruffle, should you need to (which you may if the default one leaves you with a black screen).

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

On Flash games, the "play now" button will be pressed automatically.

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 of 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 (no longer needed for Actionscript 3 games but it still is for older games).

AwayFL is still in development.

There are games, such as Kongai, that are only playable with Flash right now.

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

(April 4th, 2026) Version 12.0:

Added a button to let users set their preferred Ruffle renderer, as apparently the default one can lead to a black screen while others do not (see https://greasyfork.org/en/scripts/438325-kongregate-flash-games-fixer/discussions/321597#comment-641896).

The name of the selected SWF player is now bolded.

Minor tweaks.

(March 2nd, 2026) Version 11.7:

Improved how parameters for game iframe creation were located (and/or corrected, when needed). In particular, new ones and the ones potentially being unknown to me should no longer be missed. This will have probably no (noticeable) effect at the moment, but might prevent both minor and breaking bugs in the future.

(February 18th, 2026) Version 11.6:

Changed how the script created the game iframe URL (before, it was rebuilding it from scratch; now, it locates the original one and modify it accordingly). This fixes an issue where developers were unable to load the iframe in preview mode (that was a pretty embarrassing oversight... sorry, Flash game developers!)

(February 18th, 2026) Version 11.5:

Added a missing(?) kongregate_preview Flashvar, in hope to fix what prevents game developers from seeing their preview SWF in preview mode.

(February 14th, 2026) Version 11.4:

Fixed Kongregate Actionscript 3 API by defining two missing Javascript functions (to make it compatible with Ruffle, some code had to be moved from within the SWF to functions on the web page, and the SWF was supposed to call said functions instead; however, they were missing). Those games now, once again, properly submit high scores without the Kong Flash API Patcher (as they had started to do at the beginning of December...)

(February 13th, 2026) Versions 11.2 and 11.3:

Fixed syntax errors.

Made various Flash variables update one iframe earlier than before.

Minor changes

(February 12th, 2026) Version 11.1:

(Re)added Flashvars that were missing, either after disappearing recently or never being there at all.

One of them re-enables (after it stopped working in December, due to a Kongregate update) statistics submission on AVM2 games when using Ruffle, provided that the Kong Flash API Patcher is being used in parallel.

(February 5th, 2026) Version 11.0:

Added three "play" buttons to the SuperNova interface, below the original one: one to launch the game via the http protocole, one to launch it via the https protocole and one to load the game inside the Kongregate game shell (for Actionscript 1 and 2 games only). The goal is to provide directly to players a way to circumvent some loading issues that they may encounter.

(December 18th, 2025) Version 10.4:

Improved the previous fix because it did not work in all browsers.

(December 17th, 2025) Version 10.3:

Fixed a breaking bug caused by small recent changes from Kongregate...

...alongside an unnoticed old copy/paste error in the code.

Did a very small bit of code cleaning.

(December 16th, 2025) Version 10.2:

Added a flashvar that went missing after recent Kongregate changes but I do not know if it was even needed.

Minor tweaks.

Note: Kongregate updated their AS3 API to be compatible with Ruffle so AVM2 games no longer need another user script to fix that. However, they still require a user script to pass the correct (not encoded) API URL to Ruffle. AVM1 games still need both scripts.

(December 15th, 2025) Version 10.1:

Fixed buttons not working in some browsers.

Tweaked a few image links.

(December 15th, 2025) Version 10.0:

Added a button to set which SWF player users want as the default one. As a bonus, make Flash games load automatically (saving people the need to click the "play now" button).

Added three permissions to the user script: GM_setValue and GM_getValue (for the feature described above) and unsafeWindow (because user scripts behave differently with permissions than with @grant none).

Cleaned code related to previous versions of Kongregate that is no longer relevant and was only being kept for compatibility ("just in case") reasons.

Removed fixes to Kongai's match chat, as recent Kongregate changes... destroyed it.

Minor other tweaks.

(December 6th, 2025) Version 9.1:

Fixed buttons not working due to a recent Kongregate update.

Minor correction to the Ruffle configuration.

(October 21st, 2025) Version 9.0:

Adapted the script to the new Kongregate layout, which added another layer of iframe to deal with...

Added missing localized pages to the list of pages the script is supposed to run on.

(December 2nd, 2024) Version 8.4.2:

Increased Ruffle's maxExecutionDuration configuration option from fifteen to one hundred seconds in order to fix loading for some games on slower computers (like mine...).

(October 12th, 2024) Version 8.4.1:

Improved handling of timeouts when fetching external scripts.

(October 11th, 2024) Version 8.4:

Replaced the URL of supernovalauncher.js, as timeouts on web.archive.org are not being handled as I thought and, instead, prevent the script from working.

(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:

Modified how AVM1 games were loaded in Ruffle, in order to make them compatible with high scores submission, thanks to the latest Ruffle update. If you want high scores to be submitted when using Ruffle, combine my user script with the following one: https://greasyfork.org/en/scripts/494088-kong-flash-api-patcher

(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:

Minor code changes.

(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:

Disabled the automatic game opening for the unofficial SuperNova interface because it prevented this interface from loading when people did not already have SuperNova installed.

Changed the download link for the unofficial SuperNova interface to http://web.archive.org/web/20210426173012/https://cdn.getsupernova.com/update/SuperNovaSetup0.1.23.exe so that the software could be downloaded even when getsupernova.com is done.

Reduced the activation of the unofficial SuperNova interface.

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