Editor di Script

L'Editor di Script in Studio è lo strumento principale per la programmazione su Roblox. È un ambiente auto-migliorante che può aiutarti a scrivere codice ad alto impatto, ridurre il tempo di sviluppo e iterare sui tuoi giochi. Può migliorare la tua esperienza di scripting:

• Formattando e evidenziando la sintassi nel tuo codice.
• Offrendo modi per completare automaticamente frasi nel tuo codice mentre digiti.
• Aiutandoti a navigare nel codice saltando alle dichiarazioni di variabili e funzioni.
• Aiutandoti a trovare e sostituire codice negli script aperti o in tutti gli script.
• Fornendo feedback in tempo reale sulla qualità e le prestazioni del tuo codice.

L'Editor di Script supporta tutti i tipi di script e si apre automaticamente quando crei un nuovo script o fai doppio clic su uno script esistente nella finestra Explorer.

Funzionalità di completamento automatico

Le funzionalità di completamento automatico dell'Editor di Script generano informazioni relative al codice che possono migliorare la tua efficienza di programmazione, come ad esempio:

• Suggerimenti informati su come completare frasi mentre le digiti, contestuali al modello di dati del gioco. Ad esempio, se hai un Model in Workspace chiamato RocketShip, il completamento automatico suggerisce RocketShip quando digiti workspace.roc e indica che si tratta di un Model.

  

  Usa i tasti ↑ e ↓ per sfogliare i suggerimenti, quindi premi Tab o Invio per accettare un suggerimento e inserire la frase completa.

• Autocompletamento dei nomi per variabili e funzioni che dichiari, aiutandoti a evitare fastidiosi errori di battitura.

  

• Pop-up di documentazione con esempi di codice simili a quelli presenti nella Documentazione API del Motore, fornendoti contesto sull'uso dell'API.

  

• Tooltip on-hover che puoi personalizzare con la tua documentazione definita.

  

• Diagnostica di analisi degli script on-hover con informazioni che puoi utilizzare per risolvere errori.

  

• Firme di funzione quando digiti un argomento, fornendoti un riferimento per i suoi parametri e valori di ritorno.

  

Navigazione nel codice

Vai alla dichiarazione

Puoi saltare alla dichiarazione di una funzione o variabile tenendo premuto Ctrl su Windows o ⌘ su Mac mentre fai clic sulla chiamata, oppure facendo clic con il tasto destro sulla sua chiamata e selezionando Vai alla Dichiarazione.

Filtro delle funzioni dello script

Il Filtro delle Funzioni dello Script visualizza un elenco di tutte le funzioni dichiarate in uno script. Per aprirlo, premi AltF su Windows o ⌥F su Mac. Con l'elenco aperto, puoi sfogliare le firme di ciascuna funzione, filtrarle per nome e fare doppio clic su una di esse per saltare alla sua dichiarazione.

Trova e sostituisci

Il widget Trova/Sostituisci ti consente di trovare e sostituire codice in uno script aperto. Il widget supporta la corrispondenza di maiuscole, la corrispondenza della parola intera e la ricerca tramite espressioni regolari. Per aprirlo, premi CtrlF su Windows o ⌘F su Mac.

Feedback in tempo reale

Analisi degli script

La finestra Analisi degli Script, accessibile tramite il pulsante Analisi nella barra degli strumenti della scheda Script di Studio, esegue un'analisi statica sui tuoi script e visualizza errori e avvisi attivi. Per ulteriori informazioni sugli errori e sugli avvisi, consulta la documentazione sul linting di Luau.

Output

La finestra Output visualizza errori catturati dall'esecuzione degli script, messaggi dal motore Roblox, messaggi dalle chiamate a print() e errori dalle chiamate a warn().

Assistenza al codice

Assistenza al Codice è una funzionalità che suggerisce righe o funzioni di codice mentre digiti, aiutandoti a programmare in modo più efficiente e a rimanere concentrato. Basato sui contesti del tuo commento e codice, i suggerimenti verranno attivati in due modi:

