### [v4.2.0] - 2026.03.05

## Added

- New demo scene showcasing the implementation of multi-cell units

## Changed

- [performance] Use Vector3Impl, Vector3IntImpl and Vector2IntImpl directly instead of interfaces to reduce runtime allocations

- [performance] Use a dictionary for cell lookup in RegularCellController

- [performance] Replace LinkedList with List in pathfinding

- [performance] Provide sensible default sizes for collections in pathfinding

- [performance] Cache grid coordinates in Cell

- [performance] Cache hash in Cell

- [performance] Reconstruct paths dynamically instead of storing all in memory

- [performance] Use NoParam singleton to reduce allocations

## Fixed

- Add correct camera raycaster for 2D scenes in the Grid Helper

- Prevent assigning a scene object to Cell Prefab field in the Grid Helper

### [v4.1.0] - 2025.12.26

## Added

- New demo scene showcasing the implementation of unit deployment feature

- New demo scene showcasing the implementation of initiative-based turn progression

- Implemented an Erase function for UnitBrush and CellBrush

- Improved attack animations in Clash of Heroes demo

- Added missing game end conditions to Example 1

## Fixed

- Invoke UnitLeftCell and UnitEnteredCell with correct parameters

- Correctly deserialize MoveCommand and AttackCommand for online play

- Correctly calculate path cost in MoveCommand by using unit.GetMovementCost

- Fixed stale confirmation/target state when reselecting RelocateAbility

- Fixed incorrect path and cell highlighting when dehighlighting movement cells

- Removed invalid [SerializeField] attribute from a property in CaptureDefenceTargetEvaluator

### [v4.0.3] - 2025.10.29

## Added

