Lumberyard Release Notes – Beta 1.19 (June 2019)

Lumberyard Beta 1.19 adds over 150 new features, improvements, and fixes. As we continue to improve Lumberyard, we want to thank everyone in our community whose suggestions help us make a better product every release. Since the initial launch, we’ve overhauled over 50% of the original code base, and we’re still just getting started. Keep sending feedback to our forums as well as lumberyard-feedback@amazon.com. For the latest Lumberyard updates, follow us on Twitter, Facebook, and our blog.

Topics

Highlights
Here’s a sampling of the new features found in Lumberyard 1.19.

Topics

Dynamic Vegetation
Lumberyard 1.19 introduces a new component-entity–based system for authoring procedurally placed vegetation. The vegetation can be loaded and instantiated dynamically and will spawn and despawn as the player moves through the world. You can use the new components to place vegetation assets and customize how they appear. This enables you to create different environments for your game for worlds of any size.

This feature adds the following benefits:

  • Customize vegetation to fit specific areas of your environment and configure vegetation to grow only on specific surfaces
  • Create complex biomes in one nested slice to apply changes across areas of an entire world
  • Quickly iterate your vegetation settings to preview how your changes appear in your game

To enable dynamic vegetation, you must enable the following gem:

  • Vegetation – Provides the dynamic vegetation system and core vegetation components
    The dynamic vegetation system uses the gradient and surface data systems. This gives you more control over where you can place dynamic vegetation in the world.

Gradients
You can use the gradient components to provide curated, controlled, or procedural data that can be sampled at any world space position. For example, you can use the gradient components with dynamic vegetation to randomize the placement of vegetation.

To enable gradients, you must enable the following gems:

  • Gradient Signal – Provides gradient and gradient modifier components to create realistic vegetation
  • Fast Noise Gradient – Provides a FastNoise Gradient component to generate procedural noise variations for vegetation

Surface Data
You can use the surface data components to query any world position and return a list of surface tags (for example, water, terrain, road, dirt, grass) that an entity emits at the location. For example, you can create a river entity and attach a surface tag emitter component to it. Using dynamic vegetation, you can specify the types of vegetation that can and can’t appear in a river.

To enable surface data, you must enable the following gem:

For more information, see Dynamic Vegetation in the Amazon Lumberyard User Guide.

Script Canvas
Lumberyard 1.19 introduces the following features.

Creating a Chain of Linked Nodes
You can quickly add nodes in succession to a graph by using the chaining feature. Script Canvas automatically links the pins on each new node to the previous node.

For more information, see Adding and Connecting Nodes in the Amazon Lumberyard User Guide.

Grouping Nodes
You can group your nodes to organize parts of a script and reduce its visual complexity. You can also name, nest, color-code, and expand and collapse node groups.

For more information, see Grouping Nodes in the Amazon Lumberyard User Guide.

Container Support
Script Canvas now supports arrays and maps, including supporting nodes for accessing data in containers. You can use arrays to provide a dynamic continuous area of memory that can hold storage of a given type.

8665-shared-script-canvas-containers-2.png

You can use maps to create containers of key/value pairs.

8666-shared-script-canvas-containers-12.png

For more information, see Using Containers (Arrays and Maps) in the Amazon Lumberyard User Guide.

Node Alignment Tools

In your Script Canvas graphs, you can align selected nodes relative to each other (top, left, bottom, and right).

Script Events

Script Events are a robust, data-driven mechanism for creating cross-script events. You can create events to use in Lua and Script Canvas. You can send events from one script to another. To use Script Events, you must enable the Script Events gem in Project Configurator.

Script Canvas Debugger

Script Canvas now features a runtime debugger. The debugger allows Script Canvas to connect to the game and collect runtime information about graphs. You can run the debugger in the editor or in a standalone launcher.

Unit Test Manager

Support for Script Canvas unit testing has been improved, including a new Script Canvas Testing gem. You can enable this gem for your game project to test Script Canvas and its features. The Unit Test Manager quickly runs unit tests to determine if they pass or fail.

Script Canvas Statistics (Preview)

Script Canvas now provides a way to gain insight into the use of Script Canvas nodes. You can use the Statistics dialog to track and locate node usage across an entire project’s collection of Script Canvas graphs. This feature helps you better understand the use cases of various nodes and the cost of refactoring or changing functionality.

For more information, see Creating Gameplay with Script Canvas in the Amazon Lumberyard User Guide.

New Viewport Interaction Model
You can enable the new Viewport Interaction Model feature in Lumberyard Editor. This experimental feature is designed to make editing your entities simpler and more intuitive in Lumberyard.

This feature includes the following improvements:

  • Interacts with entities using manipulators instead of gizmos
  • Adds support for new translation and rotation manipulators
  • Uses a single aggregate manipulator to edit multiple entities at once
  • Simplifies your selection when switching between parent or world space
  • Moves the manipulator independent of your selection
  • Adds support for ditto operations for working with manipulators and entities
  • Enables you to quickly switch between translation and rotation manipulators
    You can enable this feature from the Preferences window in Lumberyard Editor.

Note

This feature is experimental and is subject to change. It doesn’t support the following:

  • Vertex snapping
  • The Terrain Editor and Track View editor
  • Legacy entities (such as terrain and vegetation)
  • Partial support for the Material Editor
    8673-viewport-selection-model-7-2.gif

For more information, see Working with the Viewport Interaction Model in the Amazon Lumberyard User Guide.

Editing Components in the Viewport
In the Entity Inspector, you can now choose the Edit button for select components. All other components attached to the entity can’t be edited. This feature prevents you from accidentally editing other components attached to the entity and makes it easier to edit your components freely in the viewport.

8667-using-component-mode-4.png

You can use this feature to do the following:

  • Enter a sandbox to edit only the selected component properties
  • Customize shortcuts for your components
  • Use manipulators to make editing visual data more intuitive
  • Build your own Component Mode for other components
    For more information, see Editing Components in the Viewport in the Amazon Lumberyard User Guide.