Documentazione di RoCode

Cos'è RoCode

RoCode (RoCode.app) è un agente IA per programmare in Roblox Studio. Descrivi una funzione in una chat web su rocode.app. Poi un plugin gratuito di RoCode dal Creator Store di Roblox esegue i passaggi dell'agente nel gioco che hai aperto: legge gli oggetti e gli script che servono a un passaggio, scrive il Luau, crea o modifica Script, LocalScript, ModuleScript e altre istanze, e controlla dentro Studio che i suoi script compilino prima di finire.

DeepSeek V4 Flash, GLM 5.3 Flash, Claude Sonnet 5.5, Claude Opus 5.5 e GPT-6 Astra sono modelli di terze parti che RoCode esegue tramite OpenRouter con le sue istruzioni e i suoi strumenti per Studio. RoCode non ha modelli propri.

RoCode (rocode.app) non è Roo Code, l'estensione di VS Code, né RoCodes.gg né rocode.org.

Requisiti

Non ti servono: un'app desktop, una riga di comando, file di configurazione, un server MCP o la tua password di Roblox. RoCode non ti chiede mai la password di Roblox.

Installare il plugin e abbinarlo alla chat

Installare e collegare, passo dopo passo

1. Crea un account gratuito. Accedi su rocode.app con un codice via email, Google, Roblox o Discord.
2. Installa il plugin. Apri il plugin di RoCode nel Creator Store e installalo. I plugin installati compaiono nella scheda Plugins di Studio. Nel gestore dei plugin di Studio, RoCode compare come RoCode AI.
3. Accetta i permessi. Quando Studio te lo chiede, consenti le richieste HTTP a relay.rocode.app e Script Injection. La tabella qui sotto spiega perché.
4. Apri un gioco in Roblox Studio: uno su cui stai lavorando o un Baseplate nuovo.
5. Apri la chat. Apri rocode.app/chat in un browser da computer. Se in Studio hai fatto l'accesso con lo stesso account Roblox con cui sei entrato su RoCode o che hai collegato a RoCode, si collega da solo (plugin 3.9.13 o successivo). Se la chat mostra Connect Studio, cliccaci.
6. Oppure usa un codice di abbinamento. Se Studio non si collega da solo, il pannello RoCode mostra un codice di 8 caratteri; se non lo vedi, clicca su Use a pairing code. Nella scheda Connect to Roblox Studio della chat, scrivi il codice e premi Connect.
7. Conferma in Studio. Dopo un codice, il pannello RoCode mostra una riga di conferma con il tuo account. Premi Connect (o Allow) lì. Aspetta fino a 2 minuti e poi mostra un codice nuovo.

I permessi di Studio che chiede il plugin

Un'impostazione di Studio è facoltativa e tocca a te: Enable Studio Access to API Services. Ti serve per testare il salvataggio con i data store in Studio, e RoCode non può cambiarla al posto tuo. In Studio apri File > Experience Settings > Security, attivala e clicca su Save. Il gioco deve essere pubblicato prima. Studio usa poi gli stessi data store del gioco live, quindi Roblox consiglia di attivarla solo su una copia di prova separata.

Come funziona l'abbinamento

Dal 27 settembre 2026 una chat aperta non collega più qualsiasi Studio della stessa rete. Studio si collega con il codice monouso di 8 caratteri, oppure solo quando hai fatto l'accesso con l'account Roblox collegato al tuo account RoCode. Più dettagli nella documentazione in inglese.

La tua prima esecuzione

La chat non invia un messaggio finché non c'è uno Studio collegato: il pulsante di invio resta disattivato e, passandoci sopra con il mouse, mostra Connect the plugin first. Quando Studio è collegato, descrivi una modifica.

Scrivi un buon primo prompt

