Creación y cambio de proyectos de juego

Esta característica está en versión preliminar y está sujeta a cambios.

Puede utilizar el Project Configurator para crear y cambiar la configuración que afecta a la creación y edición de un proyecto de juego. Puede utilizar la Project Configurator para hacer lo siguiente:

• Crear un proyecto de juego

• Habilitar o deshabilitar gemas (código y archivos de recursos) en el proyecto del juego.

• Cambiar proyectos de juego

Para obtener más información acerca de cómo crear y compilar un nuevo proyecto de juego para Lumberyard, vea el siguiente tutorial de vídeo.

Plantillas de proyecto

Al crear un proyecto de juego con el Project Configurator, puede utilizar las siguientes plantillas:

Vaciar plantilla

La plantilla Empty (Vacía) tiene las características mínimas requeridas para que el editor cargue y ejecute un proyecto de juego:

• CryLegacy – Habilita el editor y el iniciador para cargar un proyecto de juego que contiene código heredado

• Legacy Game Interface –: habilita el editor y el iniciador para cargar un proyecto de juego que contiene código de interfaz de juego heredado

• LyShine Gema –: proporciona acceso al sistema de interfaz de usuario dentro del juego para Lumberyard

• Gema Maestro: ofrece acceso a las características de cinemática–

Plantilla Default

La plantilla Default (Predeterminada) se crea a partir de la plantilla Empty (Vacía) y permite a las siguientes gemas proporcionar características básicas para el desarrollo de juegos:

• Amazon GameLift – Proporciona capacidades para utilizar este servicio y crear sesiones de juego

• Cámara de – Incluye un componente de cámara básico para la representación del tiempo de ejecución

• ChatPlay – Incluye la interfaz para activar eventos basados en la actividad de chat de Twitch

• Cloud Canvas –: ofrece capacidades de scripting visual para potenciar su backend de juegos con servicios deAWS

• Gestures: – permite la entrada basada en gestos, incluido hacer clic/pulsar, arrastrar, sostener, pellizcar, rotar y deslizar.

• Http Requestor: añade compatibilidad para gestionar solicitudes HTTP y HTTPS–

• Compras desde la aplicación: – proporciona la API de compra en la aplicación para Android e iOS.

• Input Management Framework: – convierte la entrada para eventos de juego definidos por el usuario.

• LyShine – Proporciona acceso al sistema de interfaz de usuario dentro del juego para Lumberyard

• PBS Reference Materials – Incluye un conjunto de materiales de referencia de sombreado basados físicamente y activos de textura

• Physics Entities (Entidades físicas): (heredada) – Proporciona modificadores de entidades físicas para simular eventos físicos

• Activos primitivos de – proporciona objetos primitivos para manipular en su nivel

Para ver las gemas que se han habilitado para la plantilla Default (Predeterminada), cree un proyecto basado en dicha plantilla y elija Enable Gems (Habilitar gemas).

La plantilla Default (Predeterminada) incluye también un nivel simple para poder manipular componentes y entidades en el editor y experimentar con otros recursos en un entorno gris neutro. El nivel simple incluye una cámara, una sola luz, una sonda de entorno para reflejos y objetos primitivos con física habilitada. Los objetos los proporciona el Gema de activos primitivos.

nota

• Al crear el proyecto de juego, recomendamos la plantilla Default (Predeterminada) y su conjunto de gemas. Esta plantilla le ayuda a empezar a diseñar y desarrollar con rapidez. Algunas de las gemas de la plantilla son opcionales.

• Para ver un proyecto base sin gemas opcionales, utilice la plantilla Empty (Vacía). Esta plantilla crea un proyecto básico utilizando las características mínimas para iniciar un juego.

Creación de un proyecto de juego en Lumberyard

Puede crear un proyecto de juego con el Project Configurator o la línea de comandos. Cuando se crea un proyecto de juego, se crea también lo siguiente:

