Éditeur de scripts

L'éditeur de scripts dans Studio est l'outil principal pour le scripting sur Roblox.C'est un environnement auto-améliorant qui peut vous aider à écrire du code à forte impact, réduire votre temps de développement et itérer sur vos expériences.Il peut améliorer votre expérience de scripting en :

• Formater et mettre en évidence la syntaxe dans votre code.
• Offrir des moyens de compléter automatiquement les phrases de votre code lorsque vous les taper.
• Vous aider à naviguer dans le code en sautant à des déclarations de variables et de fonctions.
• Vous aider à trouver et remplacer le code dans les scripts ouverts ou tous les scripts.
• Fournir des commentaires en temps réel sur la qualité et la performance du code.

L'éditeur de scripts prend en charge tous les types de scripts et s'ouvre automatiquement lorsque vous créez un nouveau script ou double-cliquez sur un script existant dans la fenêtre Explorateur.

Fonctions d'autocomplétion

Les fonctionnalités d'autocomplétion de l'éditeur de scripts génèrent des informations liées au code qui peuvent améliorer votre efficacité de programmation, telles que :

• Suggestions informées sur la façon de terminer des phrases lorsque vous les saisissez qui sont contextuelles au modèle de données de l'expérience .Par exemple, si vous avez un Model dans Workspace appelé RocketShip , l'autocomplétion suggère RocketShip lorsque vous saisissez workspace.roc et indique que c'est un Model .

  

  Utilisez les touches ↑ et ↓ pour parcourir les suggestions, puis appuyez sur Tab ou Enter pour accepter une suggestion et insérer la phrase complète.

• Remplissage automatique des noms pour les variables et les fonctions que vous décreter/ proclamer/ déclarer, vous aidant à éviter les typos ennuyeux.

  

• Pop-ups de documentation avec des échantillons de code semblables à ceux sur la référence de l'API du moteur, vous donnant un contexte sur l'utilisation de l'API.

  

• Des conseils contextuels lorsque vous survolez l'outil que vous pouvez personnaliser avec votre propre documentation définie.

  

• Diagnostics d'analyse de script en survol avec des informations que vous pouvez utiliser pour résoudre les erreurs.

  

• Signatures de fonction lorsque vous saisissez un argument, ce qui vous fournit une référence pour ses paramètres et ses valeurs de retour.

  

Navigation de code

Aller à la déclaration

Vous pouvez sauter à la déclaration d'une fonction ou d'une variable en maintenant Ctrl sur Windows ou ⌘ sur Mac lorsque vous cliquez sur l'appel, ou en cliquant avec le bouton droit sur son appel et en cliquant sur Aller à la déclaration .

filtresde fonction de script

Le filtre de fonction de script affiche une liste de toutes les fonctions déclarées dans un script.Pour l'ouvrir, appuyez sur AltF sur Windows ou ⌥F sur Mac.Avec la liste ouverte, vous pouvez parcourir les signatures pour chaque fonction, les filtrer par nom et cliquer deux fois sur l'une d'entre elles pour sauter à sa déclaration.

Trouver et remplacer

Le widget Rechercher/remplacer vous permet de trouver et de remplacer du code dans un script ouvert.Le widget prend en charge le cas de correspondance, correspondant à l'ensemble du mot, et la recherche par des expressions régulières.Pour l'ouvrir, appuyez sur CtrlF sur Windows ou ⌘F sur Mac.

Commentaires en temps commentaires

Analyse de script

La fenêtre analyse des scripts , accessible à partir de l'onglet affichage, effectue une analyse statique sur vos scripts et affiche les erreurs et les avertissements actifs.Pour plus d'informations sur les erreurs et les avertissements, voir la documentation Luau linting.

Sortie

La fenêtre Sortie , accessible à partir de l'onglet Affichage, affiche les erreurs capturées lors de l'exécution de scripts, les messages du moteur Roblox, les messages des appels à print() et les erreurs des appels à warn() .Pour des détails sur la configuration pour votre flux de travail, voir Sortie.

Assistance au code

Assistance au code est une fonctionnalité qui suggère des lignes ou des fonctions de code lorsque vous taper, vous aidant à coder plus efficacement et à rester concentré.Sur la base des contextes de votre commentaire et de votre code, des suggestions seront déclenchées de deux manières :

