Editor de guiones

El editor de scripts en Studio es la herramienta principal para programar en Roblox.Es un entorno de mejora continua que puede ayudarlo a escribir código de alto impacto, acortar su tiempo de desarrollo e iterar sobre sus experiencias.Puede mejorar su experiencia de programación al:

• Formatear y resaltar la sintaxis en tu código.
• Ofreciendo maneras de autocompletar frases en tu código mientras introducir.
• Ayudándote a navegar por el código al saltar a declaraciones de variables y funciones.
• Ayudándote a encontrar y reemplazar código en scripts abiertos o todos los scripts.
• Proporcionar comentarios en tiempo real sobre la calidad y el ejecuciónde tu código.

El editor de scripts admite todos los tipos de scripts y se abre automáticamente cuando creas un nuevo script o haces doble clic en un script existente en la ventana Explorador.

Características de autocompletado

Las funciones de autocompletado del editor de scripts generan información relacionada con el código que puede mejorar su eficiencia de programación, como:

• Sugerencias informadas sobre cómo completar frases mientras las escribes que son contextuales al modelo de datos de la experiencia .Por ejemplo, si tienes un Model en Workspace llamado RocketShip , la autocompletación sugiere RocketShip cuando escribes workspace.roc y indica que es un Model .

  

  Usa las teclas ↑ y ↓ para navegar por las sugerencias, luego presiona Tab o Enter para aceptar una sugerencia e insertar la frase completa.

• Autocompletar nombres para variables y funciones que declarar, ayudándote a evitar errores molestos.

  

• Pop-ups de documentación con muestras de código similares a las de la Referencia de la API del motor, que te dan contexto sobre el uso de la API.

  

• Información sobre herramientas en el momento del desplazamiento que puedes personalizar con tu propia documentación definida.

  

• Diagnóstico de análisis de scripts en tiempo de ejecución con información que puedes usar para solucionar errores.

  

• Firmas de función cuando escribes un argumento, proporcionándote una referencia para sus parámetros y valores de devolución.

  

Navegación de código

Ir a la declaración

Puedes saltar a la declaración de una función o variable manteniendo presionado Ctrl en Windows o ⌘ en Mac al hacer clic en la llamada, o haciendo clic con el botón derecho en su llamada y haciendo clic en Ir a la declaración .

Filtro filtrofunción de script

El Filtro de función de script muestra una lista de todas las funciones declaradas en un script.Para abrirla, presione AltF en Windows o ⌥F en Mac.Con la lista abierta, puedes navegar por las firmas de cada función, filtrarlas por nombre y hacer doble clic en una para saltar a su declaración.

Encontrar y reemplazar

El widget Buscar/Reemplazar te permite encontrar y reemplazar código en un script abierto.El widget admite el caso de coincidencia, coincidiendo con toda la palabra y buscando por expresiones regulares.Para abrirla, presione CtrlF en Windows o ⌘F en Mac.

Comentarios en tiempo opinión

Análisis de scripts

La ventana de análisis de scripts , accesible desde la pestaña de vista, realiza un análisis estático de tus scripts y muestra errores activos y advertencias.Para obtener más información sobre los errores y advertencias, consulte la documentación de Luau linting.

Salida

La ventana Salida , accesible desde la pestaña Ver, muestra errores capturados al ejecutar scripts, mensajes del Motor de Roblox, mensajes de llamadas a print() y errores de llamadas a warn() .Para obtener detalles sobre cómo configurarlo para su flujo de trabajo, consulte Salida.

Asistencia de código

Asistencia de código es una característica que sugiere líneas o funciones de código mientras introducir, ayudándote a codificar de manera más eficiente y mantenerte enfocado.Basado en los contextos de tu comentario y código, las sugerencias se activarán de dos maneras:

• Automáticamente cuando pausas en una línea durante unos segundos y el modelo de IA tiene suficiente contexto para una sugerencia.
• Manualmente con atajo en Windows o en Mac (puedes personalizar este atajo).

Presione Tab para aceptar una sugerencia, o ignorearla al continuar introducir.Actualmente, tu script debe contener al menos algunas líneas de código para activar una sugerencia.

Mejora las sugerencias

Para obtener sugerencias más precisas y relevantes, se recomienda que siga las prácticas de codificación limpia, independientemente de la asistencia, y:

• Descompone tu código en funciones más pequeñas.
• Usa nombres de scripts descriptivos que capturen la intención general de lo que hace cada script.Por ejemplo, nombra un script SyncCustomSounds en lugar de solo Sonidos .
• Asigna nombres descriptivos para parámetros, funciones y scripts.Por ejemplo, nombra una parte GreenSphere en lugar de simplemente grs, o nombra una función en lugar de >.El uso de funciones nombradas en lugar de funciones anónimas también puede producir mejores pistas.
• Consisten en incluir comentarios bien escritos que describan la tarea que estás implementando y cuáles deberían ser las entradas/salidas.

  • Considera incluir algunas llamadas de muestra con resultados esperados en los comentarios.
  • Sugiera cómo resolver un problema, por ejemplo -- Use raycast .
  • Usa el nombre exacto de función o variable que definiste, por ejemplo -- Create 10 greenSphere objects en lugar de -- Create 10 spheres.
• Si eres un programador novato, comienza con proyectos básicos como "hacer que el jugador salte cuando toque la parte" o usa la herramienta para generar pequeños fragmentos de código que puedes expandir a medida que aumenta tu conocimiento.

Limitaciones

La herramienta ayuda a automatizar tareas de codificación básicas, pero no siempre sugiere código perfecto. Las limitaciones conocidas incluyen:

