Editore script

L'Editore script in Studio è lo strumento principale per lo script su Roblox. È un ambiente sempre in miglioramento e che può aiutarti nella scrittura di codice ad alto impatto, abbreviare i tempi di sviluppo e iterare le tue esperienze. Può migliorare la tua esperienza di script:

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

L'Editore script supporta tutti i tipi di script e si apre automaticamente quando se ne crea uno nuovo o si fa doppio clic su uno script esistente nella finestra Explorer.

Completamento automatico

L'Editore script genera informazioni relative al codice in grado di migliorare l'efficienza della programmazione.

• Offre suggerimenti su come completare le frasi mentre le digiti. Utilizza i tasti freccia su e giù per sfogliare i suggerimenti, quindi premi Tab o Invio per accettare un suggerimento e inserire la frase completa.

  

• L'autocompleta è legata all'esperienza modello di dati. Se si dispone di un Partsu Workspacedenominato CoolRocketShip, il completamento automatico suggerisce CoolRocketShipquando workspace.cooldigiti e indica che è un Part.

  

• Il completamento automatico offre anche nomi per le variabili e le funzioni che si dichiarano, rendendo più facile evitare errori di battitura e riutilizzare il codice.

  

• Il pop-up di completamento automatico fornisce una documentazione oltre a esempi di codice simili a quelli sull'API di riferimento del motore, fornendo un contesto sull'utilizzo di un'API.

  

• Quando digiti un argomento in una funzione, il pop-up di completamento automatico mostra anche la firma della funzione, fornendo un riferimento per i suoi parametri e i valori di ritorno.

  

Navigazione del codice

Vai alla dichiarazione

Puoi passare alla dichiarazione di una funzione o di una variabile facendo clic con il pulsante destro sulla chiamata e facendo clic su Vai a Dichiarazione. Puoi anche passare a una dichiarazione tenendo premuto Ctrl su Windows o ⌘ su macOS quando fai clic sulla chiamata.

Filtro della funzione di script

Il Filtro della funzione di script visualizza un elenco di funzioni definite in uno script. Per aprirlo, fare clic con il tasto destro del mouse su un punto qualsiasi dell'editore quindi fai clic su Filtro della funzione di script. Una volta aperto l'elenco, puoi sfogliare le definizioni per ogni funzione, filtrarle in base al nome e fare doppio clic su una di esse per accedere alla propria definizione.

Trova e sostituisci

Il Widget Trova e Sostituisci ti permette di trovare e sostituire il codice in uno script aperto. Il Widget è in grado di gestire la corrispondenza tra maiuscole e minuscole, la corrispondenza con l'intera parola e le espressioni regolari. Per aprire il WidgetTrova e Sostituisci, premi Ctrl + F su Windows o ⌘ + F su macOS.

Feedback in tempo reale

Analisi dello script

La finestra **Analisi Script **, accessibile dalla schedaVisualizza, esegue l'analisi statica sui tuoi script e visualizza gli errori e le segnalazioni attive. Per maggiori informazioni relative agli errori e alle segnalazioni, fai riferimento alla documentazione Luau Lang.

Output

La finestra Output, accessibile dalla scheda Visualizza, visualizza gli errori rilevati da script in esecuzione, i messaggi dal motore Roblox, i messaggi dalle chiamate aprint(), e gli errori delle chiamate a warn(). Per informazioni su come configurarlo per il tuo flusso di lavoro, consulta Output.

Codice Assistente

Il Codice Assistente è un'assistente dell'IA che suggerisce linee o funzioni di codice durante la digitazione, aiutandoti a codificare in modo più efficiente e a rimanere concentrato. In base al contenuto del tuo commento e del codice, i suggerimenti verranno attivati in due modi:

• automaticamente quando ti soffermi su una riga per qualche secondo e il modello di IA ha un contenuto sufficiente per un suggerimento;
• manualmente con la scorciatoia Alt + ∖ su Windows o ⌥ + ∖ su MacOS (puoi personalizzare questa scorciatoia).

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

Miglioramento dei suggerimenti

Per ottenere suggerimenti più accurati e pertinenti, ti consigliamo di seguire pratiche di codifica chiare, indipendentemente dall'assistenza dell'IA e di

