Con los pasos de esta página, aprenderás a crear, ejecutar, editar y solucionar problemas en un programa en Verse que diga "¡Hola, mundo!" con Unreal Editor para Fortnite (UEFN).
Consulta Cómo iniciar Unreal Editor para Fortnite para ver cómo se accede a UEFN.
Tu primer programa en Verse
La plantilla Juegos iniciales del dispositivo de Verse - VKT funciona como una introducción a los dispositivos creados con Verse y contiene varios dispositivos que puedes consultar como ejemplo. En los pasos siguientes, crearás y modificarás un nuevo dispositivo Verse en esta plantilla.
-
En la ventana Explorador de proyectos, selecciona Ejemplos de funciones para ver todos los ejemplos de funciones de UEFN.
-
En la lista de «Ejemplos de funciones», haz clic en Dispositivo de Verse para resaltarlo.
-
En la parte inferior de la pantalla, en Nombre del proyecto, nombra el proyecto Mi proyecto de Verse y haz clic en Crear.
-
En la barra de menús, ve a Verse > Explorador de Verse.
-
En Explorador de Verse, haz clic con el botón derecho del ratón en el nombre de tu proyecto y selecciona Añadir nuevo archivo de Verse al proyecto para abrir la ventana Crear secuencia de comandos de Verse.
-
En la ventana Crear secuencia de comandos de Verse, haz clic en Dispositivo de Verse para seleccionarlo como plantilla.
-
En Explorador de contenido, ve a la carpeta Dispositivos del modo Creativo en la carpeta de contenido del proyecto.
Si el explorador de contenido no está ya abierto, haz clic en Ventana en la barra de menús y, a continuación, selecciona Explorador de contenido o selecciona Almacén de contenido en la parte inferior izquierda de la ventana de UEFN.
La ruta debe ser Todo > Contenido de Mi proyecto de Verse > Dispositivos del modo Creativo.
-
Arrastra hello_world_device al nivel.
-
En la barra de herramientas, haz clic en Abrir sesión para probar tu isla.
Haz clic en la imagen para ampliarla.
-
En la ventana Guardar contenido, haz clic en Guardar selección para guardar los cambios en tu proyecto.
-
Cuando el servidor termine de cargar el proyecto, abre el menú principal y haz clic en Iniciar juego.
-
En el cliente, pulsa Escape para abrir la pantalla del menú principal y haz clic en Configuración de la isla. A continuación, haz clic en Registro en la barra de navegación superior para ver el registro.
-
En el registro, busca la línea con «¡Hola, mundo!» seguida de «2 + 2 = 4» en la siguiente línea. Estas líneas proceden del archivo hello_world_device.verse. Al añadir el dispositivo creado con Verse a tu nivel, su código se ejecutó cuando iniciaste el juego.
Ahora que has ejecutado tu primer programa Verse, vamos a ver el código de hello_world_device.verse y cambiarlo. Mantén el cliente en funcionamiento para la siguiente sección.
Cómo modificar el programa
Sigue estos pasos para ver el archivo hello_world_device.verse, que ha creado el dispositivo de la sección anterior y, a continuación, añade una línea de código nueva.
- En la barra de menús, haz clic en Verse > Explorador de Verse para ver todos los archivos de Verse que hay en tu proyecto.
-
Debajo del nombre del proyecto, haz doble clic en hello_world_device.verse para abrir el archivo.
-
El archivo de Verse se abre en Visual Studio Code (VS Code), un editor para escribir programas. Si no tienes Visual Studio Code en el ordenador, aparecerá un mensaje para que lo instales.
Haz clic en la imagen para ampliarla.
La extensión de código de Verse es una extensión para VS Code que proporciona comprobación de errores de Verse y resaltado de sintaxis, y también te permite compilar y aplicar cambios a tus secuencias de comandos de Verse. directamente desde el código VS.
La extensión de Verse incluida con UEFN es la única extensión de lenguaje admitida oficialmente para Verse. Esta extensión se habilita automáticamente al iniciar UEFN. Si desinstalas la extensión, se reinstalará cuando vuelvas a ejecutar UEFN.
Puedes verificar la instalación de la extensión de código de Verse por la presencia de los botones Foco de editor, Compilar cambios de Verse y Aplicar cambios de Verse en la parte superior de la ventana de VS Code.
Haz clic en la imagen para ampliarla.
Verás cómo funciona el resto de este código más tarde, pero por ahora, todo el código que introduzcas en la línea OnBegin<override>()<suspends>:void= se ejecutará cuando comience la partida, así que añade el siguiente código al final del archivo:
Print("¡Esta es mi primera línea de código en Verse!")
El archivo de Verse debería tener el siguiente aspecto:
using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }
# Consulta https://dev.epicgames.com/documentation/en-us/uefn/create-your-own-device-in-verse para aprender a crear un dispositivo Verse.
# Dispositivo del modo Creativo creado con Verse que puede colocarse en un nivel.
hello_world_device := class(creative_device):
# Se ejecuta cuando se inicia el dispositivo en un juego en ejecución
OnBegin<override>()<suspends>:void=
# PENDIENTE: Sustituye esto con tu código.
Print("¡Hola, mundo!")
Print("2 + 2 = {2 + 2}")
Print("¡Esta es mi primera línea de código en Verse!")
Cualquier texto escrito después del símbolo # se considera un comentario del código y se ignora al ejecutar el programa. Los comentarios del código son útiles para quienquiera que lea el código, porque contienen explicaciones relativas al código. En este ejemplo, # Se ejecuta cuando el dispositivo se inicia en una partida en marcha y #PENDIENTE: Sustituye esto con tu código. son dos comentarios.
Cómo guardar los cambios
- Guarda el archivo hello_world_device.verse en Visual Studio Code.
-
En la barra de herramientas de UEFN, haz clic en Verse y, a continuación, en Compilar código de Verse para compilar tu código.
Haz clic en la imagen para ampliarla.
-
Una vez compilado correctamente, aparecerá una marca de verificación verde sobre el botón Verse. Si surgen problemas durante la compilación, aparecerá un icono rojo de parada y no podrás compilar el código hasta que resuelvas todos los errores. Si esto ocurre, consulta Cómo resolver los problemas del código para obtener consejos sobre cómo arreglar el código.
Haz clic en la imagen para ampliarla.
-
Al finalizar la compilación del código, se mostrarán las opciones Aplicar cambios y Aplicar cambios de Verse en la barra de herramientas de UEFN. Cuando tu código termina de compilarse, las opciones Aplicar cambios y Aplicar cambios de Verse aparecen en la barra de herramientas de UEFN. La opción Aplicar cambios actualiza el cliente con todos los cambios realizados en el editor, tales como añadir y eliminar elementos, modificar propiedades de objetos y cualquier cambio realizado en el código Verse. Aplicar cambios de Verse solo actualiza el código Verse y es más rápido que Aplicar cambios. Esto es útil en situaciones en las que deseas realizar pequeños cambios incrementales en el código sin actualizar la sesión. Haz clic en Aplicar cambios en Verse para actualizar el cliente.
Haz clic en la imagen para ampliarla.
- Cuando el servidor termine de actualizar el proyecto, abre el menú principal y haz clic en Iniciar juego.
-
En el registro, busca la línea con «¡Esta es mi primera línea de código en Verse!». ¡Ese es el código que acabas de añadir a la secuencia de comandos!
Ejecución secuencial
Al añadir una línea de código para mostrar texto en el registro, el texto «¡Esta es mi primera línea de código en Verse!» apareció en el registro después de «2 + 2 = 4». El motivo es que esas líneas de código se ejecutan en el orden en el que están escritas debajo de la línea OnBegin<override>()<suspends>:void=.
Si cambias el orden de las líneas de impresión, el texto se imprimirá en el registro en el nuevo orden, con "¡Esta es mi primera línea de código en Verse!!" antes de "2 + 2 = 4":
OnBegin<override>()<suspends>:void=
# PENDIENTE: Sustituye esto con tu código.
Print("¡Hola, mundo!")
Print("¡Esta es mi primera línea de código en Verse!")
Print("2 + 2 = {2 + 2}")
El código suele ejecutarse línea por línea, en el orden en que aparecen las expresiones. Es lo que se conoce como ejecución secuencial. A medida que descubras más sobre la programación con Verse, aprenderás a diseñar el flujo de ejecución para cambiar la forma en que se comporta tu programa.
Cómo resolver los problemas del código
Ahora que has escrito y ejecutado tu primera línea de código de Verse, te mostramos cómo resolver algunos de los problemas con los que te puedes encontrar al escribir código.
Existen dos tipos de errores con los que te puedes encontrar: errores del compilador y bugs.
Errores del compilador
Como sucede con todo tipo de escritura, puedes cometer errores en tu código. Estos errores impiden que el compilador comprenda lo que quieres que haga el programa. Se denominan errores del compilador porque impiden que el programa se compile y suelen ser errores de sintaxis. Esto te impide ejecutar tu código en una prueba de juego.
VS Code puede detectar algunos errores del compilador e informarte de ellos cambiando el color del nombre de archivo a rojo en la pestaña del archivo y en el panel del Explorador.
VS Code también añade un subrayado rojo en la línea en la que detecta un problema. Cuando colocas el puntero sobre el subrayado rojo, aparece un mensaje de error con una posible solución rápida si VS Code puede proporcionar alguna.
Es posible que VS Code no detecte todos los errores del compilador, por lo que también se recomienda compilar el código antes de intentar ejecutarlo. Así detectarás los errores desde el principio. Para ello, haz clic en Verse y luego en Compilar código de Verse en la barra de herramientas de UEFN. Esta opción compila todos los archivos de Verse del proyecto, lo que traduce el código que has escrito a instrucciones ejecutables por el ordenador.
Haz clic en la imagen para ampliarla.
El registro de salida mostrará un mensaje de éxito si tu código se compila correctamente o errores que deberás corregir para poder utilizar tu código en una prueba de juego.
Al seleccionar Compilar código en Verse, también aparecerá un mensaje emergente si se ha producido un error de compilación.
Al seleccionar Ver errores en el mensaje emergente, se abre la ventana Registro de mensajes y se muestran todos los errores del código detectados por VS Code.
Haz clic en la imagen para ampliarla.
Una vez que hayas corregido los errores, puedes volver a compilar el código y verificar que lo haga correctamente. Para ello, haz clic en Compilar secuencias de comandos de Verse de nuevo en la barra de herramientas de UEFN, o selecciona Recompilar en el mensaje emergente.
Bugs
Cuando el código se compila correctamente, pero el programa no hace lo que esperabas, estos problemas se denominan bugs. Los bugs son problemas de la lógica del código, y una forma de buscarlos es imprimir en el registro.
El código de hello_world_device es un buen ejemplo de cómo se utiliza la impresión en el registro para verificar si el código se ejecuta al iniciar el juego.
OnBegin<override>()<suspends>:void=
# PENDIENTE: Sustituye esto con tu código.
Print("¡Hola, mundo!")
Print("¡Esta es mi primera línea de código en Verse!")
Print("2 + 2 = {2 + 2}")
También puedes imprimir valores para probar si tu código hace lo que esperabas. Al ejecutar el siguiente código, se muestra el texto "2 + 2 = 4" en el registro:
Print("2 + 2 = {2 + 2}")
La expresión {2 + 2} se evaluó para ser 4 antes de que el texto se mostrara en el registro. Las llaves {} situadas entre las comillas dobles " " de la última línea indican que la expresión debe evaluarse antes de convertirse en texto. Inyectar un valor en una cadena de esta forma es un ejemplo de interpolación de cadenas.
Si cambias la expresión situada entre las llaves, también cambiará el valor impreso. En el siguiente ejemplo, la expresión cambia a {2 + 3}, así que el registro mostrará "2 + 2 = 5":
OnBegin<override>()<suspends>:void=
# PENDIENTE: Sustituye esto con tu código.
Print("¡Hola, mundo!")
Print("¡Esta es mi primera línea de código en Verse!")
Print("2 + 2 = {2 + 3}")
Siguientes pasos
Ahora que has visto una breve introducción a Verse y a cómo ejecutar tu código y resolver sus problemas, ve a Aprende los aspectos básicos de la escritura de código en Verse para ampliar tus conocimientos sobre la programación en general y obtener más información sobre cómo aprovechar esta herramienta de programación.
También puedes jugar al minijuego de iniciación de dispositivos Verse interactuando con el botón de la consola cuando aparezcas. Puedes descubrir cómo se creó este minijuego leyendo Plantilla de iniciación de Verse, y puedes consultar los archivos de código utilizados en este proyecto en el explorador de Verse.