Éditeur de scripts

Le É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 du code d'impact élevé, à raccourcir votre temps de développement et à itérer sur vos expériences. Il peut améliorer votre expérience de script en :

• Formater et mettre en évidence laSyntaxe dans votre code.
• Offrir des moyens d' autocompléter les phrases dans votre code au fur et à mesure que vous taper.
• Vous aider à naviguer dans le code en sautant à des déclarations de variable et de fonction.
• Vous aider à trouver et remplacer le code dans les scripts ou tous les scripts ouverts.
• Fournir des commentaires en temps réel sur la qualité et les performances de votre 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.

Autocomplétion des fonctionnalités

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

• Suggestions informées sur la façon de terminer des phrases au fur et à mesure que vous les tapez qui sont contextuelles au modèle de données de l'expérience. Par exemple, si vous avez un Class.Model dans Model appelé 0> R

  

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

• Remplir automatiquement les noms pour les variables et les fonctions que vous décreter/ proclamer/ déclarer, vous évitant de devoir répéter manuellement des types.

  

• Documents pop-ups avec des échantillons de code qui sont similaires à ceux sur la Référence de l'API moteur, vous donnant un contexte sur l'utilisation de l'API.

  

• Astuces d'outils sur la souris que vous pouvez personnaliser avec votre propre documentation définie.

  

• Analyse de script d'on-хоover avec des informations que vous pouvez utiliser pour déboguer les erreurs.

  

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

  

ナビゲーションコード

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 faisant un clic droit sur son appel et en cliquant sur Aller à la déclaration .

Filtre de fonctionnalité du script

Le filtre de fonctions script affiche une liste de toutes les fonctions déclarées dans un script. Pour l'ouvrir, appuyez sur AltF sur Windows ou 2> ⌥2> 5> F 5> sur Mac. Avec la liste ouverte, vous pouvez parcourir les signatures pour chaque fonction, filtrer par nom et double-cliquer sur l'un pour sauter dans

Trouver et remplacer

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

Commentaires en temps réel

Analyse de script

La analyse de script fenêtre, 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, consultez la Luau linting documentation.

Fenêtre de sortie

La Fenêtre d'sortie, accessible à partir de l'Affichage onglet, affiche les erreurs capturées en exécutant des scripts, des messages du moteur Roblox, des messages des appels à print() et des erreurs des appels à 2> arn()2>. Pour les détails sur la configuration pour votre flux de travail, voir 5>Fenêtre d'排出5>.

Assistant de code

Aide au code est une fonctionnalité qui suggère des lignes ou des fonctions du code que vous taper, vous aidant à code plus efficacement et à rester concentré. Selon les contextes de votre commentaire et du code, les suggestions seront déclenchées de deux manières :

