Lua Debugger | Documentación del Centro de creación de Roblox (2024)

El Editor de scripts en Studio es la herramienta principal para la creación de scripts en Roblox. Es un entorno que se mejora a sí mismo y que puede ayudarte a escribir código de alto impacto, acortar tu tiempo de desarrollo e iterar tus experiencias. Puede mejorar tu experiencia de scripting de las siguientes formas:

• Da formato y resalta la sintaxis en tu código.

• Ofrece formas de completado automático de frases en tu código mientras escribes.

• Te ayuda a navegar por el código porque se va directamente a declaraciones de variables y funciones.

• Te ayuda a encontrar y reemplazar código en los scripts abiertos o en todos los scripts.

• Te da feedback en tiempo real sobre la calidad y el rendimiento de tu código.

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

Autocompletar

El Editor de scripts genera información relacionada con el código que puede mejorar la eficiencia de tu programación.

• Ofrece sugerencias sobre cómo completar frases a medida que las escribes. Usa las teclas de dirección hacia arriba y hacia abajo para buscar las sugerencias y, a continuación, presiona Tab o Enter para aceptar una sugerencia e insertar la frase completa.

  

• El completado automático está vinculado a la experiencia modelo de datos. Si tienes un Parten Workspacellamado CoolRocketShip, entonces la función para autocompletar sugiere CoolRocketShipcuando escribes workspace.coole indica que se trata de un Part.

  

• La función para autocompletar también ofrece nombres para las variables y las funciones que declaras, lo que facilita la tarea de evitar los errores tipográficos y reutilizar el código.

  

• La ventana emergente para autocompletar proporciona ejemplos de documentación y código similares a los de la Referencia API de Engine y te proporciona un contexto sobre el uso de una API.

  

• Cuando escribes un argumento en una función, la ventana emergente para autocompletar también muestra la firma de la función y te proporciona una referencia para sus parámetros y sus valores de retorno.

  

Navegación por el código

Ir a declaración

Puedes saltar a la declaración de una función o variable al hacer clic derecho en su llamada y hacer clic en Ir a declaración. También puedes saltar a una declaración si mantienes presionada la tecla Ctrl en Windows o ⌘ en macOS cuando hagas clic en la llamada.

Filtro de funciones de script

El Filtro de funciones de script muestra una lista de funciones declaradas en un script. Para abrirlo, haz clic derecho en cualquier lugar del editor y, a continuación, haz clic en Filtro de funciones de script. Con la lista abierta, puedes examinar las firmas de cada función, filtrarlas por nombre y hacer doble clic en una para saltar a su declaración.

Buscar y reemplazar

El widget para buscar y reemplazar te permite encontrar y reemplazar código en un script abierto. El widget admite la coincidencia de mayúsculas, la coincidencia de toda la palabra y expresiones regulares. Para abrir el widget, presiona Ctrl + F en Windows o ⌘ + F en macOS.

Feedback en tiempo real

Análisis de script

La ventana de análisis de script, a la que se puede acceder desde la pestaña Ver, realiza un análisis estático en tus scripts y muestra los errores y las advertencias activos. Para obtener más información sobre los errores y las advertencias, consulta la documentación de Luau Lang.

Ventana de salida

La ventana Salida, a la que se puede acceder desde la pestaña Ver, muestra los errores capturados de los scripts en ejecución, los mensajes del motor de Roblox, los mensajes de las llamadas a print() y los errores de las llamadas a warn(). Para obtener detalles sobre cómo configurarlo para tu flujo de trabajo, consulta Ventana de salida.

Code Assist

Code Assist es un asistente de IA que sugiere líneas o funciones de código a medida que escribes y te ayuda a codificar de manera más eficiente y a mantenerte enfocado. Las sugerencias se activarán de dos maneras según los contextos de tu comentario y código:

• Automáticamente, cuando pausas en una línea durante unos segundos y el modelo de IA tiene suficiente contexto para una sugerencia.

• Manualmente, con los atajos Alt + ∖ en Windows, o ⌥∖; en MacOS (puedes personalizar este atajo).