• Automaticamente quando ti fermi su una riga per alcuni secondi e il modello AI ha abbastanza contesto per un suggerimento.
• Manuale con la scorciatoia Alt∖ su Windows o ⌥∖ su Mac.

Premi Tab per accettare un suggerimento, oppure ignoralo continuando a digitare. Attualmente, il tuo script deve contenere almeno alcune righe di codice per attivare un suggerimento.

Migliora i suggerimenti

Per ottenere suggerimenti più accurati e pertinenti, è consigliabile seguire pratiche di codifica pulita, indipendentemente dall'assistenza, e:

• Suddividere il tuo codice in funzioni più piccole.
• Utilizzare nomi di script descrittivi che catturino l'intento generale di ciò che fa ciascuno script. Ad esempio, chiama uno script SyncCustomSounds invece di semplicemente Sounds.
• Assegnare nomi descrittivi per parametri, funzioni e script. Ad esempio, chiama una parte GreenSphere invece di semplicemente grs, o chiama una funzione generateSphere() invece di gen(). Utilizzare funzioni nominate rispetto a funzioni anonime può anche produrre suggerimenti migliori.
• Includere costantemente commenti ben scritti commenti che descrivano il compito che stai implementando e quali dovrebbero essere gli input/output.

  • Considera di includere alcune chiamate di esempio con risultati attesi nei commenti.
  • Suggerisci come risolvere un problema, ad esempio -- Usa raycast.
  • Usa il nome esatto della funzione o della variabile che hai definito, ad esempio -- Crea 10 oggetti greenSphere invece di -- Crea 10 sfere.
• Se sei un programmatore alle prime armi, inizia con progetti di base come "fai saltare il giocatore quando tocca la parte" o utilizza lo strumento per generare piccoli frammenti di codice che puoi espandere man mano che cresce la tua conoscenza.

Limitazioni

Lo strumento aiuta ad automatizzare compiti di codifica di base, ma non suggerisce sempre codice perfetto. Le limitazioni note includono:

• L'attivazione manuale non sempre genera forzatamente un suggerimento.
• I suggerimenti sono appresi automaticamente da un corpus di codice e possono quindi riflettere alcune limitazioni del codice su cui sono stati addestrati. Ad esempio, i suggerimenti potrebbero non utilizzare le API più recenti a favore di API più vecchie, o potrebbero utilizzare Lua invece di Luau.
• Lo strumento potrebbe generare informazioni errate o fuorvianti che non sono utili per il tuo scopo.
• I filtri interni tentano di bloccare il linguaggio offensivo, ma non sono esaustivi e c'è la possibilità che lo strumento possa generare informazioni offensive o di parte.
• I suggerimenti possono essere gli stessi, simili o diversi tra gli utenti, anche con gli stessi prompt. Tuttavia, il tuo codice non sarà mai condiviso con altri.
• Il suggerimento potrebbe essere incompleto a causa della lunghezza limitata dell'output dei modelli di apprendimento.
• C'è un limite giornaliero per il numero di suggerimenti e, una volta raggiunto il limite, non riceverai suggerimenti fino al giorno successivo.

Privacy del codice

Attualmente, Roblox non utilizza dati non pubblici per addestrare i modelli di apprendimento. Lo strumento utilizza solo un piccolo sottoinsieme di asset del marketplace gratuiti per ottimizzare i modelli di linguaggio di grandi dimensioni e il sottoinsieme ha superato vari controlli di qualità e filtri di sicurezza.

Inoltre, tutti i suggerimenti sono generati dal modello AI e non vengono trasferiti da un utente all'altro. Poiché il tuo codice non viene utilizzato per l'addestramento del modello, non verrà suggerito ad altri utenti di Assistenza al Codice, con l'unica eccezione del codice pubblicato su articoli del marketplace gratuiti.

Multi-cursore