• La activación manual no siempre fuerza la generación de una sugerencia.
• Las sugerencias se aprenden de forma automática a partir de un corpus de código y, por lo tanto, pueden reflejar algunas limitaciones del código en el que se entrenan.Por ejemplo, las sugerencias pueden no usar nuevas API en favor de API más antiguas, o pueden usar Lua en lugar de Luau.
• La herramienta puede generar información incorrecta o engañosa que no es útil para su propósito.
• Los filtros internos intentan bloquear el lenguaje ofensivo, pero no son completos y hay una posibilidad de que la herramienta genere información ofensiva o sesgada.
• Las sugerencias pueden ser las mismas, similares o diferentes entre los usuarios, incluso con los mismos prompts. Sin embargo, tu código nunca se compartirá con otros.
• La sugerencia puede ser incompleta debido a la longitud limitada de la salida de los modelos de aprendizaje.
• Hay un límite diario para el número de sugerencias y, una vez que se alcance el límite, no recibirás sugerencias hasta el día siguiente.

privacidaddel código

Actualmente, Roblox no utiliza ningún dato no público para entrenar los modelos de aprendizaje.La herramienta solo usa un pequeño subconjunto de recursos del mercado libre para ajustar grandes modelos de lenguaje y el subconjunto ha pasado varias pruebas para filtros de calidad y seguridad.

Además, todas las sugerencias se generan por el modelo de IA y no se transfieren de un usuario a otro.Dado que su código no se usa para el entrenamiento de modelos, no se sugerirá a otros usuarios de Asistente de código , con la excepción de que se publique código en artículos del mercado libre.

Multi-curso

El editor de scripts soporta el uso de múltiples cursores para hacer ediciones simultáneamente.Puedes agregar cursores en función de tus necesidades con un clic con el mouse o con un atajo de teclado.El cursor inicial se llama el cursor primario y los cursores adicionales se llaman cursores secundarios .

• Edita los que haces en la copia del cursor primario a los cursores secundarios.Cada edición cuenta como una acción, por lo que deshacer/rehacer una edición se aplica a todos los cursores.
• Los widgets como autocompletar aparecen en el cursor principal pero no en los cursores secundarios.
• Todos los atajos de teclado estándar para la edición de scripts funcionan con la edición de cursores múltiples, incluida la indentación de código, la activación de comentarios y la eliminación de líneas.

La siguiente tabla resume los flujos de trabajo multicursores y sus atajos.

Agregar cursores

Puedes agregar cursores con una combinación de atajos de teclado y maniobras con el mouse.Los cursores se fusionan si ocupan el mismo espacio, como si agregas cursores con teclas de flecha o eliminas todos los caracteres entre los cursores.

En la ubicación del ratón

Para agregar un cursor en la ubicación del puntero del mouse:

1. Mantenga presionado Alt en Windows o ⌥ en Mac.

2. Haga clic donde quiera agregar el cursor.

Con arrastrar el ratón

Puedes arrastrar el ratón para agregar un cursor a una selección, dividir una selección de varias líneas en líneas o seleccionar columnas y bloques de código/espacio en blanco.

Para agregar un cursor a una selección de código arrastrando:

1. Mantenga presionado Alt en Windows o ⌥ en Mac.

2. Haga clic y arrastre su mouse sobre la selección de código.

Arriba y abajo del cursor principal

Para agregar un cursor directamente por encima o por debajo del cursor principal:

1. Presione y mantenga presionado CtrlAlt en Windows o ⌘⌥ en Mac.

2. Presione las flechas ↑ o ↓.

A las selecciones de coincidencia

Puedes agregar cursores a todas las coincidencias de una selección o a la siguiente/anterior coincidir, y opcionalmente alternar si las coincidencias son sensibles a mayúsculas y/o coinciden con toda la palabra.

Para agregar un cursor a todas las coincidencias de una porción seleccionada:

1. Seleccione el código que desea buscar para encontrar coincidencias.

2. Presione ShiftAltL en Windows o Shift⌥L en Mac.

Quitar los cursores

Puedes eliminar los cursores con los siguientes atajos de teclado y maniobras con el ratón.Alternativamente, puedes salir de la edición de cursores múltiples presionando Esc .

En la ubicación del ratón

Para eliminar un cursor:

1. Presione y mantenga presionado Alt en Windows o ⌥ en Mac.

2. Haga clic en el cursor que desea eliminar.

Más recientemente agregado

Para eliminar el cursor más recientemente agregado, presione CtrlU en Windows o ⌘U en Mac.

Copiar y pegar cursores

Copiar una selección de código incluye los cursores dentro de ella.El comportamiento de la pasta depende del número de cursores en la fuente y del número de cursores en el destino:

• Si el número de cursores es el mismo, entonces cada cursor copiado se pega en cada cursor de destino correspondiente.
• Si el número de cursores es diferente, entonces cada cursor en el destino recibe toda la pega con cada cursor copiado como una nueva línea.

Formato en tipo on-line

Presionar enter/return identificará automáticamente cada cursor en la nueva línea con respecto a la línea anterior.Si la línea anterior comienza con un bloquesincompleto, el formateador intentará completarlo.

Configuración del editor

Muchas opciones de personalización se acceden a través de Archivo ⟩ Configuración del estudio ( AltS en Windows; ⌥S en Mac).

Las opciones comúnmente modificadas incluyen:

Atajos de teclado

El editor de scripts tiene las siguientes abreviaturas de teclado.También puedes acceder a muchos comandos desde la pestaña Guión que aparece en la barra de herramientas de Studio cada vez que estás viendo o editando un guión.