É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 sur vos jeux. Il peut améliorer votre expérience de scripting en :

• Formatant et mettant en surbrillance la syntaxe de votre code.
• Offrant des moyens d'autocompléter des phrases dans votre code au fur et à mesure 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 la performance de votre code.

L'Éditeur de script 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.

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é de programmation, telles que :

• Suggestions éclairées sur la façon de compléter des phrases au fur et à mesure que vous les tapez, qui sont contextuelles au modèle de données du jeu. 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.

• Remplissage automatique des noms pour les variables et les fonctions que vous déclarez, vous aidant à éviter les fautes de frappe ennuyeuses.

  

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

  

• Infobulles 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 résoudre 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 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.

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

Chercher et remplacer

Le widget Chercher/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 sur 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

Assistance au code est une fonctionnalité qui suggère des lignes ou des fonctions de code au fur et à mesure que vous tapez, vous aidant à coder plus efficacement et à rester concentré. Basé sur les contextes de votre commentaire 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∖ sur 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, indépendamment de 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 fait chaque script. 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 à des 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 quelques 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 que vous pouvez développer à mesure que vos connaissances grandissent.

Limitations

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

• 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 formées. Par exemple, les suggestions peuvent ne pas utiliser les nouvelles API au profit des anciennes API, 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 votre objectif.
• Des filtres internes tentent de bloquer le langage offensant, mais ils ne sont pas exhaustifs et il est possible 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 y a un plafond quotidien pour le nombre de suggestions et, une fois le plafond atteint, vous ne recevrez plus de suggestions jusqu'au lendemain.

Confidentialité du code

Actuellement, Roblox n'utilise aucune donnée non publique pour former les modèles d'apprentissage. L'outil n'utilise qu'un petit sous-ensemble d'actifs de marché gratuits 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 du modèle, il ne sera pas suggéré à d'autres utilisateurs de L'Assistance au code, à l'exception du code étant posté dans des éléments de marché gratuits.

Multi-curseur

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é le curseur principal et les curseurs supplémentaires sont appelés curseurs secondaires.

• Les modifications que vous effectuez au curseur principal se copient sur les curseurs secondaires. Chaque modification compte comme une action, donc l'annulation/rétablissement 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 standard pour l'édition de script fonctionnent avec l'édition multi-curseur, y compris l'indentation de code, le basculement des 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 manœuvres 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 si vous 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 sur Windows ou ⌥ sur Mac.

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

Avec le glissement de la souris

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

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

1. Maintenez Alt sur 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 sur Windows ou ⌘⌥ sur Mac.

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

À des sélections correspondantes

Vous pouvez ajouter des curseurs à toutes les correspondances d'une sélection ou à la prochaine/précédente correspondance, et optionnellement basculer si les correspondances sont sensibles à la casse et/ou correspondent au mot entier.

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

1. Sélectionnez le code pour lequel vous souhaitez rechercher des correspondances.

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

Retirer des curseurs

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

À l'emplacement de la souris

Pour retirer un curseur :

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

2. Cliquez sur le curseur que vous souhaitez retirer.

Le plus récemment ajouté

Pour retirer le curseur ajouté le plus récemment, appuyez sur CtrlU sur 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, alors chaque curseur copié se colle à chaque curseur de destination correspondant.
• Si le nombre de curseurs est différent, alors chaque curseur à la destination reçoit l'intégralité du collage avec chaque curseur copié comme une nouvelle ligne.

Formatage en cours de frappe

Appuyer sur entrée/retour va auto-indenter 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 couramment modifiées incluent :

Raccourcis clavier

L'Éditeur de script a les raccourcis clavier suivants.