The battle grid settings handle most of the grid battle features, e.g. which grid type is used or grid actions like the grid move command.
Battle grid settings are found in Battles > Battle Grid Settings.
Grid battles are available in all battle system types when using a Battle component (i.e. also when started from the auto start battles, e.g. when running into an enemy spawned by a Combatant Spawner component). Grid battles allow creating a tactical battle system in your game – best suited for Turn Based or Phase battles.
When using a battle grid in a battle, the combatants will be placed on the grid and are able to move on it. Battle ranges (e.g. used by ability/item use range and affect range) can be defined by individual grid shapes, e.g. a line of 3 cells in front of the user, and will be highlighted on the grid (e.g. showing which cells are within use range of an ability).
Battle grids are added to scenes using Battle Grid components. Battle components can be set up to use the nearest grid or a defined grid (or none at all).
Base Settings #
Define the basic settings of battle grids.
Grid Type #
There are 2 different types of grids available – square and hexagonal grids. Hexagonal grids can be used in 4 different modes (horizontal even/odd, vertical even/odd).
The cell size and cell offset settings are used when setting up a grid in your scenes to calculate the positions for the individual grid cells.
Square Grids #
Square grids create a chessboard-like grid in the scene. A cell in the grid has 4 edges and 4 corners.
Combatants can move horizontally and vertically, optionally you can also allow diagonal movement – i.e. combatants can either move in 4 or in 8 directions.
Hexagonal Grids #
Hexagonal grids create a more complex grid in the scene. There are different types of hexagonal grids available – in general, every 2nd row or column in the grid will be offset. A cell in the grid has 6 edges and 6 corners.
Depending on the used type, movement is availalble diagonally and either horizontally or vertically – i.e. combatants can move in 6 directions.
Horizontal Even
A horizontal even hexagonal grid uses hexagonal cells with a pointy top. Every even row is offset, i.e. row 0 (1st row), row 2, row 4, etc.
Being horizontally aligned, movement is available horizontally and diagonally.
Horizontal Odd
A horizontal odd hexagonal grid uses cells with a pointy top. Every odd row is offset, i.e. row 1, row 3, row 5, etc.
Being horizontally aligned, movement is available horizontally and diagonally.
Vertical Even
A vertical even hexagonal grid uses cells with a flat top. Every even column is offset, i.e. column 0 (1st column), column 2, column 4, etc.
Being vertically aligned, movement is available vertically and diagonally.
Vertical Odd
A vertical odd hexagonal grid uses cells with a flat top. Every odd column is offset, i.e. column 1, column 3, column 5, etc.
Being vertically aligned, movement is available vertically and diagonally.
Raycast Settings #
The raycast settings are used for finding the ground or cells in your scene – both when setting up the grid and during gameplay (e.g. to find the nearest cell below the cursor for a cell selection).
Cell Occupation Settings #
Cells can either have a Single Occupant or allow multiple occupants.
When using multiple occupants, you can define the maximum number of player/ally and enemy combatants on a cell. Battle Grid Cell Positions components can be used on grid cell prefabs to define the positions on a cell for multiple occupants. In grid move schematics, use Select Grid Cell Position nodes to get the position game object for a combatant and use it as target for your movement.
Cell Selection #
Define the how cells can be selected (e.g. to select a target cell for the move command).
Individual commands using cell selections can override this with a custom setup.
Input Key Settings #
You can use input keys to select a cell (e.g. as target for the move command).
The input keys are used to navigate on the grid.
Mouse/Touch Control #
Input settings for mouse and touch control.
Clicking/touching will use the raycast settings defined in the base settings to find the nearest cell.
Audio Settings #
Define audio clips that will be played during cell selections, e.g. for selecting and accepting cells.
Orientation Selection #
Define the how the orientation of a combatant can be selected.
This is only used by player combatants when either using the grid orientation command (e.g. via battle menu or shortcut) or in schematics using the Grid Orientation Selection node.
AI controlled combatants will only use the Block Diagonal Rotation setting (in Square grids) and otherwise rotate based on their AI settings, e.g. to the nearest target.
Content Information #
Define the content type, name, description, icon and custom content of the orientation command.
This is e.g. used when showing action notifications or when using the orientation command as a shortcut.
Camera Control Target #
Optionally change the camera control target to the selected cell during the cell selection.
The camera control must derive from the BaseCameraControl class (like all built-in camera controls).
Info Text #
Optionally display an info text box while the player selects a target cell.
The content can use text codes to add the selecting combatant’s content information (e.g. name).
Accept Question Dialogue #
Optionally display an accept question dialogue to ask if the player wants to use the accepted cell.
Cell Selection #
Optionally override the default cell selection settings.
Cell Selection Schematics #
Optionally use schematics when selecting a valid or invalid cell for movement, or when accepting or canceling cell selection.
This can be used to implement custom features.
Combatant Placement #
Define the settings for the player’s combatant placement on the grid. This can e.g. be used in a battle start schematic to let the player select the cells for the combatants participating in battle.
The combatant placement can either place the battle group members or allow the player to select from all available members, defining the battle group that’ll be used. The combatants can either be selected using a combatant selection or placed in a predefined order (based on a sorting setting).
Optionally also select the orientation of the placed combatants (see orientation selection settings above).
Camera Control Target #
Optionally change the camera control target to the selected cell during the cell selection.
The camera control must derive from the BaseCameraControl class (like all built-in camera controls).
Info Text #
Optionally display an info text box while the player selects a target cell.
The content can use text codes to add the selecting combatant’s content information (e.g. name).
Accept Question Dialogue #
Optionally display an accept question dialogue to ask if the player wants to use the accepted cell.
Cell Selection #
Optionally override the default cell selection settings.
Cell Selection Schematics #
Optionally use schematics when selecting a valid or invalid cell for movement, or when accepting or canceling cell selection.
This can be used to implement custom features.
Move Command #
The move command handles a combatant’s movement on the battle grid.
Using the move command can optionally be limited to once per turn and allow diagonal movement (in Square grids).
Content Information #
Define the content type, name, description, icon and custom content of the move command.
This is e.g. used when showing action notifications or when using the move command as a shortcut.
Pathfinding Settings #
Define how pathfinding on a grid will work.
E.g. prioritize the shortest path, allow moving over allies or enemies, etc.
Move Range/Cost #
Define the default move range and optionally define a status value that can be used as an additional move cost. Battle grid cell types will set up the actual move cost of a cell.
Camera Control Target #
Optionally change the camera control target to the selected cell during the cell selection.
The camera control must derive from the BaseCameraControl class (like all built-in camera controls).
Limit Height Movement #
Optionally limit movement to a maximum height distance for upward and downward distances.
E.g. only allow moving upward movement for low height distances (e.g. 0.3).
Waypoint Settings #
Optionally allow setting waypoints during grid move path selection.
Default Battle Animation #
Define the default schematics used to animate the grid move command.
The schematic is used to move the combatant from cell to cell and use cell events on those cells. Use the Store Grid Path node to get individual cells (or the whole path) for movement. The Grid Cell Event node can be used to start cell events.
Combatants can individually override the battle animation.
Info Text #
Optionally display an info text box while the player selects a target cell.
The content can use text codes to add the selecting combatant’s content information (e.g. name) and information about the cell, move/action costs and move range changes.
Accept Question Dialogue #
Optionally display an accept question dialogue to ask if the player wants to use the accepted cell.
Cell Selection #
Optionally override the default cell selection settings.
Cell Selection Schematics #
Optionally use schematics when selecting a valid or invalid cell for movement, or when accepting or canceling cell selection.
This can be used for advanced features, e.g. previewing the movement along the path to the selected cell.
Potential Attacks Highlights #
Optionally highlight enemies that can attack when moving to a selected cell.
Target Cell Selection #
Define the settings for the target cell selection of abilities and items that target a grid cell.
Abilities/items can target a grid cell by using the None target range and enabling Select Target Cell.
Camera Control Target #
Optionally change the camera control target to the selected cell during the cell selection.
The camera control must derive from the BaseCameraControl class (like all built-in camera controls).
Info Text #
Optionally display an info text box while the player selects a target cell.
The content can use text codes to add the selecting combatant’s content information (e.g. name) and used action’s content information.
Accept Question Dialogue #
Optionally display an accept question dialogue to ask if the player wants to use the accepted cell.
Cell Selection #
Optionally override the default cell selection settings.
Cell Selection Schematics #
Optionally use schematics when selecting a valid or invalid cell for movement, or when accepting or canceling cell selection.
This can be used to implement custom features.
Examine Grid #
Define how examining the grid is handled and displayed.
The player can examine cells on the battle grid and combatants placed on the cells through the Grid Examine command (e.g. via the battle menu or shortcuts). Examining the grid can also be set to be always active.
Content Information #
Define the content type, name, description, icon and custom content of the examine command.
This is e.g. used when showing action notifications or when using the examine command as a shortcut.
Camera Control Target #
Optionally change the camera control target to the selected cell during the cell selection.
The camera control must derive from the BaseCameraControl class (like all built-in camera controls).
Info Text #
Optionally display an info text box while the player selects a target cell.
The content can use text codes to add the selecting combatant’s content information (e.g. name) and the examined cell’s information.
Cell Selection #
Optionally override the default cell selection settings.
Cell Selection Schematics #
Optionally use schematics when selecting a valid or invalid cell for movement, or when accepting or canceling cell selection.
This can be used to implement custom features.
Cell Info Texts #
Similar to the info text, but allows setting up multiple cell info text boxes.
Cell info text boxes can be set up for different cell states, e.g. showing different content for empty or occupied cells.
They can optionally be toggled on/off via input keys.
Combatant Information #
Define the information about a combatant of an examined cell that will be displayed
Selecting a cell with a combatant can highlight the combatant’s move range or attack range (use range of the combatant’s base attack).
Additionally, you can add combatant info boxes, displaying combatant information in a UI box. You can add multiple boxes, e.g. displaying different content for player or enemy combatants. Add the combatant’s content informatoin via text codes and use a HUD as template to add more complex information and layout (e.g. value bars).