• Una funzione alla volta. Funziona meglio di un gioco intero in un solo messaggio.
• Di' cosa deve succedere, con parole normali. Non ti servono i nomi delle classi né sapere dove vanno gli script.
• Indica cosa conta. Scrivi / nella casella dei messaggi per allegare il percorso esatto di un oggetto di Studio, come lo script che vuoi cambiare. Con il pulsante + puoi anche allegare fino a 12 file di testo (20.000 caratteri in totale) e fino a 4 immagini per messaggio, con qualsiasi modello.
• Solo una domanda? Passa il compositore su Ask e nel tuo gioco non cambia nulla.
• Oppure dettalo. Il pulsante del microfono registra il tuo prompt; la trascrizione compare nella casella dei messaggi così puoi modificarla e inviarla.

Un prompt di esempio scritto da noi. I nomi degli strumenti sono reali, ma cosa fa un'esecuzione dipende dal tuo gioco. Con il plugin 3.9 o successivo, RoCode può fare da solo un breve test; puoi sempre premere Play in Studio per provare il risultato.

Dove mette le cose RoCode

Cosa vedi mentre lavora

• Un registro passo passo. La chat mostra ogni passaggio con il nome dello strumento. Ogni lettura e ogni eliminazione compare con il suo percorso.
• Quanto ci mette. Dipende dall'attività, dalle dimensioni del tuo gioco e dal modello. Un'esecuzione può durare fino a 80 turni del modello o 5 ore. La chat mostra i crediti che usa un'esecuzione mentre lavora.
• Il tuo prossimo prompt può aspettare in coda. Mentre un'esecuzione lavora, puoi mettere in coda il prompt successivo. Puoi avere fino a 3 esecuzioni alla volta.
• Niente modifiche durante un test. Se c'è un test in corso quando tocca a una modifica, RoCode ferma prima il test, anche uno che hai avviato tu. Se Studio è ancora in Play dopo 20 secondi, non cambia nulla e ti chiede di premere Stop.

Fermare e continuare

Puoi fermare un'esecuzione quando vuoi. Se un'esecuzione si interrompe a metà, per un errore o un limite d'uso, le modifiche fatte fino a quel momento restano, e Continue riprende da dove si era fermata. Le esecuzioni che fermi contano fino al punto in cui si sono fermate. Quando un'esecuzione fallisce per un problema da parte nostra, i suoi crediti tornano automaticamente nel tuo saldo.

Le modalità Build e Ask

Ogni messaggio viene eseguito in una di due modalità. Build è la modalità predefinita e cambia il tuo gioco. Ask, aggiunta il 9 ottobre 2026, risponde a domande sul tuo gioco e non cambia nulla.

Per cambiare modalità, clicca sul selettore della modalità nella barra sotto la casella dei messaggi e scegli Ask o Build. La scelta viene ricordata in quel browser, quindi controlla il selettore prima di inviare una modifica. Anche Ask ha bisogno di uno Studio collegato, perché legge il tuo gioco. Quando Ask suggerisce una correzione, passa a Build e chiedi la modifica.

Controlli, Output e annullamento

Check Script passa uno script nel compilatore Luau dentro Studio. Un errore di compilazione torna con la sua riga e la sua colonna. Avvisa anche di schemi rischiosi, come wait(), spawn() e delay() invece di task.wait(), task.spawn() e task.delay(), loadstring, un require che non punta a un ModuleScript o un nome di GetService che non esiste. Non controlla i tipi, non fa lint e non esegue il tuo codice, quindi trova errori di compilazione e alcuni schemi rischiosi, non errori di logica. Se un controllo fallisce, RoCode non può finire finché un altro non passa; dopo due tentativi può finire e ti dice cosa continua a fallire.

Errori dai tuoi test. RoCode legge l'Output di Studio solo quando un passaggio lo richiede, di solito con Check Output. Per correggere un problema che hai trovato tu: premi Play in Studio e riproduci il problema, di' a RoCode cosa si è rotto (puoi premere Stop prima: le righe Server e Client del tuo ultimo test vengono conservate), lascia che legga l'Output e modifichi lo script, e premi di nuovo Play per confermare.

