Difference between revisions of "AI grid panel"

Revision as of 17:04, 1 August 2017

Overview

_{All 3 tabs of the AI Grid Panel}

The AI Grid Panel is a panel that allows you to interact with the AI Grid. The panel has 5 major features:

• The Header, which features saving/loading, a toggle to set automatic reloading of the AI Grid on leaving Game Mode and 3 Interaction Modes
• Generating the AI Grid, which allows you to regenerate grids (AI Grid, Vision Grid and Material Grid) after making changes to your level or placing AI Seeders
• Painting Movement, which allows you to modify the automatically generated AI Grid with one of the AI Grid paint interaction modes
• Painting Surfaces, which allows you to paint Surfaces on the AI Grid using one of the AI Grid paint Interaction Modes
• The Show Grid Options, which can be configured to visualize different grids in your game view

Using the AI Grid Panel

_{The menu item that opens the AI Grid Panel}

To open up the AI Grid Panel, click the "AI Grid" Menu item in the menu bar.

The Header

_{The Save/Load options}

The save and load buttons on the AI Grid Panel will save/load the AI Grid, the Material Grid and the Vision Grid. When loading, you will be prompted to save first if there are any unsaved changes. If you choose not to save, any changes made will be discarded.

_{The auto reload toggle}

The auto reload option sets whether or not the AI grids will automatically be reloaded after exiting game mode.
If this option is checked, any in-game changes to the AI grid (e.g. surfaces from spells cast) will be undone upon exiting game mode.
If this option is not checked, changes made in-game will remain after leaving the game mode, but it will not be possible to modify the AI grid in editor mode without reloading the AI grid first.

_{The interaction mode toggles}

The interaction mode toggles are used to activate their respective interaction modes and are only enabled if the current tab uses that interaction mode.

The Generate Tab

_{The generate tab}

The Generate tab has 2 major features:

• Partial generation of one or more selected grids within the selected area (see the AI Select Interaction Mode)
• Full generation of one or more selected grids

The Paint Movement Tab

_{The paint movement tab}

The Paint Movement tab together with either the paint circle or paint square interaction mode can be used to manually modify the walkable areas of your level.

To change which areas are walkable:

1. Select which AI Grid layer you want to modify (either the movement layer for characters or the projectile layer for projectiles)
2. Select whether you want an area to be walkable (Allow) or not walkable (Block)
3. Select which interaction mode you want to use (round or square brush)
4. Begin painting! ^[1]

^{[1] An AI Grid regeneration is not needed after changing the walkable tiles}

When painting movement, the grid visualization automatically switches to visualize the AI Grid with the corresponding movement layer checked. To disable this, simply scroll down the "Opacity" slider to 0.

The Paint Surfaces Tab

_{The paint surfaces tab}

The Paint Surfaces tab together with either the paint circle or paint square interaction mode can be used to paint surfaces in your level.

To paint surfaces in your level:

1. Select which layer you want to paint (Ground or Cloud)
2. Select which surfaces you want to paint (e.g. Water, Fire, Poison) ^{[1] [2]}
3. Select whether you want the surface to be Cursed, Blessed or neither
4. Select whether you want the surface to be Frozen, Electrified or neither
5. Begin painting! ^[3]

^{[1] Surface combinations that are not possible for your current selection are automatically greyed out, a list of all possible surface combinations can be found on the Surfaces page
[2] The "Irreplaceable" surface can be used to paint an area where no surfaces can occur during the game
[3] An AI Grid regeneration is not needed after painting surfaces}

When painting surfaces, the grid visualization automatically switches to visualize the AI Grid with Surfaces checked. To disable this, simply scroll down the "Opacity" slider to 0.

The Show Grid Options

_{All the grid visualization options}

The Show Grid Options allow you to modify how the AI Grid is visualized in the editor's game render view. There are 4 major options for visualizing the AI Grid:

• Turn off grid visualization (None)
• Visualizing the AI Grid (AI) ^[1]
• Visualizing the Vision Grid (Vision)
• Visualizing the Material Grid (Material)

