Éditeur de script

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

• Formatant et mettant en surbrillance la syntaxe de votre code.
• Offrant des façons de compléter automatiquement des phrases dans votre code pendant que vous tapez.
• Vous aidant à naviguer dans le code en sautant aux déclarations de variables et de fonctions.
• Vous aidant à chercher et remplacer du code dans les scripts ouverts ou tous les scripts.
• Fournissant un retour d'information en temps réel sur la qualité et les performances de votre code.

L'éditeur de script supporte 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 Explorer.

Fonctionnalités d'autocomplétion

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

• Suggestions éclairées sur comment compléter des phrases pendant que vous les tapez, qui sont contextualisées par le 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 tapez workspace.roc et indique qu'il s'agit d'un Model.

  

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

• Noms de remplissage automatique pour les variables et fonctions que vous déclarez, vous aidant à éviter des erreurs de frappe ennuyeuses.

  

• Fenêtres contextuelles de documentation avec des exemples de code qui sont similaires à ceux de la Référence API de l'Engine, vous donnant un contexte sur l'utilisation de l'API.

  

• Info-bulles au survol que vous pouvez personnaliser avec votre propre documentation définie.

  

• Diagnostics d'analyse de script au survol avec des informations que vous pouvez utiliser pour déboguer des erreurs.

  

• Signatures de fonction lorsque vous tapez un argument, vous fournissant une référence pour ses paramètres et valeurs de retour.

  

Navigation dans le code

Aller à la déclaration

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

Filtre de 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 sous Windows ou ⌥F sur Mac. Avec la liste ouverte, vous pouvez parcourir les signatures de chaque fonction, les filtrer par nom et double-cliquer sur l'une d'elles pour sauter à sa déclaration.

Rechercher et remplacer

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

Retour d'information en temps réel

Analyse de script

La fenêtre Analyse de script, accessible via le bouton Analyse dans la barre d'outils de l'onglet Script de Studio, effectue une analyse statique de vos scripts et affiche les erreurs et avertissements actifs. Pour plus d'informations sur les erreurs et avertissements, consultez la documentation sur le Linting Luau.

Sortie

La fenêtre Sortie affiche les erreurs capturées lors de l'exécution des scripts, les messages du moteur Roblox, les messages des appels à print(), et les erreurs des appels à warn().

Assistance au code

L'assistance au code est une fonctionnalité qui suggère des lignes ou des fonctions de code pendant que vous tapez, vous aidant à coder plus efficacement et à rester concentré. Basé sur les contextes de vos commentaires et de votre code, les suggestions seront déclenchées de deux manières :

• Automatiquement lorsque vous faites une pause sur une ligne pendant quelques secondes et que le modèle AI a suffisamment de contexte pour une suggestion.
• Manuellement avec le raccourci Alt∖ sous Windows ou ⌥∖ sur Mac.

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, quelle que soit l'assistance, et de :

• Décomposer votre code en fonctions plus petites.
• Utiliser des noms de script descriptifs qui capturent l'intention générale de ce que chaque script fait. Par exemple, nommez un script SyncCustomSounds au lieu de simplement Sounds.
• Attribuer des noms descriptifs pour les paramètres, les fonctions et les scripts. Par exemple, nommez une pièce GreenSphere au lieu de simplement grs, ou nommez une fonction generateSphere() au lieu de gen(). Utiliser des fonctions nommées par rapport aux fonctions anonymes peut également produire de meilleures suggestions.
• Inclure systématiquement des commentaires bien écrits qui décrivent la tâche que vous implémentez et ce que les entrées/sorties devraient être.

  • Envisagez d'inclure des appels d'exemple avec des résultats attendus dans les commentaires.
  • Suggérez comment résoudre un problème, par exemple -- Utiliser le raycast.
  • Utilisez le nom exact de la fonction ou de la variable que vous avez défini, par exemple -- Créer 10 objets greenSphere au lieu de -- Créer 10 sphères.
• Si vous êtes un scripteur novice, commencez par des projets de base tels que "faire sauter le joueur lorsqu'il touche la pièce" ou utilisez l'outil pour générer de petits extraits de code sur lesquels vous pouvez étoffer vos connaissances au fil du temps.

Limitations

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

