> For the complete documentation index, see [llms.txt](https://smartui-docs.pixelperfectstudio.mx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smartui-docs.pixelperfectstudio.mx/miscellaneous-addons/newgrounds.io-plugin/getting-started.md).

# Getting Started

Setup your game configuration and connect to Newgrounds.

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. 

## Preparing your Game

### Step 1. Create a New Project 

The first step is to create your project at the newgrounds portal, usually found [here](https://www.newgrounds.com/projects).  Make sure the project time is a Game:

<figure><img src="https://3242409510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9bZkqK9vYvPkvVDUO4Tp%2Fuploads%2FfD6pHFkcAdsahSNqNYxn%2Fimage.png?alt=media&amp;token=fa9f2539-8ea9-4ae9-8a23-2ff798564a72" alt="" width="329"><figcaption><p>Select <em><strong>Create a new Game Project</strong></em></p></figcaption></figure>

Once created, you can fill in all the basic information like the Title, Short Description, etc.&#x20;

### Step 2. Configure NGIO Plugin&#x20;

Now, go to the bottom of the project page to find the "Api Tools" section, and click to navigate.

<figure><img src="https://3242409510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9bZkqK9vYvPkvVDUO4Tp%2Fuploads%2FOwrVc12p7jBxQQZEu0Ve%2Fimage.png?alt=media&amp;token=f9de6ead-4504-4888-895a-ac9c747818c0" alt=""><figcaption><p>Api Tools Section at Newgrounds.com (2025)</p></figcaption></figure>

Look for the ***App Credentials*** section and copy the ***AppID*** and the ***Encryption Key (AES-128/Base64).***

<figure><img src="https://3242409510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9bZkqK9vYvPkvVDUO4Tp%2Fuploads%2FCTdf1tJe8cSDwILwLKUh%2Fimage.png?alt=media&amp;token=5676aef7-d01a-40ec-9ed9-22e4e224ba08" alt=""><figcaption><p>AppID and Encryption Key</p></figcaption></figure>

Go to your game project in construct, add the NGIO plugin and paste those values in the corresponding fields.

<figure><img src="https://3242409510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9bZkqK9vYvPkvVDUO4Tp%2Fuploads%2FWzC4hD7iPIGMmByJQH58%2Fimage.png?alt=media&amp;token=a02185d8-7322-43c1-8ffd-afce5ab4231a" alt=""><figcaption><p>NGIO Plugin Configuration</p></figcaption></figure>

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](#on-ready "mention") will trigger, and the flag will be set to true. Be sure that these events have fired before calling any plugin actions.&#x20;

The API Tools provide different sections to help you properly configure everything you need for your game.

<figure><img src="https://3242409510-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9bZkqK9vYvPkvVDUO4Tp%2Fuploads%2FuamEbABHUZdZVgZhbEB9%2Fimage.png?alt=media&amp;token=8991889a-78a3-4a66-9d8f-8d807c93433f" alt="" width="563"><figcaption><p>Newgrounds Components Section (2025)</p></figcaption></figure>

* **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.&#x20;
* **Score Boards**: Promote competition through leaderboards in your game.
* **Cloud Save**: Store players' game data in any of the available slots.

{% hint style="warning" %} <mark style="color:orange;">**Unlocking medals, posting to score boards and saving games require a player logged in.**</mark> Failing to login will trigger the error conditions of NGIO plugin. See [Login Tutorial](/miscellaneous-addons/newgrounds.io-plugin/login-tutorial.md)
{% endhint %}

***