• suddividere il codice in funzioni più piccole;
• Utilizza nomi di script descrittivi, che colgano l'intento generale di ciò che ogni script esegue. Ad esempio, nomina uno SyncCustomSounds al posto del semplice Suono.
• Assegna nomi descrittivi a parametri, funzioni e script. Ad esempio, nomina una parte GreenSphere al posto del semplice grs, o nomina una funzionegenerateSphere() al posto di gen(). L'utilizzo di funzioni denominate rispetto a quelle anonime può anche produrre suggerimenti migliori.
• Inserisci sistematicamente commenti ben scritti che descrivano l'attività che stai implementando e quali dovrebbero essere gli input e gli output.

  • Valuta l'opportunità di includere nei commenti alcune richieste di esempio con i risultati attesi.
  • Suggerisci come risolvere un problema, ad esempio-- Use raycast.
  • Utilizza il nome esatto della funzione o della variabile che hai definito, ad esempio -- Create 10 greenSphere objectsal posto di -- Create 10 spheres.
• Se sei uno scripter alle prime armi, inizia con progetti di base come "fai saltare il giocatore quando tocca la parte" o utilizza lo strumento per generare frammenti di codice che puoi ampliare man mano che la tue conoscenze aumentano.

Limitazioni

Lo strumento aiuta ad automatizzare le attività di programmazione di base, ma non sempre suggerisce un codice perfetto. Le limitazioni note includono:

• l'attivazione manuale non sempre forzatamente un suggerimento.
• I suggerimenti vengono acquisiti automaticamente da un corpus di codice e possono quindi riflettere alcune limitazioni del codice su cui sono stati addestrati. Ad esempio, i suggerimenti possono non utilizzare le API più recenti rispetto a quelle precedenti, oppure possono utilizzare Lua al posto di Luau.
• Lo strumento può generare informazioni errate o fuorvianti che non sono utili per il proprio scopo.
• I filtri interni tentano di bloccare il linguaggio offensivo, ma non sono onnicomprensivi e c'è la possibilità che lo strumento generi informazioni offensive o parziali.
• I suggerimenti possono essere uguali, simili o diversi tra gli utenti, anche a fronte delle stesse richieste. Il tuo codice, tuttavia, 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 più suggerimenti fino al giorno successivo.

Codice Privacy

Attualmente, Roblox non utilizza dati non pubblici per addestrare i modelli di apprendimento. Lo strumento utilizza solo un piccolo sottoinsieme di risorse gratuite di mercato per la messa a punto di modelli linguistici di grandi dimensioni e il sottoinsieme ha superato vari controlli di qualità e filtri di sicurezza.

Inoltre, tutti i suggerimenti vengono generati dal modello di IA e non vengono trasferiti da un utente all'altro. Dal momento in cui il codice non viene utilizzato per l'addestramento del modello, questo non verrà suggerito agli altri utenti del Codice Assistente, con l'unica eccezione del codice inviato agli articoli del mercato gratuito.

Multi-cursore

L'Editore script supporta l'utilizzo i 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, mentre i cursori aggiuntivi sono chiamati cursori secondari.

• Le modifiche apportate al cursore primario vengono copiate sui cursori secondari. Nella modifica a più cursori, ogni modifica conta come una sola modifica anche se hai più cursori. Se annulli o rifai un'modifica mentre utilizzi l'editing a più cursori, l'annullamento o il ripristino si applica a tutti i cursori.
• Widget come autocompletamento appaiono sul cursore principale, ma non sui cursori.
• Le scorciatoie da tastiera standard per la modifica nell'Editore script, script, come l'indentazione del codice, la selezione dei commenti e l'eliminazione delle righe, funzionano tutte con la modifica a più cursori.

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

Aggiunta di cursori

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

Posizione del mouse

Per aggiungere un cursore al mouse:

1. tieni premuto Alt su Windows o ⌥ su macOS;
2. Fai clic nell'Editore script nel punto in cui desideri aggiungere il cursore;

con il trascinamento del mouse

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

Trascina la selezione

per aggiungere un cursore a una selezione di testo:

1. tieni premuto Alt su Windows o ⌥ su macOS;
2. Fai clic e trascina il mouse sulla selezione del testo.