Presiona Tab para aceptar una sugerencia; para ignorarla, sigue escribiendo. Por el momento, tu script debe contener al menos unas pocas líneas de código para activar una sugerencia.

Mejorar las sugerencias

Para obtener sugerencias más precisas y pertinentes, se recomienda que sigas prácticas de codificación limpias, independientemente de la resistencia de la IA.

• Divide tu código en funciones más pequeñas.

• Usa nombres de script descriptivos que capturen la intención general de lo que hace cada script. Por ejemplo, nombra un script SyncCustomSounds en lugar de solo Sounds.

• Asigna nombres descriptivos para los parámetros, las funciones y los scripts. Por ejemplo, nombra una parte GreenSphere en lugar de simplemente grs, o nombra una función generateSphere()en lugar de gen(). Usar funciones con nombre en lugar de funciones anónimas también puede producir mejores pistas.

• Incluye constantemente comentarios bien escritos que describan la tarea que estás implementando y cuáles deben ser las entradas y salidas.

  • Considera la posibilidad de incluir algunas llamadas de ejemplo con los resultados esperados en los comentarios.

  • Sugiere cómo resolver un problema, por ejemplo -- Use raycast.

  • Usa la función exacta o el nombre de la variable que definiste, por ejemplo, en -- Create 10 greenSphere objectslugar de -- Create 10 spheres.

• Si eres un escritor de scripts 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 puedas ampliar a medida que crece tu conocimiento.

Limitaciones

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

• La activación manual no siempre genera 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 están basadas. Por ejemplo, las sugerencias no pueden usar API más nuevas en lugar 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 tu propósito.

• Los filtros internos intentan bloquear el lenguaje ofensivo, pero no son infalibles, y existe la 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 solicitudes. Sin embargo, tu código nunca se compartirá con otras personas.

• La sugerencia puede estar incompleta debido a la longitud limitada de la salida de los modelos de aprendizaje.

• Hay un límite diario para la cantidad de sugerencias y, una vez que se alcanza el límite, no recibirás sugerencias hasta el día siguiente.

Privacidad del código

Por el momento, Roblox no usa ningún dato privado para entrenar los modelos de aprendizaje. La herramienta solo usa un pequeño subconjunto de recursos gratuitos del mercado para ajustar modelos de lenguaje grandes, y el subconjunto ha pasado varias comprobaciones para detectar filtros de calidad y seguridad.

Además, todas las sugerencias las genera el modelo de IA y no se transfieren de un usuario a otro. Como tu código no se usa para el entrenamiento de modelos, no se sugerirá a otros usuarios de CodeAssist, con la única excepción de que el código se publicará en los artículos gratuitos del mercado.

Varios cursores

El Editor de scripts admite el uso de varios cursores para hacer ediciones simultáneamente. Puedes añadir cursores en función de tus necesidades con un clic del mouse o un atajo del teclado. El cursor inicial se llama cursor principal y los cursores adicionales se llaman cursores secundarios.

• Las ediciones del cursor principal se copian en los cursores secundarios. Si deshaces o rehaces una edición mientras usas la edición de varios cursores, el deshacer o rehacer se aplica a todos los cursores.

• Los widgets, como Autocompletar, aparecen en el cursor principal, pero no en los cursores secundarios.

• Los atajos estándar del teclado para editar en el Editor de scripts, como el código de sangría, alternar comentarios y eliminar líneas, funcionan con la edición de varios cursores.

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

Añadir cursores

Puedes añadir cursores con una combinación de atajos del teclado y maniobras del mouse. Los cursores se fusionan si ocupan el mismo espacio; por ejemplo, si añades cursores con teclas de flecha o eliminas todos los caracteres entre los cursores.

En la ubicación del mouse

Sigue estos pasos para añadir un cursor al mouse:

1. Mantén presionada la tecla Alt en Windows o ⌥ en macOS.

2. Haz clic en el Editor de scripts al que deseas añadir el cursor.

Con el arrastre del mouse

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

Seleccionar con arrastre

Sigue estos pasos para añadir un cursor a una selección de texto:

1. Mantén presionada la tecla Alt en Windows o ⌥ en macOS.

2. Haz clic y arrastra el mouse sobre la selección de texto.

