Developer Documentation
Everything you need to publish your game on Starcade and integrate with the Bitobit platform.
Contents
1. Getting Started
To publish games on Starcade, follow these steps:
- Create a Bitobit account at bitobit.it/register
- Apply to the developer program at /developers/apply with your studio info
- Wait for approval — our team reviews applications within 48 hours
- Set up your studio — once approved, complete the onboarding at
/developer/onboarding - Create your first game from the Developer Portal at
/developer
2. Publishing Your Game
When creating a game, you'll need to provide:
- Title & description — the game's name and a compelling description
- Features — key selling points, one per line
- Platforms — Windows, Mac, Linux, Web, iOS, Android
- Price — set a price in EUR or leave at 0 for free-to-play
- Images — cover (store card), hero (banner), logo
- System requirements — minimum and recommended specs
- PEGI rating — if applicable
Your game starts as a draft. You can edit it freely until you submit for review.
3. Build Management
Builds are the downloadable files for your game. For each build, you specify:
- Platform — Windows, Mac, or Linux
- Version — semver format recommended (e.g. 1.0.0)
- File URL — a direct download link to your build archive (ZIP, RAR, etc.)
- File size — in bytes, for display purposes
- Release notes — what's new in this version
You can have multiple builds per platform (different versions). Only active builds are shown to players. Toggle builds on/off from the Builds page.
4. Review Process
After submitting your game for review, it goes through these stages:
We check for:
- Game quality and playability
- Appropriate content for the selected PEGI rating
- Working builds that download and launch correctly
- Accurate descriptions and screenshots
If rejected, you'll receive a reason and can modify your game and resubmit.
5. SDK Integration (Optional)
The Bitobit SDK is optional but recommended. It lets your game integrate with Starcade's platform features:
Submit and display player scores with global rankings
Define and unlock achievements, award XP to players
Save and load game progress across devices
Integrate with the tournament system for competitive play
Real-time notifications via polling (score beaten, achievement unlocked)
Access authenticated player info (name, XP, owned games)
Available SDKs
6. API Reference
All SDK endpoints are under /api/sdk/ and require authentication via Laravel Sanctum bearer token.
Authentication
Players authenticate via the launcher. The SDK receives a token automatically. All requests include:
Authorization: Bearer {token}
Key Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /api/sdk/profile | Player profile |
POST | /api/score/submit | Submit a score |
GET | /api/score/leaderboard/{gameId} | Get leaderboard |
POST | /api/sdk/achievements/unlock | Unlock achievement |
GET | /api/sdk/achievements/{gameId} | List achievements |
GET | /api/sdk/saves/{gameId} | List save slots |
PUT | /api/sdk/saves/{gameId}/{slotId} | Save game data |
GET | /api/sdk/events/poll | Poll real-time events |
GET | /api/sdk/tournaments/{gameId} | Active tournaments |
7. Revenue & Payouts
- Revenue is calculated automatically on each purchase
- Track your earnings in real-time from the Developer Portal dashboard
- Payout methods: PayPal or Bank Transfer — minimum threshold €50
- Configure your payout details in Studio Settings
- Earnings are tracked per game, per transaction
Sale vs Subscription opt-in
Every game is sold individually by default. Inclusion in the Starcade subscription is opt-in — your decision, made at any time after launch. Both channels can run in parallel: non-subscribers pay full price, subscribers play at no extra cost.
How earnings are split:
- Direct sale — 92% of every transaction goes to you
- Subscription — each month the total Starcade pool is divided equally per game in the catalogue (not per studio, not by playtime, not by popularity). Your per-game share is then multiplied by your 92% split. 3 games in the subscription = 3 independent shares per month.
Three common patterns:
- Sales-first — sale only for the first 4–12 weeks, then opt in. Maximises launch-window revenue (Game Pass model).
- Day-1 dual channel — sale + subscription enabled together at launch. Maximum exposure.
- Legacy revival — older title moved into subscription while keeping the sale option. Re-monetises games that have plateaued.
Note: a minimum lock-in period (3 or 6 months) may be introduced in the future to keep the per-game pool stable. Studios already in the subscription will keep their existing flexibility through any transition.
8. FAQ
No. The SDK is optional. Without it, your game is still distributed via the launcher with auto-updates, and you earn revenue from sales. The SDK adds platform features like leaderboards, achievements, and cloud saves.
You provide a direct download URL for each build. Host your files anywhere reliable: Google Drive, Dropbox, AWS S3, your own server, etc.
We aim to review all game submissions within 3-5 business days.
Yes. Add new builds anytime from the Developer Portal. New builds go live immediately without additional review (unless the game itself is re-submitted).
Yes! Set the price to 0 and your game will be available for free on Starcade.