• Una gema de juegos que incluye el código específico del juego. El nombre de la gema se basa en el proyecto de juego y se encuentra en el directorio MyNewProject\Gem.

• Un archivo de la solución Visual Studio específico del juego.

Project Configurator

Para crear un proyecto de juego en Project Configurator

1. Abra el Project Configurator mediante su método preferido:

   • Abra Lumberyard Setup Assistant y, en la página Summary (Resumen), haga clic en Configure project (Configurar proyecto).

   • Abra la Lumberyard Project Configurator, ubicada en lumberyard-version\dev\Bin64BuildPlatform\ProjectConfigurator.exe. Por ejemplo, cuando se utiliza Visual Studio 2017 como plataforma de compilación, Project Configurator se encuentra en lumberyard-version\dev\Bin64vc141\ProjectConfigurator.exe.

2. En Project Configurator, haga clic en Create new (Crear nuevo).

   nota

   Si Create new (Crear nuevo) no está disponible, abra Lumberyard Setup Assistant y seleccione Compile the game code (Compilar el código del juego).

   En Lumberyard versión 1.23, si tiene la intención de crear nuevos proyectos, se deben seleccionar las siguientes opciones:

   • Ejecutar el proyecto de videojuego

   • : ejecutar la Lumberyard Editor y las herramientas: utilizar – para crear un juegoLumberyard Editor

   • Compilar el código del juego* –: compilar el código del juego para incluir los cambios que haya realizado.

   • : compilar la canalización de motores y recursos* : compilar el código del motor y la canalización de recursos para incluir los cambios que haya realizado.–

   • : compila Lumberyard Editor y las herramientas* –. Compile las herramientas de Lumberyard para incluir los cambios que haya realizado.

   *Si selecciona cualquiera de estas opciones, es posible que necesite realizar tareas adicionales, como instalar Microsoft Visual Studio. En caso afirmativo, estas tareas se muestran en las páginas Install software (Instalar software) y Required (Obligatorio)SDKs. Siga las instrucciones de Lumberyard Setup Assistant para obtener el software y las SDKs de terceros que no están instaladas.

   

3. En la ventana Create a new project (Crear nuevo proyecto), haga lo siguiente:

   1. Escriba un nombre para el proyecto.

      Solo se admiten caracteres alfanuméricos. No utilice caracteres especiales ni espacios en el nombre. No utilice palabras clave de C++ como if, while, break, new y virtual.

   2. Elija una de las siguientes opciones: : predeterminado o vacío.

   3. Haga clic en Create project (Crear proyecto).

   

4. Cuando el proyecto se haya creado, haga clic en Continue (Continuar).

5. En el Project Configurator, seleccione el nuevo proyecto y haga clic en Set as default (Establecer como predeterminado) para que sea el proyecto predeterminado que carga Lumberyard Editor.

6. (Opcional) Haga clic en Enable Gems (Habilitar gemas) para añadir gemas al proyecto.

   nota

   Si ha seleccionado las gemas Code & Assets, debe compilar el proyecto.

   1. En una línea de comando, vaya al directorio lumberyard_version\dev\.

   2. Para configurar Lumberyard, escriba el comando siguiente.

      lmbr_waf configure

   3. Cree el proyecto de juego.

      nota

      En Lumberyard versión 1.23, el tiempo de compilación inicial para un nuevo proyecto puede ser largo. Puede tardar aproximadamente una hora en sistemas de gama alta.

      Para obtener más información, consulte Compilación de proyectos deLumberyard.

7. Cierre Project Configurator.

8. Abra Lumberyard Editor, con su método preferido:

   • Abra Lumberyard Setup Assistant y, en la página Summary (Resumen), haga clic en Launch editor (Lanzar editor).

   • Inicie Editor.exe desde uno de los siguientes directorios:

     • Para Visual Studio 2017: lumberyard_version\dev\Bin64vc141

     • Para Visual Studio 2019: lumberyard_version\dev\Bin64vc142

Command Line