All visualization options share the "Opacity" and "View Distance^[2]" sliders.

^{[1] The AI Grid visualization has extra options as it is multi-layered and customizable
[2] The View Distance slider determines the distance to which the grid is visualized}

Show AI Grid

_{Visualizing the AI Grid}

The AI Grid visualization has the following additional options which appear above the "Show Grid" box:

• Global
  • Merged: shows the merged grid when checked
  • Generated: shows the generated grid when checked
• Type
  • Movement: shows the movement layer when checked
  • Projectile: shows the projectile layer when checked
• Layers
  • Painted layer: shows all the painted changes to movement when checked
  • Surfaces layer: shows all the painted changes to surfaces when checked
  • Dynamics layer: shows all the dynamic changes to movement (caused by non-static entities' AI Bounds) when checked

The AI Grid movement layer visualization is color coded as follows:

• Grass Green: tile is moveable (generated layer)
• Sky Blue: Tile is blocked (generated layer)
• Green: tile is moveable (merged layer)
• Red: tile is blocked (merged layer)
• Bright Green: Tile is painted moveable
• Purple: Tile is painted blocked
• Yellow: Tile is blocked by a character's AI bounds
• Pink: Tile is blocked by an item's AI bounds
• Other: Tile is colored by a surface

The AI Grid projectile layer visualization is color coded the same as the movement layer with the following exceptions:

• Oak: tile is moveable (merged layer)
• Beige: tile is blocked (merged layer)

Show Vision Grid

_{Visualizing the Vision Grid at 80% opacity}

The Vision Grid visualization is color coded as follows:

• Grey: vision blocked (generated)
• White: vision is blocked by a static object
• Purple: vision is blocked by a see-through static object
• Blue: vision is blocked by a dynamic entity's AI bounds

Show Material Grid

_{Visualizing the Material Grid at 50% opacity}

The Material Grid visualization is color coded as follows:

• #FF00FF Unassigned
• #FAC800 Sand
• #6B452B Dirt
• #509E23 Grass
• #4B5557 Metal
• #B85E2E Wood
• #483896 Stone
• #A678C2 Pebbles
• #55DCE6 Puddle
• #BAFAFF Ice
• #D4F7FA Snow
• #43691A Ooze
• #F74A05 Fire
• #702252 Cloth
• #C4C92A Leaves
• #1C1717 Oil
• #FF0000 Blood
• #6062BA Water
• #D17373 Flesh
• #E3E08A Bone
• #5B1F73 Shadow
• #FCA9B5 Ghost
• #BA5438 Leather
• #FF4000 Lava
• #80FF80 Earth
• #F0F0FF Air
• #F0F0FF Rug
• #00FFDD Glass
• #265D00 Forest
• #BA5D00 Wood_Creaky
• #C8C8C8 BoneMail
• #808080 ChainMail
• #9C9C9C PlateMail
• #5B3512 ElvenArmor
• #84720E ScaleMail

The Interaction Modes

_{The interaction mode toggles}

The AI Grid Panel features 3 Interaction Modes:

• The AI Select interaction mode, which allows you to select cells on the AI Grid for a partial regenerate of the AI Grid
• The Paint Circle interaction mode, which allows you to paint movement or surfaces with a round brush
• The Paint Square interaction mode, which allows you to paint movement or surfaces with a square brush

The AI Select Interaction Mode

_{Step-by-step guide showing how to use the AI Select Interaction Mode}

The AI Paint Square Interaction Mode

_{Using the paint square interaction mode to block movement on the AI Grid}

As with every other interaction mode brush, the paint square interaction mode's brush can be scaled down with the '[' key and scaled up with the ']' key.

The AI Paint Circle Interaction Mode

_{Using the paint circle interaction mode to block movement on the AI Grid}

As with every other interaction mode brush, the paint circle interaction mode's brush can be scaled down with the '[' key and scaled up with the ']' key.