Getting Started
Setup your game configuration and connect to Newgrounds.
Last updated
Setup your game configuration and connect to Newgrounds.
Last updated
In this tutorial you will learn the basic steps to create a game project in newgrounds, and how to configre your plugin to start using the API immediatelly.
The first step is to create your project at the newgrounds portal, usually found here. Make sure the project time is a Game:
Once created, you can fill in all the basic information like the Title, Short Description, etc.
Now, go to the bottom of the project page to find the "Api Tools" section, and click to navigate.
Look for the App Credentials section and copy the AppID and the Encryption Key (AES-128/Base64).
Go to your game project in construct, add the NGIO plugin and paste those values in the corresponding fields.
You are all set! The plugin will automatically load the libraries and run its initialization for you. It may take a few seconds to load, depending on your internet connection speed and status. Once it's ready to operate, the condition #on-ready will trigger, and the flag will be set to true. Be sure that these events have fired before calling any plugin actions.
The API Tools provide different sections to help you properly configure everything you need for your game.
App Settings: Contains the API integration data and basic information about your game (name, description, icon, package, etc.).
App Stats: Displays the KPIs and events gathered from your game for basic analytics.
Events & Loaders: Configure custom events to track from your game and the referral pages to navigate to.
Game Protection: Register the valid domains that can run your game. Prevent unwanted game piracy and illegal monetization by restricting access.
Medals: Engage your players by motivating them to unlock in-game medals.
Score Boards: Promote competition through leaderboards in your game.
Cloud Save: Store players' game data in any of the available slots.
Unlocking medals, posting to score boards and saving games require a player logged in. Failing to login will trigger the error conditions of NGIO plugin. See Login Tutorial
