Guides — Firestarter

Guide 1schedule15 min read

Build Your First Game Example

Clone a FireStarter template, customize the game logic, and run it locally in minutes.

Browse the FireStarter library

Visit the FireStarter repository and choose an example that matches your language and game type. Examples are organized by language, complexity, and game mechanic.

Clone and configure

Clone the repository locally. Open the config file and set your Fireball API credentials from FireStation. The example is designed to work out of the box with minimal setup.

Run locally

Follow the README to install dependencies and start the local server. The example connects to your Fireball sandbox and you can test full round-trip game logic in minutes.

Customize your game

Modify the game logic, paytable, and UI to match your concept. Keep the Fireball API calls intact — only the game-specific code needs to change.

Guide 2schedule7 min read

Submitting for Fireball Verification

Learn the review checklist and process for getting your example officially verified and listed.

Prepare your submission

Make sure your example has a clear README, working setup instructions, proper error handling, and no hardcoded credentials. Run the Fireball lint tool to catch common issues.

Open a pull request

Fork the FireStarter repository, push your example to a new branch, and open a pull request with the submission template filled in. Tag your PR with the correct language and game-type labels.

Review process

The Fireball team reviews for code quality, correctness, and best practices. Expect feedback within 5 business days. Most examples are approved after 1–2 rounds of revisions.

Go live

Once approved, your example is merged, listed in the official library, and hosting credits are applied to your FireStation account automatically.

Guide 3schedule5 min read

Earning Hosting Credits

Understand how credits are awarded for approved examples and how to redeem them across the platform.

How credits are calculated

Each approved FireStarter example earns a base credit grant. High-quality examples in rare languages or for popular game mechanics earn bonus multipliers determined by the review team.

Tracking your balance

Your hosting credit balance is visible in FireStation under Account → Credits. Credits are applied in real time after example approval and never expire.

Redeeming credits

Credits offset your infrastructure costs automatically — game hosting, API calls, and bandwidth are all covered. No manual redemption steps needed; credits are consumed first before any paid tier kicks in.

Bonus opportunities

Maintaining your examples (keeping dependencies updated, adding language versions) earns periodic maintenance credits. The more active your contributions, the more you earn.

Get up and running fast