Documentazione Sviluppatori

Per pubblicare giochi su Starcade, segui questi passi:

1. Crea un account Bitobit su bitobit.it/register
2. Candidati al programma sviluppatori su /developers/apply con le informazioni del tuo studio
3. Attendi l'approvazione — il nostro team esamina le candidature entro 48 ore
4. Configura il tuo studio — una volta approvato, completa l'onboarding su /developer/onboarding
5. Crea il tuo primo gioco dal Portale Sviluppatori su /developer

Quando crei un gioco, dovrai fornire:

• Titolo e descrizione — il nome del gioco e una descrizione accattivante
• Caratteristiche — punti di forza principali, uno per riga
• Piattaforme — Windows, Mac, Linux, Web, iOS, Android
• Prezzo — imposta un prezzo in EUR o lascia a 0 per free-to-play
• Immagini — cover (scheda store), hero (banner), logo
• Requisiti di sistema — specifiche minime e consigliate
• Classificazione PEGI — se applicabile

Il tuo gioco parte come bozza. Puoi modificarlo liberamente finché non lo invii per la revisione.

Le build sono i file scaricabili del tuo gioco. Per ogni build, specifichi:

• Piattaforma — Windows, Mac o Linux
• Versione — formato semver consigliato (es. 1.0.0)
• URL del file — un link di download diretto al tuo archivio build (ZIP, RAR, ecc.)
• Dimensione file — in byte, a scopo di visualizzazione
• Note di rilascio — cosa c'è di nuovo in questa versione

Puoi avere più build per piattaforma (versioni diverse). Solo le build attive sono mostrate ai giocatori. Attiva/disattiva le build dalla pagina Build.

Dopo aver inviato il tuo gioco per la revisione, attraversa queste fasi:

Verifichiamo:

• Qualità e giocabilità del gioco
• Contenuto appropriato per la classificazione PEGI selezionata
• Build funzionanti che si scaricano e avviano correttamente
• Descrizioni e screenshot accurati

Se rifiutato, riceverai una motivazione e potrai modificare il tuo gioco e reinviarlo.

L'SDK Bitobit è opzionale ma consigliato. Permette al tuo gioco di integrarsi con le funzionalità della piattaforma Starcade:

SDK Disponibili

Tutti gli endpoint SDK sono sotto /api/sdk/ e richiedono autenticazione tramite token bearer Laravel Sanctum.

Autenticazione

I giocatori si autenticano tramite il launcher. L'SDK riceve un token automaticamente. Tutte le richieste includono:

Authorization: Bearer {token}

Endpoint Principali

• I ricavi vengono calcolati automaticamente su ogni acquisto
• Monitora i tuoi guadagni in tempo reale dalla dashboard del Portale Sviluppatori
• Metodi di pagamento: PayPal o Bonifico Bancario — soglia minima €50
• Configura i tuoi dati di pagamento nelle Impostazioni Studio
• I guadagni sono tracciati per gioco, per transazione

Opt-in Vendita vs Abbonamento

Ogni gioco viene venduto individualmente per impostazione predefinita. L'inclusione nell'abbonamento Starcade è opzionale — una tua decisione, presa in qualsiasi momento dopo il lancio. Entrambi i canali possono funzionare in parallelo: chi non è abbonato paga il prezzo pieno, gli abbonati giocano senza costi aggiuntivi.

Come vengono divisi i guadagni:

• Vendita diretta — il 92% di ogni transazione va a te
• Abbonamento — ogni mese il pool totale Starcade viene diviso in parti uguali per gioco nel catalogo (non per studio, non per tempo di gioco, non per popolarità). La tua quota per gioco viene poi moltiplicata per il tuo split del 92%. 3 giochi in abbonamento = 3 quote indipendenti al mese.

Tre pattern comuni:

• Vendita prima — solo vendita per le prime 4–12 settimane, poi opt-in. Massimizza i ricavi della finestra di lancio (modello Game Pass).
• Doppio canale dal Day-1 — vendita + abbonamento attivi insieme al lancio. Massima esposizione.
• Rilancio legacy — titolo più vecchio spostato in abbonamento mantenendo l'opzione vendita. Rimonetizza giochi che si sono stabilizzati.

Nota: in futuro potrebbe essere introdotto un periodo minimo di permanenza (3 o 6 mesi) per mantenere stabile il pool per gioco. Gli studi già in abbonamento manterranno la loro flessibilità attuale durante qualsiasi transizione.