Il breve test. Con il plugin 3.9 o successivo, un'esecuzione Build può premere Play per un test fino a 30 secondi, raccogliere gli errori e gli avvisi del server e del client, e fermare il test. Lo fa al massimo due volte per esecuzione, più una per controllare la sua correzione. Con il plugin 3.9.11 o successivo, un personaggio di prova cammina, salta e calpesta parti, e con il 3.9.15 o successivo preme anche tasti, clicca pulsanti sullo schermo e scrive. Poi controlla che le cose siano successe e riporta ogni controllo come superato o fallito. Non può sapere se il gioco è divertente.

La revisione visiva. Con il plugin 3.9.14 o successivo, un'esecuzione Build che ha costruito qualcosa di visibile fa degli screenshot in Studio prima di finire, in modalità modifica, e un modello IA cerca problemi evidenti come parti che fluttuano o affondano nel terreno, buchi o una scala sbagliata, così l'agente corregge quelli reali. La chat non mostra gli screenshot e RoCode non li conserva.

Annullare. RoCode mette un punto di annullamento in Studio prima e dopo ogni gruppo di modifiche, quindi Ctrl+Z (⌘Z su Mac) torna indietro nel suo lavoro un gruppo alla volta finché Studio resta aperto. Un'esecuzione di solito è fatta di più gruppi. Il pulsante Revert della chat riavvolge solo la conversazione, non Studio.

Eliminazioni. Dal 9 ottobre 2026 RoCode elimina un oggetto solo se l'ha creato prima nella stessa chat, se il tuo messaggio chiede di toglierlo o ricostruirlo, o se te l'ha chiesto e hai detto di sì. Con il plugin 3.8.5 o successivo, un oggetto eliminato non viene distrutto: finisce in una cartella RoCodeTrash in ServerStorage, che conserva le eliminazioni delle 30 esecuzioni più recenti (fino a 25.000 oggetti). Dettagli in Deletions (in inglese).

Modelli, crediti e piani

Cos'è un credito. Un credito misura quanto costa calcolare un'esecuzione. I modelli più potenti e le esecuzioni più lunghe ne usano di più. Con le tariffe attuali, un'attività avanzata usa circa 4 crediti e un'attività standard (DeepSeek V4 Flash) circa 0,4. Con Pro fanno circa 35 attività avanzate al mese o 350 standard, con Studio circa 80 o 750 e con Ultra circa 125 o 1.200. Le attività lunghe ne usano di più. Con il modello gratuito, 1 credito basta per una o due piccole attività.

• Tutti i piani hanno i 27 strumenti. I piani a pagamento aggiungono più modelli, la tua chiave OpenRouter e nessun limite giornaliero, e le loro esecuzioni passano prima di quelle di Starter nella coda. I piani a pagamento ricevono anche 2 crediti gratis al giorno con DeepSeek V4 Flash.
• I crediti gratis non richiedono di entrare nel Discord di RoCode, e nemmeno pagare.
• I crediti di Starter si ricaricano ogni giorno alle 00:00 UTC; quelli dei piani mensili ogni mese quando viene elaborato il pagamento, e quelli dei piani annuali ogni 30 giorni. I crediti del piano non si accumulano.
• Pacchetti di crediti, in qualsiasi piano: 50 crediti per 4,99 $, 220 per 19,99 $, 580 per 49,99 $ e 1.200 per 99,99 $. Non scadono mai.
• Paddle gestisce il pagamento come venditore ufficiale (merchant of record). RoCode non conserva i dati delle carte. Se hai meno di 18 anni, chiedi al titolare della carta prima di comprare.
• Rimborso completo entro 14 giorni da qualsiasi pagamento, compresi rinnovi e pacchetti, per qualsiasi motivo, ovunque tu viva. Si chiede su paddle.net o rispondendo alla ricevuta di Paddle. Dopo un rimborso, i nuovi piani, gli upgrade e i pacchetti restano in pausa per 60 giorni.

