Lumberyard
Guía del usuario (Version 1.21)

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 el 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

  • Gema LyShine: ofrece 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: ofrece nodos de gráfico de flujo para usar este servicio y crear sesiones de juego

  • Camera: 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 características de scripting visual para potenciar su backend de juegos con servicios de AWS

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

  • Http Requestor: añade soporte para administrar solicitudes de HTTP y HTTPs

  • In-App Purchases: aporta 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: ofrece 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) (heredado): ofrece modificadores de entidades físicas para simular eventos físicos

  • Primitive Assets: ofrece 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 ConfiguratorCommand Line
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).

    • Vaya al directorio lumberyard_version\dev\Tools\LmbrSetup\Win\ y haga doble clic en Project Configurator.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).

    
                                    Crear un nuevo proyecto de juego con Project Configurator y Lumberyard Setup Assistant.
  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: Default (Predeterminada) o Empty (Vacía).

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

    
                                    Creación de un nuevo proyecto en el Project Configurator.
  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.

      Para obtener más información, consulte Compilación del proyecto de juego.

  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 2015: lumberyard_version\dev\Bin64vc140

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 del proyecto de juego.

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

    • Vaya al directorio lumberyard_version\dev\Tools\LmbrSetup\Win y haga doble clic en Project Configurator.exe

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

    
                        Elección de un nuevo proyecto predeterminado en el Project Configurator.
  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 del proyecto de juego.

  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 2015, vaya al directorio lumberyard_version\dev\Bin64vc140 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 de 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).

    
                        Opción Switch Projects (Cambiar de proyecto) en el submenú Project Settings (Configuración del proyecto) del menú File (Archivo) en Lumberyard Editor
  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.