Al crear un proyecto de juego a partir de una línea de comandos, puede escribir lmbr para obtener una lista de todos los comandos que puede utilizar con Lmbr.exe.

Para crear un proyecto de juego desde una línea de comandos

1. En una ventana de línea de comandos, acceda al directorio siguiente:

   lumberyard_version\dev\Tools\LmbrSetup\Win\

2. Introduzca el siguiente comando para crear el proyecto.

   lmbr projects create MyNewProject

3. Para establecer el nuevo proyecto como predeterminado o como proyecto activo, introduzca el siguiente comando.

   lmbr projects set-active MyNewProject

4. Para configurar Lumberyard con el fin de que ejecute este proyecto, vaya al directorio siguiente: lumberyard_version\dev\

5. Escriba el siguiente comando.

   lmbr_waf configure

6. Cree el proyecto de juego.

   Para obtener más información, consulte Compilación de proyectos deLumberyard.

Elección de un proyecto de juego para abrir

Utilice el Project Configurator para establecer el proyecto de juego predeterminado que se abre en Lumberyard Editor.

Para abrir un proyecto de juego

1. Abra el Project Configurator mediante su método preferido:

   • En el escritorio, haga doble clic en el icono Project Configurator

   • Abra la Lumberyard Project Configurator, ubicada en lumberyard-version\dev\Bin64BuildPlatform\ProjectConfigurator.exe. Por ejemplo, cuando se utiliza Visual Studio 2017 como plataforma de compilación, el Project Configurator se encuentra en lumberyard-version\dev\Bin64vc141\ProjectConfigurator.exe.

2. En la página Summary (Resumen), seleccione el proyecto y haga clic en Set as default (Establecer como predeterminado).

   

3. (Opcional) Haga clic en Enable Gems (Habilitar gemas) y seleccione las características y los recursos adicionales que desea que estén disponibles al diseñar el juego. Si selecciona una gema etiquetada con Code & Assets, debe compilar el proyecto desde una línea de comandos.

   Para obtener más información, consulte Compilación de proyectos deLumberyard.

4. (Opcional) Elija Advanced Settings (Configuración avanzada) y verifique que los ajustes System entity (Entidad de sistema) y Memory (Memoria) sean apropiados para el proyecto.

5. Cierre Project Configurator.

6. Después de configurar el proyecto predeterminado, abra Lumberyard Editor mediante su método favorito:

   • En el escritorio, haga doble clic en el icono Lumberyard Editor

   • En Visual Studio 2017, vaya al directorio lumberyard_version\dev\Bin64vc141 y haga doble clic en Editor.exe.

   • En Visual Studio 2019, vaya al directorio lumberyard_version\dev\Bin64vc142 y haga doble clic en Editor.exe.

   Después del primer lanzamiento y cada vez que cambie los proyectos, el Asset Processor se ejecuta en segundo plano. Asset Processor administra sus archivos de recursos y proyectos. Puede ver mensajes que aparecen con información de estado mientras se abre Lumberyard Editor.

   Para obtener más información, consulte Uso Asset Processor.

Cambio de proyectos de juego

Para cambiar de proyecto, debe cerrar Lumberyard Editor. A continuación, con Project Configurator, puede especificar un proyecto diferente, junto con sus gemas y ajustes del sistema, para que lo abra el editor.

Al cambiar de proyecto, puede especificar lo siguiente:

• Nombre del proyecto que abrir

• (Opcional) Las gemas habilitadas para el proyecto

• (Opcional) Configuración del sistema del editor que se va a utilizar

Para cambiar de proyecto de juego

1. En Lumberyard Editor, elija File (Archivo), Project Settings (Configuración del proyecto) y Switch Projects (Cambiar de proyecto).

   

2. Debe cerrar Lumberyard Editor para poder abrir el Project Configurator. En el cuadro de diálogo, elija Save (Guardar).

3. Siga el procedimiento indicado en Elección de un proyecto de juego para abrir.