Gli upgrade, i cambi di piano e il confronto completo sono nella pagina dei prezzi (in inglese).

Sicurezza: fin dove arriva RoCode e come annullarlo

• Solo il server di RoCode. Le richieste del plugin vanno solo a relay.rocode.app, tramite una connessione cifrata. È Studio stesso a contattare Roblox per caricare i modelli del Creator Store che piazza Insert Model e, con il plugin 3.9.13 o successivo, per controllare il nome Roblox con cui hai fatto l'accesso.
• Mai la tua password. RoCode non chiede mai la tua password di Roblox e non carica mai il file del tuo gioco.
• Una finestra di Studio. C'è solo una finestra di Studio collegata al tuo account alla volta. Quando un passaggio lo richiede, RoCode può leggere qualsiasi oggetto o script del gioco aperto in quella finestra, e quello che legge passa tramite OpenRouter fino al fornitore che ospita il modello.
• Niente pubblicazioni né spese. Il plugin non ha codice per pubblicare o salvare il tuo gioco, caricare asset o spendere Robux. Insert Model piazza solo asset che esistono già nel Creator Store, trovati con le tue parole o tramite un ID dell'asset o un link che fornisci tu, e toglie gli script contenuti in un modello.
• Modalità di sola lettura. Ask può usare solo 10 strumenti di lettura, e il server di RoCode rifiuta qualsiasi strumento che cambierebbe il tuo gioco prima che arrivi a Studio.
• La tua chiave. Se aggiungi la tua chiave OpenRouter, viene cifrata con AES-256-GCM prima di essere salvata.
• Pagamento. Il pagamento avviene nel checkout di Paddle, quindi inserisci la carta su Paddle, non in un modulo di RoCode.

Chi gestisce RoCode: un imprenditore individuale nel Regno Unito, che opera come RoCode (vedi i termini (in inglese)); email support@rocode.app. La privacy completa è nella sezione Privacy and security (in inglese).

Limiti e cosa RoCode non fa

Cosa RoCode non fa oggi

• Giudicare se il tuo gioco è divertente, né giocarlo al posto tuo al di fuori dei suoi brevi test.
• Fare screenshot mentre il tuo gioco è in esecuzione. La revisione visiva cattura solo quello che ha costruito un'esecuzione Build, in modalità modifica.
• Scolpire o dipingere il terreno a mano. Può costruire Terrain (colline, montagne, laghi, fiumi, isole e spiagge) con uno script generato; i ritocchi a mano toccano a te.
• Generare mesh, texture o animazioni da zero. Invece, Insert Model piazza modelli che esistono già nel Creator Store: quelli che trova con le tue parole, oppure un modello, un decal o una mesh tramite l'ID dell'asset o il link che fornisci.
• Pubblicare o salvare il tuo gioco, né cambiare le impostazioni della tua esperienza sul sito di Roblox.
• Costruire un gioco finito ed equilibrato partendo da una frase.
• Funzionare su un telefono.

Non ha nemmeno strumenti per game pass, developer product, caricamento di asset o attivazione delle API Services. La lista completa dei 27 strumenti, delle 12 strutture pronte e dei 7 layout di interfaccia è in The 27 tools (in inglese), e tutti i limiti in Limits (in inglese).

Risoluzione dei problemi

La maggior parte dei problemi di configurazione è uno di questi casi. Se il tuo non lo è, chiedi nel Discord di RoCode, che è dove si dà supporto. Tutti i casi sono in Troubleshooting (in inglese).

Domande frequenti

Fonti e letture

• Documentazione completa di RoCode (in inglese). i 27 strumenti, la privacy e tutti i limiti
• Plugin di RoCode nel Creator Store di Roblox. il plugin descritto in questa pagina
• Prezzi (in inglese). tutti i piani, i pacchetti di crediti e i rimborsi
• Termini d'uso (in inglese)
• Roblox Creator Docs: Data stores (in inglese). attivare l'accesso di Studio alle API Services