• Automatiquement lorsque vous vous arrêtez sur une ligne pendant quelques secondes et que le modèle d'IA a suffisamment de contexte pour une suggestion.
• Manuellement avec raccourci Alt∖ sur Windows ou ⌥∖ sur Mac (vous pouvez personnaliser ce raccourci).

Appuyez sur Tab pour accepter une suggestion, ou ignorez-la en continuant à taper.Actuellement, votre script doit contenir au moins quelques lignes de code pour déclencher une suggestion.

Améliorer les suggestions

Pour obtenir des suggestions plus précises et pertinentes, il est recommandé de suivre des pratiques de codage propres, indépendamment de l'aide, et :

• Divisez votre code en plus petites fonctions.
• Utilisez des noms de script descriptifs qui capturent l'intention globale de ce que chaque script fait.Par exemple, nommez un script SyncCustomSounds au lieu de simplement sons .
• Attribuez des noms descriptifs pour les paramètres, les fonctions et les scripts.Par exemple, nommez une partie GreenSphere au lieu de simplement grs , ou nommez une fonction generateSphere() au lieu de gen() .L'utilisation de fonctions nommées versus de fonctions anonymes peut également produire de meilleurs conseils.
• Incluez de manière cohérente des commentaires bien écrits qui décrivent la tâche que vous mettez en œuvre et ce que les entrées/sorties devraient être.

  • Envisagez d'inclure quelques appels d'échantillon avec des résultats attendus dans les commentaires.
  • Suggérez comment résoudre un problème, par exemple -- Use raycast .
  • Utilisez exactement la fonction ou le nom de variable que vous avez défini, par exemple -- Create 10 greenSphere objects au lieu de -- Create 10 spheres.
• Si vous êtes un scripteur novice, commencez par des projets de base tels que « faire sauter le joueur lorsqu'il touche la partie» ou utilisez l'outil pour générer de petits bouts de code que vous pouvez élargir à mesure que vos connaissances augmentent.

Limites

L'outil aide à automatiser les tâches de codage de base, mais il ne suggère pas toujours le code parfait. Les limitations connues incluent :

• L'activation manuelle ne force pas toujours à générer une suggestion.
• Les suggestions sont apprises par une machine à partir d'un corpus de code et peuvent donc refléter certaines limitations du code sur lequel elles sont formées.Par exemple, les suggestions peuvent ne pas utiliser de nouvelles API en faveur d'API plus anciennes, ou elles peuvent utiliser Lua au lieu de Luau.
• L'outil peut générer des informations incorrectes ou trompeuses qui ne sont pas utiles à votre but.
• Les filtres internes tentent de bloquer le langage offensant, mais ils ne sont pas tous inclusifs et il y a une possibilité que l'outil génère des informations offensantes ou partielles.
• Les suggestions peuvent être les mêmes, similaires ou différentes chez les utilisateurs, même avec les mêmes invites. Votre code, cependant, ne sera jamais partagé avec d'autres.
• La suggestion peut être incomplète en raison de la longueur limitée de la sortie des modèles d'apprentissage.
• Il y a un plafond quotidien pour le nombre de suggestions et, une fois ce plafond atteint, vous n'obtiendrez pas de suggestions jusqu'au lendemain.

confidentialitécode

Actuellement, Roblox n'utilise aucune donnée non publique pour entraîner les modèles d'apprentissage.L'outil utilise seulement un sous-ensemble restreint des ressources du marché libre pour peaufiner de grands modèles de langue et le sous-ensemble a passé divers tests pour les filtres de qualité et de sécurité.

De plus, toutes les suggestions sont générées par le modèle d'IA et ne se transfèrent pas d'un utilisateur à un autre.Puisque votre code n'est pas utilisé pour l'entraînement des modèles, il ne sera pas suggéré aux autres utilisateurs de Code Assist , avec l'une des exceptions du fait que le code soit publié sur des articles du marché libre.

Multi-curseur

L'éditeur de scripts prend en charge l'utilisation de plusieurs curseurs pour effectuer des modifications simultanément.Vous pouvez ajouter des curseurs en fonction de vos besoins avec un clic de souris ou un raccourci clavier.Le curseur initial est appelé le curseur principal et les curseurs supplémentaires sont appelés curseurs secondaires .

