Editor de Script

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

El Editor de Scripts en Studio es la herramienta principal para programar en Roblox. Es un entorno de mejora de sí mismo que puede ayudarlo a escribir código de alto impacto, acortar su tiempo de desarrollo y repetir en sus experiencias. Puede mejorar su experiencia de programación de:

El Editor de Scripts soporta todos los tipos de scripts y se abre automáticamente cuando creas un nuevo script o haces clic dos veces en un script existente en la ventana Explorador.

Características de Autocompletado

Las funciones de autocompletado del Editor de Script generan información relacionada con los códigos que puede mejorar su eficiencia de programación, como:

  • Sugerencias informadas sobre cómo completar frases mientras escribes que son contextuales para el modelo de datos de la experiencia. Por ejemplo, si tienes un Class.Model en Model llamado 0> RocketShip0> , la

    Autocomplete showing suggestions based on the experience's data model
  • Llenar nombres automáticamente para variables y funciones que declarar, ayudándote a evitar típicos molestos.

    Autocomplete showing suggestions based on a previously declared variable.
  • Ventanas de documentación con muestras de código que son similares a las de la Referencia de API del Motor, lo que te da contexto sobre el uso de la API.

    Autocomplete showing suggestions based on a Roblox engine API.
  • Sugerencias de herramientas de encima del mouse que puedes personalizar con tu propia documentación definida.

    Autocomplete showing custom documentation.
  • Análisis de script de análisis de error en el modo de hover con información que puedes usar para solucionar problemas.

    Autocomplete showing diagnostic information.
  • Firmas de función cuando escribes un argumento, proporcionándote una referencia para sus parámetros y valores de retorno.

    Autocomplete showing function signature

Ir a la declaración

Puede saltar a la declaración de una función o variable al mantener presionado Ctrl en Windows o en Mac cuando hace clic en el llamado, o haciendo clic con el botón derecho en su llamado y haciendo clic en Ir a declaración .

Go to Declaration workflow on a declared function

Filtro de función de script

El Filtro de Función de Script muestra una lista de todas las funciones declaradas en un script. Para abrirlo, presione AltF en Windows o 2> ⌥2> 5> F5> en Mac. Con la lista abierta, puede buscar las firmas de cada función, filtrar por nombre y hacer clic dos veces en uno para saltar a su declaración.

Script Function Filter showing all functions inside a script

Encuentra y Reemplaza

El widget Buscar/Reemplazar le permite encontrar y reemplazar el código en un script abierto. El widget soporta coincidir con caso, encontrar la palabra entera y buscar por expresiones regulares. Para abrirlo, presione CtrlF en Windows o 2>Buscar2> en Mac.

Find/Replace widget labeled

Comentarios en tiempo real

Análisis de Script

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

Script with various marked errors
Errores de guión resaltados en el Editor de guiones
Script Analysis window with details on marked errors from script
Errores explicados en la ventana de Análisis de Script

Ventana de salida

La ventana Salida , accesible desde la Vista pestaña, muestra los errores capturados al ejecutar scripts, mensajes de Roblox Engine, mensajes de llamadas a print() y errores de llamadas a 1> arn()1> . Para obtener detalles sobre la configuración para su flujo de trabajo, consulte 4>Salida de ventana4> .

Asistente de código

Asistente de Código es una función que sugiere líneas o funciones de código mientras introducir, lo que te ayuda a codificar más eficientemente y mantenerte enfocado. Según los contextos de tu comentario y código, las sugerencias se activarán de dos maneras:

  • Automáticamente cuando tomas una pausa en una línea durante unos segundos y el modelo de IA tiene suficiente contexto para sugerir.
  • Manualmente con atajo Alt en Windows o 2>∖2> en Mac (puedes 5> personalizar 5> este atajo).

Presione Tab para aceptar una sugerencia, o ignorela siguiendo introducir. Actualmente, su script necesita contener al menos algunas líneas de código para activar una sugerencia.

Mejorar sugerencias

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

  • Descompone tu código en funciones más pequeñas.
  • Usa nombres de script descriptivos que capturen el propósito general de lo que cada script hace. Por ejemplo, nombre un script Sincronizar sonidos personalizados en lugar de simplemente Sonidos .
  • Asigna nombres descriptivos para parámetros, funciones y scripts. Por ejemplo, nombre una parte GreenSphere en lugar de simplemente grs , o nombre una función generateSphere() en lugar de 1> gen1> . Usar nombres de funciones en lugar de nombres anónimos puede producir mejores sugerencias.
  • Incluye consistentemente comentarios bien escritos que describen la tarea que estás implementando y qué salidas/entradas deberían ser.
    • Considera incluir algunas llamadas de muestra con resultados esperados en los comentarios.
    • Sugiere cómo solucionar un problema, por ejemplo -- Use raycast .
    • Usa el nombre de función o nombre de 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 "haz que el jugador salte cuando toca la parte" o usa la herramienta para generar pequeños fragmentos de código que puedes expandir a medida que tu conocimiento crece.