L'Editor di Script supporta l'uso di più cursori per effettuare modifiche simultaneamente. Puoi aggiungere cursori in base alle tue esigenze con un clic del mouse o una scorciatoia da tastiera. Il cursore iniziale è chiamato cursore primario e i cursori aggiuntivi sono chiamati cursori secondari.

• Le modifiche che apporti al cursore primario vengono copiate ai cursori secondari. Ogni modifica conta come un'azione, quindi annullare/rifare una modifica si applica a tutti i cursori.
• I widget come completamento automatico appaiono sul cursore primario ma non sui cursori secondari.
• Tutte le scorciatoie da tastiera standard scorciatoie da tastiera per la modifica degli script funzionano con la modifica multi-cursore, inclusa l'indentazione del codice, l'attivazione dei commenti e la cancellazione delle righe.

La seguente tabella riassume i flussi di lavoro multi-cursore e le loro scorciatoie.

Aggiungi cursori

Puoi aggiungere cursori con una combinazione di scorciatoie da tastiera e manovre del mouse. I cursori si uniscono se occupano lo stesso spazio, ad esempio se aggiungi cursori con i tasti freccia o cancelli tutti i caratteri tra i cursori.

Nella posizione del mouse

Per aggiungere un cursore nella posizione del puntatore del mouse:

1. Tieni premuto Alt su Windows o ⌥ su Mac.

2. Fai clic dove vuoi aggiungere il cursore.

Con trascinamento del mouse

Puoi trascinare il mouse per aggiungere un cursore a una selezione, dividere una selezione multilinea in righe o selezionare colonne e blocchi di codice/spazi bianchi.

Per aggiungere un cursore a una selezione di codice tramite trascinamento:

1. Tieni premuto Alt su Windows o ⌥ su Mac.

2. Fai clic e trascina il mouse sulla selezione di codice.

Sopra e sotto il cursore primario

Per aggiungere un cursore direttamente sopra o sotto il cursore primario:

1. Premi e tieni premuto CtrlAlt su Windows o ⌘⌥ su Mac.

2. Premi le frecce ↑ o ↓.

A selezioni corrispondenti

Puoi aggiungere cursori a tutte le corrispondenze di una selezione o alla corrispondenza successiva/precedente, e facoltativamente attivare se le corrispondenze devono essere sensibili alle maiuscole e/o corrispondere solo alla parola intera.

Per aggiungere un cursore a tutte le corrispondenze di una porzione selezionata:

1. Seleziona il codice per il quale desideri cercare corrispondenze.

2. Premi ShiftAltL su Windows o Shift⌥L su Mac.

Rimuovi cursori

Puoi rimuovere cursori con le seguenti scorciatoie da tastiera e manovre del mouse. In alternativa, puoi uscire dalla modifica multi-cursore premendo Esc.

Nella posizione del mouse

Per rimuovere un cursore:

1. Premi e tieni premuto Alt su Windows o ⌥ su Mac.

2. Fai clic sul cursore che desideri rimuovere.

Il più recentemente aggiunto

Per rimuovere il cursore aggiunto più di recente, premi CtrlU su Windows o ⌘U su Mac.

Copia e incolla cursori

Copiare una selezione di codice include i cursori al suo interno. Il comportamento dell'incolla dipende dal numero di cursori alla sorgente e dal numero di cursori alla destinazione:

• Se il numero di cursori è lo stesso, ogni cursore copiato viene incollato in ciascun cursore di destinazione corrispondente.
• Se il numero di cursori è diverso, ogni cursore alla destinazione riceve l'intero incolla con ciascun cursore copiato come una nuova riga.

Formattazione on-type

Premere invio/ritorno auto-indenterebbe ciascun cursore nella nuova riga rispetto alla riga precedente. Se la riga precedente inizia con un blocco incompleto, il formattatore cercherà di completarlo.

Impostazioni dell'editor

Molte opzioni di personalizzazione sono accessibili tramite la scheda Editor di Script delle Impostazioni di Studio. Le opzioni comunemente modificate includono:

Scorciatoie da tastiera

L'Editor di Script ha le seguenti scorciatoie da tastiera.