• Les modifications que vous apportez à la copie du curseur primaire aux curseurs secondaires.Chaque modification compte comme une action, donc l'annulation/restauration d'une modification s'applique à tous les curseurs.
• Les widgets tels que autocomplétion apparaissent sur le curseur principal mais pas sur les curseurs secondaires.
• Toutes les raccourcisses de clavier standard pour l'édition de scripts fonctionnent avec l'édition à curseur multiple, y compris l'indentation du code, le basculement des commentaires et l'effacement des lignes.

La table suivante résume les flux de travail multi-curseur et leurs raccourcis.

Ajouter des curseurs

Vous pouvez ajouter des curseurs avec une combinaison de raccourcis clavier et de manœuvres de souris.Les curseurs se fusionnent s'ils occupent le même espace, comme si vous ajoutez des curseurs avec des touches de flèche ou si vous supprimez tous les caractères entre les curseurs.

À l'emplacement de la souris

Pour ajouter un curseur à l'emplacement du pointeur de la souris :

1. Maintenez Alt sur Windows ou ⌥ sur Mac.

2. Cliquez où vous voulez ajouter le curseur.

Avec glisser de la souris

Vous pouvez faire glisser la souris pour ajouter un curseur à une sélection, diviser une sélection multiligne en lignes ou sélectionner des colonnes et des blocs de code/d'espace blanc.

Pour ajouter un curseur à une sélection de code en le faisant glisser :

1. Maintenez Alt sur Windows ou ⌥ sur Mac.

2. Cliquez et faites glisser votre souris sur la sélection du code.

Au-dessus et en dessous du curseur principal

Pour ajouter un curseur directement au-dessus ou en dessous du curseur principal :

1. Appuyez et maintenez CtrlAlt sur Windows ou ⌘⌥ sur Mac.

2. Appuyez sur les flèches ↑ ou ↓.

Pour correspondre aux sélections

Vous pouvez ajouter des curseurs à toutes les correspondances d'une sélection ou à la prochaine/précédente correspondre, et optionnellement activer si les correspondances sont sensibles à la casse et/ou correspondent à l'ensemble du mot.

Pour ajouter un curseur à toutes les correspondances d'une partie sélectionnée :

1. Sélectionnez le code que vous voulez rechercher pour les correspondances.

2. Appuyez sur ShiftAltL sur Windows ou Shift⌥L sur Mac.

Supprimer les curseurs

Vous pouvez supprimer les curseurs avec les raccourcis clavier et les manœuvres de souris suivantes.Alternativement, vous pouvez quitter l'édition mult curseur en appuyant sur Esc .

À l'emplacement de la souris

Pour supprimer un curseur :

1. Appuyez et maintenez Alt sur Windows ou ⌥ sur Mac.

2. Cliquez sur le curseur que vous voulez retirer.

Plus récemment ajouté

Pour supprimer le curseur le plus récemment ajouté, appuyez sur CtrlU sur Windows ou ⌘U sur Mac.

Copier et coller les curseurs

Copier une sélection de code inclut les curseurs qui s'y trouvent.Le comportement de la pâte dépend du nombre de curseurs à la source et du nombre de curseurs à la destination :

• Si le nombre de curseurs est le même, alors chaque curseur copié est collé à chaque curseur de destination correspondant.
• Si le nombre de curseurs est différent, alors chaque curseur à la destination reçoit l'ensemble de la pâte avec chaque curseur copié comme nouvelle ligne.

Formatage en temps réel

En appuyant sur entrée/retour, chaque curseur sera automatiquement indenté à la nouvelle ligne par rapport à la ligne précédente.Si la ligne précédente commence par un bloc incomplet, le formatteur va essayer de le compléter.

Paramètres de l'éditeur

De nombreuses options de personnalisation sont accessibles via Fichier ⟩ Paramètres du studio ( AltS sur Windows; ⌥S sur Mac).

Les options modifiées couramment incluent :

Raccourcis clavier

L'éditeur de scripts a les raccourcis clavier suivants.Vous pouvez également accéder à de nombreuses commandes de l'onglet script qui apparaît dans la barre d'outils Studio chaque fois que vous affichez ou modifiez un script.