Limitaciones

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

  • El gatillo manual no siempre force-Generate una sugerencia.
  • Las sugerencias se aprenden automáticamente a partir de un corpus de código y, por lo tanto, pueden reflejar algunas limitaciones del código en el que se entrena. Por ejemplo, las sugerencias no pueden usar APIs más nuevas en favor de APIs 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 las mismas preguntas. Tu código, sin embargo, 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 alcanza el límite, no obtendrás sugerencias hasta el día siguiente.

Privacidad del código

Actualmente, Roblox no usa ningún dato no público para entrenar los modelos de aprendizaje. La herramienta solo usa un pequeño subconjunto de recursos del mercado gratuito para ajustar los modelos de lenguaje grandes y el subconjunto ha pasado varios 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 del modelo, no se recomendará a otros usuarios de Code Assist , con la única excepción de que el código se publique en los artículos de mercado gratuitos.

Multi- cursor

El Editor de Scripts soporta el uso de múltiples cursores para hacer ediciones simultáneamente. Puedes agregar cursores basado en tus necesidades con un clic de mouse o atajo de teclado. El cursor inicial es llamado el cursor principal y los cursores adicionales son llamados cursores secundarios .

  • Edita que haces en la copia de cursor principal a los cursor 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 secundarios.
  • Todos los atajos de teclado estándar para editar scripts con multi-edición de cursor, incluyendo la indentación de código, alternar comentarios y eliminar líneas.

La siguiente tabla resume los flujos de trabajo de múltiples cursores y sus atajos.

ComandoVentanasMac
Añadir/Quitar Cursor en la ubicación del mouse Alt + hcer clic + hcer clic
Quitar el cursor agregado más recientemente CtrlUU
Añadir/Modificar Cursor on Mouse Drag Alt + arrastrar + arrastrar
Añadir cursor de arriba/abajo Ctrl Alt / Ctrl 0>Alt0> 2>↓2> 0>⌥0> 2>↓2>
Añadir Cursor a la próxima selección de coincidencia CtrlDD
Añadir Cursor a cada selección que coincida MayúsAlternativoLShiftL
Selección de columnas/bloques ShiftAlt  + arrastrarShift  + arrastrar
Separar selecciones en líneas MayúsAlternativoYMayúsY

Agregar cursores

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

En la ubicación del mouse

Para agregar un cursor a la ubicación de su puntero de mouse:

  1. Mantenga Alt en Windows o en Mac.

  2. Haga clic en donde desea agregar el cursor.

Con Mouse Drag

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

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

  1. Mantenga Alt en Windows o en Mac.

  2. Haz clic y arrastra tu ratón sobre la selección de código.

Arriba y Abajo Cursor Primario

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

  1. Presione y aguanta CtrlAlt en Windows o en Mac.

  2. Presione las flechas o .

A la Coincidencia de Selecciones

Puedes agregar cursores a todos los partidos de una selección o al siguiente/anterior coincidir, y opcionalmente alternar si los partidos son sensibles a mayúsculas y/o a la palabra entera.

Para agregar un cursor a todos los partidos de una parte seleccionada:

  1. Seleccione el código que desea buscar.

  2. Presione ShiftAltL en Windows o Shift1> ⌥1> 3> L 3> en Mac.

Eliminando cursores

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

En la ubicación del mouse

Para eliminar un cursor:

  1. Presione y aguanta Alt en Windows o en Mac.

  2. Haga clic en el cursor que desea eliminar.

Añadido Recientemente

Para eliminar el cursor más recientemente agregado, presione CtrlU en Windows o 0>U0> en Mac.

Copiar y pegar cursores

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

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

Formato de On-Type

Al presionar enter/return se alineará automáticamente cada cursor en la nueva línea en relación con la línea anterior. Si la línea anterior comienza con un bloquesincompleto, el formador intentará completarlo.

Configuración del Editor

Muchas opciones de personalización se acceden a través de Archivo > Configuración del Studio ( Alt 0> S0> en Windows; 3>⌥3> 5> S5> en Mac).

A close up view of the Studio Settings window with the Script Editor tab selected.

Las opciones comúnmente modificadas incluyen:

OpciónDescripción
Fuente Cara de fuente y tamaño para el código en el editor.
Anchura de la etiqueta Número de espacios que representan una Tabla de espaciado.
Indentar usando espacios Si se habilita, los espacios que coinciden con Anchura de la pestaña se insertan con Tab pulsar.
Envoltura de texto Si se habilita, las líneas de código más largas se envuelven con la siguiente línea.
Predefinido de color del editor de scripts Predefinido de color para elementos de código, colores de selección y más. Después de elegir un predefinido, puede establecer colores específicos para opciones como Color de selección y Color de comentario .

Atajos de teclado

El Editor de Script tiene los siguientes atajos de teclado. También puede acceder a muchos comandos desde la Pestaña de script que aparece en la barra de herramientas de Studio cuando estás viendo o editando un script.

ComandoVentanasMac
Cerrar guión CtrlWW
Reabrir el último script cerrado CtrlShiftTShiftT
Abrir rápido CtrlPP
Mostrar script en Explorador CtrlAltKK
Zoom en Ctrl==
Zoom Out Ctrl--
Restablecer el Zoom del Script Ctrl00