Alle estremità delle righe selezionate alla fine della selezione

Per aggiungere cursori alla fine di ogni riga in una selezione multilinea e alla fine della selezione:

Column/Block Select

Per selezionare colonne e blocchi di codice o spazi bianchi, trascinare il mouse tenendo premuto MaiuscAlt su Windows o Maiusc⌥ su macOS. Tutte le righe con un cursore vengono evidenziate.

Sopra o sotto rispetto al cursore primario

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

1. tieni premuto Ctrl + Alt su Windows o ⌘ + ⌥ su macOS.
2. premi le frecce su e giù.

A tutte le selezioni corrispondenti

È possibile aggiungere i cursori a tutte le corrispondenze di una selezione o alla partita successiva/precedente, e opzionalmente attiva/disattiva se le corrispondenze sono maiuscole/minuscole e/o corrispondono a tutta la parola.

Espandi tutte le cartelle

Per aggiungere un cursore alla selezione corrispondente:

1. seleziona il codice per il quale desideri cercare le corrispondenze.
2. Premi Shift + Alt + L su Windows o Shift + ⌥ + L su macOS.

Alla precedente selezione di corrispondenza

per aggiungere un cursore alla successiva selezione corrispondente:

1. seleziona il codice per il quale desideri cercare le corrispondenze.
2. Premi Ctrl + D su Windows o ⌘ + D su macOS.
3. Continua a premere Ctrl/⌘ + D finché non avrai selezionato tutte le corrispondenze successive desiderate.

Non c'è nessuna scorciatoia predefinita per aggiungere un cursore alla selezione precedente corrispondente, ma puoi aggiungere la tua:

1. Puoi anche creare una scorciatoia a scelta aprendo la finestra Personalizza Scorciatoie in File > Avanzate > Personalizza Scorciatoie e modificando la scorciatoia per "Seleziona occorrenza precedente".

2. Nella finestra delle scorciatoie, individuare Seleziona l'occorrenza precedente.

   

3. seleziona il codice per il quale desideri cercare le corrispondenze.

   

4. Conferma la tua impostazione facendo clic su OK nell'angolo in basso a destra della finestra.

Corrispondenza maiuscola o parola intera

Per ciascuno dei flussi di lavoro correlati alle corrispondenze di cui sopra, puoi abbinare il caso **** e/o **intera parola** come segue:

1. Apri la finestra di Apertura rapida con Ctrl + P su Windows o ⌘ + P su macOS.

2. Usare i pulsanti di commutazione per scegliere se una selezione abbinata deve essere sensibile alle maiuscole e / o corrispondere solo all'intera parola.

   

Rimozione dei cursori

Puoi rimuovere cursori con una combinazione di scorciatoie da tastiera e movimenti del mouse. Per rimuovere tutti i cursori secondari e uscire dalla modifica con più cursori, premi Esc o fai clic in un punto qualsiasi dell'Editore script.

Posizione del mouse

Per rimuovere un cursore:

1. tieni premuto Alt su Windows o ⌥ su macOS;
2. fai clic sul cursore che desideri rimuovere.

Aggiunti di recente

Per rimuovere l'ultimo cursore aggiunto, premi Ctrl + U su Windows o ⌥ + U su macOS.

Copiare e incollare i cursori

La copia di una selezione di testo prevede l'inclusione dei cursori al suo interno. A seconda del numero di cursori all'origine e del numero di cursori alla destinazione, il comportamento dell'incolla dipende dal numero di cursori:

• se il numero di cursori è uguale, ogni cursore copiato viene incollato su ogni cursore di destinazione corrispondente;
• se il numero di cursori è diverso, ogni cursore nel punto di destinazione riceverà l'intero incollamento con ogni cursore copiato come una nuova riga.

Taglia

Premendo invio/ritorno, ogni cursore rientrerà automaticamente nella nuova riga relativa a la riga precedente. Se la riga precedente inizia con un blocco incompleto, il formattatore proverà a completarlo.

Scorciatoie da tastiera

L'Editore script dispone delle seguenti scorciatoie da tastiera. Puoi anche accedere a molti comandi facendo clic con il tasto destro del mouse in qualsiasi punto dell'editor.