- Optional visual Behaviour Tree editor (https://github.com/mzetkowski/tbsf-bteditor)

## Fixed

- Calculate path for the Charge ability in the Clash of Heroes demo correctly

- Visualize cell scores in the DebugMoveActionNode correctly

- Fix enabling Unit Painting Mode in the Grid Helper

### [v4.0.2] - 2025.09.30

## Fixed

- Serialize HexGridType in Hexagon.cs

- Calculate damage in AttackActionNode.cs correctly

- Calculate available destinations in unit pathfinding correctly

### [v4.0.1] - 2025.09.09

## Added

- NetworkException class

## Fixed

- Serialize CellDimensions in Square.cs and Hexagon.cs

- Correctly invoke Unit.UnitSelected and Unit.UnitDeselected events

- Unit colors in Example 1 demo scene

### [v4.0.0] - 2025.07.03

Note: This release is a complete rework of the Framework. Version 4.0.0 is not backward compatible with 3.x.

## Added

- Engine-agnostic core module (tbsf-common) shared between Unity and other engines

- New behaviour tree-based AI system

- Unified highlighter system for cells and units

- Tilemap-based map design with custom CellBrush

- New demo scenes showcasing mobile deployment and tilemap based maps

## Changed

- Decoupled Cell from MonoBehaviour - enables support for tilemaps, procedural generation, and non-GameObject-backed grids

### [v3.0.5] - 2024.11.07

## Changed

- Added support for Unity 6

- Replaced custom hash calculation with a built-in hash function in the `Cell` script for improved performance and maintainability.

## Fixed

- Fixed an issue in the `Tile Painter` tool where tile painting was not working.

### [v3.0.4]

## Changed

- Further pathfinding performance improvements

## Fixed

- Fixed unit movement animation by using local position instead of world position

- Fixed taking into account the virtual Unit.IsCellMoveableTo method when calculating unit available destinations

### [v3.0.3]

## Changed

- [performance] Make cell colliders triggers in Example1

- [performance] Disable shadow casting for hexagons in Example1

- [performance] Add initial capacity to data structures used by pathfinding

- [performance] Make PriorityQueueNode a readonly struct instead of a class

- [performance] Used strongly typed comparison to avoid type casting in PriorityQueueNode

## Fixed

- Fixed incorrectly assigned panel in NetworkGUI prefab

- Fixed offset coords to cube coords conversion method for odd-r and even-r grid layouts

### [v3.0.2]

## Added

- Added assembly definitions to samples

## Changed

- Made MyHexagon class public

- Made SampleSquare class public

- Made HealingBuff class public

- Made DefenceBuff class public

- Made CellGridStateWaitingForInput class public

- Made mouse event handler methods in Unit and Cell public

- Used MaterialPropertyBlock in RendererHighlighter and GlowHighlighter for better performance

- Replaced 'yield return 0' with 'yield return null' throughout the project for better performance

## Fixed

- Fixed a bug where movement path could be displayed incorrectly

### [v3.0.1]

## Added

- Extended the documentation with instructions for upgrading from v2.2 to v3

### [v3.0.0]

## Added

- Online multiplayer implementation

- Improved pathfinding performance

- Improved rendering performance in Example 1

## Changed

- Changed minimal supported Unity version to 2020.3.41f1

## Fixed

- Cell occupancy status not updating when deleting units in editor

Version 2.2

-Improved pathfinding performance

-Improved AI performance

-Added InitializeAction method to AIAction

-Added ReadGeneratorParams method to ICellGridGenerator

-Added GetGridInfo helper method to ICellGridGenerator

-Added KeepMainCamera flag to GridHelper to indicate if main camera should be re-generated

-Added ShouldStartGameImmediately flag to CellGrid to indicate if the game should start immediately on scene launch

-Added InitializeAndStart method to CellGrid to start the game manually

-Added execution time measurement to MoveToPositionAIAction and AttackAIAction

-Added AttackRangeHighlightAbility

-Modified TurnResolver to allow updating playable units mid-turn

-Fixed IsCellMovableTo usage in GetGraphEdges

-Fixed CellGrid.AddUnit method to properly add unit spawned on runtime to the game

-Fixed a bug where AI froze when there were no units on the map

-Fixed a bug where units were not highlighted when selected

-Fixed switching between actions in AI debug mode

-Fixed cell dimensions in Example1 and Example 5

-Fixed comments in SampleUnit

Version 2.1

-Added the Ability system

-Added the Turn Resolver system

-Added the Game Over Resolver system

-Added a new AI system

-Added CellGridStateAbilitySelected script

-Added a new demo scene

-[experimental] Added reusable cell highlighters

-[experimental] Added reusable unit highlighters

-Removed CellGridStateUnitSelected script

-Removed demo scenes 2 and 3 temporarily

-Modified grid generation - 2D maps will be generated along XY axis

-Modified grid generation - 3D maps will be generated along XZ axis with Y axis considered UP

-Modified the buff system - buffs are scriptable objects now

-Made NaiveAiPlayer script obsolete

Version 2.0.1

-Added Game state management chapter to project documentation

-Added compatibility with Unity 2020

-Merged CellGridStateAiTurn, CellGridStateGameOver and CellGridStateTurnChanging scripts into CellGridStateBlockInput script

-Removed package manager dependencies from the project

Version 2.0

-Added Tile Painter custom editor

-Added Unit Painter custom editor

-Added Prefab Helper custom editor

-Added CameraController script

-Added default value to MovementCost in Unit script

-Added default value to ActionPoints in Unit script

-Added default value to nHumanPlayers in GridHelper script

-Added OnMoveFinished method to Unit script

-Added CurrentUnit field to Cell script

-Added new example scene

-Added readme to example scenes

-Added namespaces to code

-Removed BreadthFirstSearch script

-Removed GreedyBestFirstSearch script

-Removed ListPriorityQueue script

-Removed CustomObstacleGenerator script

-Modified folder structure of the project for easier navigation

-Changed MovementCost type to float

-Changed ActionPoints type to float

-Changed MovementSpeed to MovementAnimationSpeed

-Changed MovementPoints to be accessible with getter

-Changed ActionPoints to be accessible with getter

-Maintaining cell prefab link when generating map

-Centering camera on generated grid

-Cell prefab is in XY plane now

-Split DealDamage into AttackHandler, DealDamage and AttackActionPerformed methods

-Split Defend into DefenceHandler, Defend and DefenceActionPerformed methods

Version 1.1.2

-Added FAQ

-Added forum thread at https://forum.unity.com/threads/turn-based-strategy-framework.704129/

-Removed obsolete code for loading scenes

-Fixed a bug in AddUnit method where unit was not added to Unit list

-Fixed a bug in GUIController where pressing 'n' multiple times could interrupt AI turn

-Fixed layers in ExampleScene4

-Fixed GUI elements in ExampleScene5

Version 1.1.1

-Added information about names of missing parameters in Grid Helper.

-Fixed a bug where Grid Helper faultily displayed information about missing parameters.

-Fixed a bug where unreachable cells might have been highlighted as reachable.

Version 1.1

-Improved pathfinding performance.

-Improved CellGridStateUnitSelected performance.

-Added Grid Helper inspector that facilitates the process of generating basic scene structure.

-Added Initialize method to CellGrid.

-Added UnitAdded event to CellGrid.

-Modified grid generation - generating grids across XZ plane.

-Modified the Hexagon prefab that can be found in Prefabs/Example1 folder. The new prefab consists of a single hexagon mesh instead of six cubes.

-Revised and upgraded comments on the code.

-Updated the documentation to reflect changes made in this release.

Turn Based Strategy Framework