• Le déclenchement manuel ne force pas toujours la génération d'une suggestion.
• Les suggestions sont apprises par machine à partir d'un corpus de code et peuvent donc refléter certaines limitations du code sur lequel elles sont entraînées. Par exemple, les suggestions peuvent ne pas utiliser les API plus récentes au profit 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 pour vos objectifs.
• Des filtres internes tentent de bloquer le langage offensant, mais ils ne sont pas tous-en-compris et il y a une possibilité que l'outil génère des informations offensantes ou biaisées.
• Les suggestions peuvent être les mêmes, similaires ou différentes parmi 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 existe une limite quotidienne pour le nombre de suggestions et, une fois que la limite est atteinte, vous ne recevrez plus de suggestions jusqu'au lendemain.

Confidentialité du code

Actuellement, Roblox n'utilise aucune donnée non publique pour entraîner les modèles d'apprentissage. L'outil n'utilise qu'un petit sous-ensemble d'actifs du marché gratuit pour ajuster de grands modèles de langage et le sous-ensemble a passé divers contrôles de qualité et de filtres de sécurité.

De plus, toutes les suggestions sont générées par le modèle AI 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 l'assistance au code, à l'exception du code posté dans les articles du marché gratuit.

Multi-cursors

L'éditeur de script 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é curseur principal et les curseurs supplémentaires sont appelés curseurs secondaires.

• Les modifications que vous effectuez au curseur principal sont copiées sur les curseurs secondaires. Chaque modification compte comme une action, donc l'annulation/répétition d'une modification s'applique à tous les curseurs.
• Les widgets tels que l'autocomplétion apparaissent sur le curseur principal mais pas sur les curseurs secondaires.
• Tous les raccourcis clavier standards pour l'édition de scripts fonctionnent avec l'édition multi-curseurs, y compris l'indentation de code, le basculement de commentaires et la suppression de lignes.

Le tableau suivant résume les flux de travail multi-curseurs et leurs raccourcis.

Ajouter des curseurs

Vous pouvez ajouter des curseurs avec une combinaison de raccourcis clavier et de mouvements de souris. Les curseurs fusionnent s'ils occupent le même espace, par exemple si vous ajoutez des curseurs avec les touches fléchées ou supprimez tous les caractères entre les curseurs.

À l'emplacement de la souris

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

1. Maintenez Alt sous Windows ou ⌥ sur Mac.

2. Cliquez à l'endroit où vous souhaitez ajouter le curseur.

Avec le glisser de souris

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

Pour ajouter un curseur à une sélection de code par glissement :

1. Maintenez Alt sous Windows ou ⌥ sur Mac.

2. Cliquez et faites glisser votre souris sur la sélection de 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 sous Windows ou ⌘⌥ sur Mac.

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

Aux sélections correspondantes

Vous pouvez ajouter des curseurs à toutes les occurrences d'une sélection ou à la prochaine/précédente occurrence, et optionnellement basculer si les correspondances doivent respecter la casse et/ou ne correspondre qu'au mot entier.

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

1. Sélectionnez le code dont vous souhaitez rechercher les correspondances.

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

Retirer des curseurs

Vous pouvez retirer des curseurs avec les raccourcis clavier suivants et les mouvements de souris. Alternativement, vous pouvez quitter l'édition multi-curseurs en appuyant sur Esc.

À l'emplacement de la souris

Pour retirer un curseur :

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

2. Cliquez sur le curseur que vous souhaitez retirer.

Le plus récemment ajouté

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

Copier et coller des curseurs

Copier une sélection de code inclut les curseurs à l'intérieur. Le comportement du collage dépend du nombre de curseurs à la source et du nombre de curseurs à la destination :

• Si le nombre de curseurs est le même, chaque curseur copié est collé dans chaque curseur de destination correspondant.
• Si le nombre de curseurs est différent, chaque curseur à la destination reçoit le collage entier avec chaque curseur copié comme une nouvelle ligne.

Mise en forme en cours de frappe

Appuyer sur entrée/retour auto-indente chaque curseur à la nouvelle ligne par rapport à la ligne précédente. Si la ligne précédente commence par un bloc incomplet, le formateur essaiera de le compléter.

Paramètres de l'éditeur

De nombreuses options de personnalisation sont accessibles via l'onglet Éditeur de script des Paramètres de Studio. Les options souvent modifiées incluent :

Raccourcis clavier

L'éditeur de scripts a les raccourcis clavier suivants.