As of late 2021, we are in the process of updating Stencylpedia and fixing up outdated & broken content. Thanks for your patience!







Kongregate and Newgrounds

by Jon (Updated on 2015-10-17)


  • Introduction
  • Kongregate
  • Newgrounds


Stencyl has partnered up with Kongregate and Newgrounds to bring you direct integration of each of these popular networks’ APIs -- this brings Ads, Leaderboards and Achievements to your Flash games.

Note: All of these blocks may be found under the Game > Flash section of the Palette.


Kongregate is a popular gamer-oriented Flash portal. It’s developer friendly and towards a more sophisticated hardcore audience than typical Flash portals.

Before you Start

The bulk of our support involves sending scores over to Kongregate's servers. To do this, you first need to set up high scores on Kongregate's end. This page tells you how to do this.

Setting Up

Before you use the Kongregate API, use this block to initialize it. It doesn’t matter where or when this happens. Sticking it inside the first scene is best practice.

Kong init

Submitting Scores

Unlike other services, Kongregate displays its scores as part of its site rather than in-game.

Kong scores

To submit a score, use this block. You must set up each field you wish to record on Kongregate’s site and adhere to its best practices.

Kong score block

Player Info

With these blocks, you can test whether the player’s registered, a guest and their user name, if they are registered.

Kong player blocks


The best games on Kongregate have achievements. These games are nominated by its staff. The minimum bar is a 3.5 rating (in practice, it’s now 4+) and reaching at least several hundred thousand plays.


Newgrounds is a popular site for user-generated Flash content and games. They’re also a great place to get a game sponsored.


Every Newgrounds game provides 2 secret values that you must set, so that Newgrounds’ servers can communicate with your game. Set those values under the following page, located at Settings > Web > Services.

Newgrounds setup

Showing an Ad

Ads can be shown at any point during the game, whether at the start or between levels.

Newgrounds ad block


Newgrounds supports scoreboards. In order to use them, you have to set the scoreboards up on their site before they can be tested.

Newgrounds leaderboard

Once they are, you can opt to show the scoreboard, passing in the board’s ID/name, which you defined on Newgrounds.

Newgrounds show board block

Similarly, using that same board ID/name and passing in a value, you can submit a score to Newgrounds servers.

Newgrounds submit score block


Medals are Newgrounds term for achievements. Like scoreboards, medals must be set up on Newgrounds site.


Two blocks can be used to work with medals. The move block is a one-time use block that you call at the start of the game (or anytime before a medal shows) to place the medal’s popup at an appropriate place on screen.

medals block

To unlock a medal (in other words, unlock the achievement), just use the unlock medal block.

medals unlock block


  • Third party services let you increase your game’s engagement and provide simple ways to monetize.
  • Use services responsibly to complement a game.
Print Article Edit Article How to Edit an Article
Disclaimer: Use comments to provide feedback and point out issues with the article (typo, wrong info, etc.). If you're seeking help for your game, please ask a question on the forums. Thanks!


do you make the valve or you have to find one
0 6 years, 1 month ago
Can you display the newgrounds scoreboard in a certain spot within a scene? The default pops up right over my start game button, so that when you click to go to page 2, or click to close it, the game start button receives a click.
0 9 years, 1 month ago
We've updated the article with the correct location for where you input the API keys.
1 9 years, 4 months ago
I can`t find a Newgrounds ID and Code anywhere! Could you make a screenshot?
0 9 years, 6 months ago
what's the website for newgrounds?
-1 9 years, 8 months ago
This is outdated, should be updated!
2 9 years, 9 months ago
if you don't know how to successfully create a behavior or don't know what events do, you shouldn't be reading this guide. get more experience first!
0 10 years, 1 month ago
I think that Kongreat will ask the MEDAL name, not username. if you logged on, it already know who are you.

the ID of kongreat is for greater progams, I only use it when I need fill a number camp.

0 10 years, 11 months ago
what do you do with the id of player in the kongregate coding?

0 11 years, 5 months ago
submit score to Kongregate with name: value:
what is name ?? is it statistic name / player username ?

0 11 years, 5 months ago

Sign In to Comment