• Automatiquement lorsque vous arrêtez sur une ligne pendant quelques secondes et que le modèle AI a un contexte suffisant pour une suggestion.
• Manuellement avec raccourci Alt∖ sur Windows ou ⌥ 2>∖2> sur Mac (vous pouvez 5>personnaliser 5> 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éliorations des suggestions

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

• Décomposez votre code en fonctions plus petites.
• Utilisez des noms de script descriptifs qui capturent l'intention globale de chaque script. Par exemple, nommez un script SyncCustomSounds au lieu de simplement Sounds .
• 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 1> gen1> . L'utilisation des fonctions nommées plutôt que des fonctions anonymes peut également produire de meilleures suggestions.
• Incluez cohérentement 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'échantillons avec des résultats attendus dans les commentaires.
  • Suggérez comment résoudre un problème, par exemple -- Use raycast .
  • Utilisez le nom de fonction ou de variable que vous avez défini, par exemple -- Create 10 greenSphere objects au lieu de -- Create 10 spheres.
• Si vous êtes un débutant scripteur, commencez avec des projets de base tels que « faire sauter le joueur quand ils touchent la partie » ou utilisez l'outil pour générer de petits code snippets que vous pouvez étendre à mesure que votre connaissance grandit.

Limites

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

• L'触發 manuel n'est pas force-générer toujours une suggestion.
• Les suggestions apprennent automatiquement à partir d'un corpus de code et peuvent donc refléter certaines limites du code sur lequel elles sont entraînées. Par exemple, les suggestions peuvent ne pas utiliser de nouvelles API en faveur de plus anciennes API, ou elles peuvent utiliser Lua au lieu de Luau .
• L'outil peut générer des informations inutiles ou trompeuses qui ne sont pas à votre service.
• Les filtres internes essaient de bloquer le langage offensant, mais ils ne sont pas couvrant 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 entre les utilisateurs, même avec les mêmes invitations. Votre code, cependant, ne sera jamais partagé avec d'autres.
• La suggestion peut être incomplète en raison de la durée limitée de l'Output des modèles d'apprentissage.
• Il y a une limite quotidienne pour le nombre de suggestions et, une fois la limite atteinte, vous ne recevrez pas de suggestions jusqu'au lendemain.

Confidentialité des codes

Actuellement, Roblox n'utilise aucune donnée non publique pour entraîner les modèles d'apprentissage. L'outil ne nécessite que peu de sous-ensembles de ressources du marché gratuit pour affiner les modèles de langue de grande taille 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 sont pas transférées d'un utilisateur à l'autre. Étant donné que votre code n'est pas utilisé pour l'entraînement du modèle, il ne sera pas suggéré aux autres utilisateurs de Code Assist, avec la seule exception du code qui est posté sur les articles du marché gratuit.

Multi- curseur

L'éditeur de scripts prend en charge l'utilisation de plusieurs curseurs pour faire 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 secondaires cursors .

• Les modifications que vous apportez à la copie du curseur principal au sous- curseurs. Chaque modification compte comme une action, donc annuler/refaire une modification s'applique à tous les sous- curseurs.
• Les widgets tels que autocompleté apparaissent sur le curseur principal mais pas sur les curseurs secondaires.
• Tous les raccourcis clavier standard pour l'édition de scripts fonctionnent avec l'édition mult curseur, y compris l'indentation du code, le basculement des commentaires et la suppression de lignes.

Le tableau suivant résume les workflows multi- curseurs et leurs raccourcis.

Ajouter des poignées

Vous pouvez ajouter des curseurs avec une combinaison de raccourcis clavier et de manières de souris. Les curseurs se fusionnent si ils occupent le même espace, comme si vous ajoutez des curseurs avec des touches fléchées ou supprimez tous les personnages entre les curseurs.

À la location de la souris

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

1. Maintiens Alt sur Windows ou ⌥ sur Mac.

2. Cliquez où vous voulez ajouter le curseur.

Avec le déplacement 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/espace.

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

1. Maintiens Alt sur Windows ou ⌥ sur Mac.

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

Coursur primaire ci-dessus et ci-dessous

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

À la correspondance des sélections

Vous pouvez ajouter des curseurs à tous les matchs d'une sélection ou au prochain/précédent correspondre, et optionnellement activer/désactiver si les matchs sont sensibles à la casse et/ou correspondent à tout le mot.

Pour ajouter un curseur à tous les matchs d'une partie sélectionnée :

1. Sélectionnez le code que vous souhaitez rechercher pour correspondre.

2. Pressez MajAltL sur Windows ou Shift1> ⌥1> 3> L3> sur Mac.

Suppression des curateurs

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

À la location de la souris

Pour supprimer 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 supprimer le curseur récemment ajouté, appuyez sur CtrlU sur Windows ou ⌘U sur Mac.

Copie et collage des curateurs

La copie d'une sélection de code inclut les curateurs dans le même. Le comportement de la colle dépend du nombre de curateurs à la source et du nombre de curateurs à la destination :

• Si le nombre de curseurs est le même, alors chaque curseur copié colle à chaque curseur correspondant.
• Si le nombre de curseurs est différent, alors chaque curseur à la destination reçoit la totalité de la colle avec chaque curseur copié en tant que nouvelle ligne.

Type d'affichage

En appuyant sur entrée/retour, chaque curseur sera automatiquement ajusté à la nouvelle ligne par rapport à la ligne précédente. Si la ligne précédente commence avec un bloc incomplété, le formateur tentera de le terminer.

Paramètres de l'éditeur

De nombreuses options de personnalisation sont accessibles via Fichier > Paramètres du studio ( Alt 1>S1> sur Windows ; 4>⌥4> 7>S7> 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 nombreux commandes à partir de l'onglet script qui apparaît dans la barre d'outils Studio chaque fois que vous affichez ou modifiez un script.