Editor di Script

L'Editor di Script in Studio è il principale strumento di scripting su Roblox. È un ambiente in auto-miglioramento che può aiutarti a scrivere codice ad alto impatto, ridurre i tempi di sviluppo e iterare sulle tue esperienze. Può migliorare la tua esperienza di scripting tramite:

• Formattazione e evidenziazione della sintassi nel tuo codice.
• Offrendo modi per completare automaticamente frasi nel tuo codice mentre digiti.
• Aiutandoti a navigare nel codice passando a dichiarazioni di variabili e funzioni.
• Aiutandoti a trovare e sostituire codice in 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 correlate 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 dell'esperienza. Ad esempio, se hai un Model in Workspace chiamato RocketShip, il completamento automatico suggerisce RocketShip quando digiti workspace.roc e indica che è un Model.

  

  Usa i tasti ↑ e ↓ per navigare nei 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 nelle Reference API di Engine, fornendoti contesto sull'uso dell'API.

  

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

  

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

  

• Sintassi delle funzioni quando digiti un argomento, fornedoti 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 destro sulla sua chiamata e cliccando su Vai a Dichiarazione.

Filtro funzioni script

Il Filtro Funzioni Script mostra 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 navigare tra le firme di ciascuna funzione, filtrare per nome e fare doppio clic su una 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 il confronto tra maiuscole e minuscole, il confronto della parola intera e la ricerca tramite espressioni regolari. Per aprirlo, premi CtrlF su Windows o ⌘F su Mac.

Feedback in tempo reale

Analisi Script

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

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 più efficientemente e a rimanere concentrato. Basato sui contesti dai tuoi commenti e codice, i suggerimenti verranno attivati in due modi:

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

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

Migliorare i suggerimenti

Per ottenere suggerimenti più precisi e pertinenti, è consigliato 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 ogni script. Ad esempio, chiama uno script SyncCustomSounds invece di semplicemente Sounds.
• Assegna nomi descrittivi per parametri, funzioni e script. Ad esempio, chiama un oggetto 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 che descrivano il compito che stai implementando e quali dovrebbero essere gli input/output.

  • Prendi in considerazione l'inclusione di alcune chiamate di esempio con risultati attesi nei commenti.
  • Suggerisci come risolvere un problema, ad esempio -- Usa raycast.
  • Usa esattamente il nome della funzione o della variabile che hai definito, ad esempio -- Crea 10 oggetti greenSphere invece di -- Crea 10 sfere.
• Se sei uno scripter alle prime armi, inizia con progetti 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 le tue conoscenze crescono.

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 forza sempre la generazione di 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 API più recenti a favore di API più vecchie, oppure 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 tutti inclusivi e c'è la possibilità che lo strumento generi informazioni offensive o faziose.
• I suggerimenti possono essere gli stessi, simili o diversi tra gli utenti, anche con gli stessi prompt. Il tuo codice, tuttavia, non sarà mai condiviso con altri.
• Il suggerimento può 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 di mercato gratuiti per regolare 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 a un 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 per elementi di mercato gratuiti.

Multi-cursore

L'Editor di Script supporta l'uso di più cursori per apportare 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 nei 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 l'editing degli script funzionano con l'editing multi-cursore, inclusi l'indentazione del codice, l'attivazione/disattivazione dei commenti e l'eliminazione di righe.

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

Aggiungere 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 elimini tutti i caratteri tra i cursori.

Alla posizione del mouse

Per aggiungere un cursore alla posizione del puntatore del mouse:

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

2. Fai clic dove desideri aggiungere il cursore.

Con il trascinamento del mouse

Puoi trascinare il mouse per aggiungere un cursore a una selezione, dividere una selezione multi-linea in righe o selezionare colonne e blocchi di codice/spazio bianco.

Per aggiungere un cursore a una selezione di codice trascinando:

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 successiva/precedente corrispondenza, e in modo opzionale attivare il confronto tra maiuscole e minuscole e/o solo la corrispondenza della parola intera.

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

1. Seleziona il codice di cui desideri cercare corrispondenze.

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

Rimuovere cursori

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

Alla 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.

Ultimo aggiunto

Per rimuovere l'ultimo cursore aggiunto, premi CtrlU su Windows o ⌘U su Mac.

Copiare e incollare 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, allora ogni cursore copiato verrà incollato in ciascun cursore di destinazione corrispondente.
• Se il numero di cursori è diverso, allora ogni cursore alla destinazione riceverà l'intera incollatura con ogni cursore copiato come una nuova riga.

Formattazione in digitazione

Premere invio/resta auto-indentare ogni cursore alla 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.