Dividir selecciones en líneas

Sigue estos pasos para añadir cursores al final de cada línea en una selección de varias líneas y al final de la selección:

Selección de Columna/Bloque

Para seleccionar columnas y bloques de código o espacios en blanco, arrastra el ratón mientras mantienes presionado ShiftAlt en Windows o Shift⌥ en macOS. A medida que arrastres, se agregará un cursor en cada línea resaltada.

Por encima y por debajo del cursor principal

Sigue estos pasos para añadir un cursor directamente por encima o por debajo del cursor principal:

1. Mantén presionada la tecla Ctrl + Alt en Windows o ⌘ + ⌥ en macOS.

2. Presiona las flechas ascendente y descendente.

A la selección coincidente siguiente

Puedes añadir cursores a todas las coincidencias de una selección o a la coincidencia siguiente/anterior, y opcionalmente alternar si las coincidencias distinguen entre mayúsculas y minúsculas y/o coinciden con toda la palabra.

Contraer todos los pliegues

Sigue estos pasos para añadir un cursor a todas las selecciones coincidentes:

1. Selecciona el código en el que deseas buscar coincidencias.

2. Presiona Shift + Alt + L en Windows o Shift + ⌥ + L en macOS.

Correspondencia siguiente/anterior

Sigue estos pasos para añadir un cursor a la selección coincidente anterior:

1. Selecciona el código en el que deseas buscar coincidencias.

2. Presiona Ctrl + D en Windows o ⌘ + D en macOS.

3. Sigue presionando Ctrl/⌘ + D hasta que hayas seleccionado todas las coincidencias siguientes que deseas.

No hay un atajo predeterminado para agregar un cursor al anterior de la selección coincidente, pero puedes agregar el tuyo:

1. También puedes crear un atajo de tu elección al abrir la ventana Personalizar atajos en Archivo > Avanzado > Personalizar atajos y editar el atajo para "Seleccionar aparición anterior".

2. En la ventana de atajos, localiza Seleccionar ocurrencia anterior.

   

3. A todas las selecciones coincidentes

   

4. Confirma tu configuración haciendo clic Aceptar en la esquina inferior derecha de la ventana.

Caso coincidente o palabra completa

Para cada uno de los flujos de trabajo relacionados con la concordancia anteriores, puedes hacer coincidir caso y/o palabra completa de la siguiente manera:

1. Abre la ventana de apertura rápida con Ctrl + P en Windows o ⌘ + P en macOS.

2. Utiliza los botones de alternancia para elegir si una selección coincidente debe distinguir entre mayúsculas y minúsculas y/o coincidir solo con la palabra completa.

   

Eliminar los cursores

Puedes eliminar cursores con una combinación de atajos del teclado y maniobras del mouse. Para eliminar todos los cursores secundarios y salir de la edición de varios cursores, presiona Esc o haz clic en cualquier lugar del Editor de scripts.

En la ubicación del mouse

Sigue estos pasos para eliminar un cursor:

1. Mantén presionada la tecla Alt en Windows o ⌥ en macOS.

2. Haz clic en el cursor que deseas eliminar.

Añadida más recientemente

Para eliminar el cursor añadido más recientemente, presiona Ctrl + U en Windows o ⌥ + U en macOS.

Copiar y pegar los cursores

El copiado de una selección de texto incluye los cursores dentro de ella. El comportamiento del copiado depende de la cantidad de cursores en el origen y la cantidad de cursores en el destino:

• Si la cantidad de cursores es la misma, cada cursor se copia en cada cursor de destino correspondiente.

• Si la cantidad de cursores es diferente, cada cursor en el destino recibe todo el copiado con cada cursor copiado como una línea nueva.

Ir a declaración

Al pulsar ingresar/regresar, cada cursor aplicará la sangría automáticamente en la nueva línea relativa a la línea anterior. Si la línea anterior comienza con un bloque incompleto, el formateador intentará completarlo.

Atajos del teclado

El Editor de scripts tiene los siguientes atajos del teclado. También puedes acceder a muchos comandos desde la pestaña Script que aparece en la barra de herramientas de Studio siempre que estés viendo o editando un script.