1.9.2

ADDED

  • Undo/Redo
    build, replace and demolish are captured when IUndoRedoStack is present in scene
    building state is captured in action and restored when it is re-added
    stack is persisted and consistent across save/load
    fires event with all affected points used for visualization
    see playground scenes, defense, urban, three demos
  • more visual examples for build, demolish, selection
    arise, drop, appear, dissolve, particles (see new tools in BuildingPlayground3D)
    scaling animated selection border (see BuildingPlayground3D/Terrain/Expandable)
  • BuildingPlaygroundZones shows how structures can be used as zones

IMPROVED

  • partial expandable rework
    ExpandableBuilder behaviour redone, new options for rotation, minsize
    new IExpandableVisual interface allows different visual implementations
    alternate expandable visual implementation called ExpandableVisualCapped
    see new BuildingPlaygroundExpandable test scene
  • height mapped building grid and overlays
    see GridVisual and Overlays in DebugTerrain scene in Three demo
  • additional particles and animations in urban demo
  • ‘Rotate’ option in building addons allows applying rotation from building

CHANGED

  • assets in urban demo are new also prefixed with ‘urban’
  • id is moved over to new building in replacement
  • ui scaling adjusted in some demos
  • BuildingAddonTransformer now also transforms position
    settings to change if it resets and whether to hide initially

FIXED

  • error when renderer was removed while building was highlighted
  • navmesh not updating properly on repeat loads in town demo

1.9.1

ADDED

  • StructureTerrainTreeVariants manages multiple tree prototypes in one structure
    can be tested using the ‘Red’ and ‘Blu’ tools in BuildingPlaygroundTerrain
  • StructureReplacer tool to replace points in one structure with another
    can be tested using the ‘RToB’ and ‘BToR’ tools in BuildingPlaygroundTerrain
  • WalkerCategory holds collections of walkers for use in scores or road blocking
  • WalkerScore returns the active number of walkers of a certain type or category

IMPROVED

  • SelectionTool now allows configuring selection methods and filters
    select whether selecting buildings and walkers uses raycasts or points selection
    also filters and masks to define which buildings and walkers are selectable
  • DefaultGameManager.StartedDebug for when the game is started with debug mission
  • IStructure.ReplacePoints additional parameters keepRandomization and keepVariant

CHANGED

  • NavMeshes in Town demo are no longer baked in debug and testing scenes
    they are now generated at start like in regular stages
  • DefaultGameManager now has very early execution order
    previously Started event fired after structure initialization
    this caused a bug in town demo when the hill stage was started directly

FIXED

  • ExpandableVisual did not take CellOffset into account

1.9.0

ADDED

  • Terrain variant of Three demo that uses Terrain for its ground
  • Hybrid variant of Town demo with regular models instead of terrain trees
    • TownPlainsHybrid mission selectable from the Title
    • new tree and berry bush models
  • About Button in SceneView that shows short description in most scenes
  • HeightMapped(Graph) shader and HeightMappedRenderer component
    moves vertices according to heightmap, can show tilemaps like roads on top of terrain
    used in Three DebugTerrain scene and BuildingPlaygroundTerrainTilemap
  • StructureCollectionFloat that saves full position instead of just map point

IMPROVED

  • Agent walking with (stopping)distance
    usable with the new WalkAgentAction, new field in town harvest and item tasks
    stops town walkers in front of trees and items instead of inside them
  • Place structures and buildings by just clicking on the map
    click StartPlacing in the inspector of various components to start StructureCollection(Float), StructureDecorators, DefaultBuildingManager
  • show storage capacity and missing construction items in town building panel
  • activate navmesh obstacle in town construction after ground is cleared
  • ObjectGenerator places prefabs in Edit mode instead of instances
  • apply height to Wanderer, StructureCollection, StructureDecorators
  • apply height to NavMesh destinations and agent walking
  • TerrainMap visualizes Min- and MaxHeight
  • moved sprite and model variants of Three roads into different palettes
  • better URP material upgradability
  • debugger step through getting dependencies
  • better handling of missing mouse position(throws error in unity 6)

CHANGED

  • Negative ExecutionOrder for Maps, ObjectSet and Structures
    structures can now reliably be retrieved by key in start
    map features like grid position can be used in Awake
  • Addons are always placed in Pivot position, Center field removed
  • Building WorldCenter returns Pivot position including height
  • DefaultMapHeight set global position instead of localposition
  • apply Building height in Start instead of Initialize
  • renamed others folder to playgrounds
  • renamed remaining vector2int variables from position to point
  • added prefix to remaining defense assets
  • moved overlay material to core, cleaned up different materials in other projects
  • moved town border and light into setup prefab

1.8.8

ADDED

  • PathQueries
    request simple walking paths as well as receiver, giver and worker paths as a query these queries can be completed later allowing a better distribution of workload
  • BurstPathfinding
    pathfinding method can be switched between regular and job based burst pathfinding this is done on the new pathfinding options on Road and Structure Managers
  • InitializationMode
    new options on spawners of delivery, worker and retriever walkers
    allows choosing if a path is calculated before or after spawning

IMPROVED

  • Performance
    items storage, dependency caching, less linq in hot paths, migration, layer modifier, …
  • Unity 6 Compatibility
    obsolete methods replaced by new variants

CHANGED

  • Package Dependencies
    dependencies on burst, tilemap, textmeshpro are included explicitly in the package

FIXED

  • exception in urban tunnel scene
  • migration speed calculation
  • monument using item on wrong stage
  • wrong tiles assigned in three roads

1.8.7

ADDED

  • MoveTool
    allows moving and rotating one or more buildings and structures
    IsMovable field added to BuildingInfo and different structure components
    tool added in sidebar in various scenes, move button added to three building dialog
  • ConnectionPlayground(CityBuilderCore.Tests/Other)
    playground scene that allows trying out Connection system on its own
    also check out the new Connections manual page which explains connection fundamentals
  • ConnectionFeederBuilder
    special building builder that shows preview of connection
    used in playground and urban demo power station
  • LayerPlayground(CityBuilderCore.Tests/Other)
    playground scene that allows trying out Layer system on its own
  • LayerBuildingBuilder
    special building builder that previews layer values by highlighting or tilemap
    used in playground(LayerPreview tilemap) and on three demo gardens(highlighting)
  • SelectionSwitcher
    allows switching through buildings and walkers of the same type from dialogs
    using in three and town demos(special variant in town demo that switches by job)

IMPROVED

  • HelpUrl
    clicking the ? button on an AAK behaviour will now open the API documentation
  • ConnectionPasserStructure now allows specifying structure by Key
    this allows passing connections through roads as shown in the connection playground
  • ViewLayer now also visualizes points with 0 value if they are affected by something
    avoids strange looking gaps in the overlay when layer value adds up to 0 between affectors

CHANGED

  • tool cancellation no longer bound to framerate
  • selection tool needs full click instead of just mouse up
  • DefaultStructureManager subscribes to PointsChanged for every type of structure
  • CheckBuildingRequirements renamed to CheckRequirements
    and split into CheckBuildingRequirements and CheckRoadRequirements

FIXED

  • height calculation for ghosts different from placed buildings
  • urban power lines did not refresh connections on destroy

1.8.6

IMPROVED

  • default highlight manager can highlight tiles with colors(mouse over highlights)
  • meta save data is deleted with the regular save data
  • rotating the camera with RMB does not cancel tools(click held longer than 0.1s)
  • highlights and layer keys are not shown when mouse is outside map
  • building and walker addon queue is now also persisted
  • canceling of roaming and walking
    cancellation is stored in walking state leaving walking path mostly stateless and reusable walking by method or process and cancelling can be tested in MovementPlaygroundGrid
  • additional xml documentation in code

FIXED

  • copy and deleted buttons in editor dialogs too small in newer unity versions
  • bug when saving the game in town demo before placing the initial building

1.8.5

ADDED

  • WalkerAddons
    reusable piece of logic that can be added to walkers very similarly to BuildingAddons
    BuildingAddon has also received some improvements to keep in line with this addition
    • Save field that sets whether an addon is persisted and recreated on load
    • Accumulation field sets what happens when an addon is added more than once
    • Walker/BuildingAddonHappening that adds addons when active(epidemic in three)
  • Slower building in the defense demo
    applies slow addon to attackers which slows them and shows a blue capsule

IMPROVED

  • SelectionTool visualizes hovered point, walker or building in town and three demos
    highlighting used to visualize points, walkers and buildings by using addons
  • SelectionDialog and town dialogs visualize selected walkers and buildings
  • CameraController can pan, zoom, rotate and pitch on both mouse buttons
    MiddleMouseButton: default>pan shift>rotate&pitch alt>zoom
    RightMouseButton: default>rotate&pitch shift>zoom alt>pan
  • ItemStore can be persisted by one of the connected storages
    see StorageDebugging for an example of two storages using the same ItemStore
  • additional test for town demo that tests home provisioning
  • switch between walkers and their home in town dialogs
  • stacked storages can reserve capacity
  • additional custom editors
    • trigger timing happenings(epidemic, rain, …)
    • town walker editor
    • storages show reservations

FIXED

  • task cancellation on walker death in town demo
  • ItemStorage MoveItemsTo correctly returns the moved quantity
  • town demo building dialog error in empty homes

1.8.4

ADDED

  • Sounds
    Town demo now has UI sounds, an atmospheric background track and various sounds for tasks like harvesting stone or chopping wood
    • AudioPool to play sounds like button clicks from a central component
    • AudioSlider that sets and persists volume levels
  • MissionSelector
    example scene that demonstrates an alternate setup for a menu screen(CityBuilderCore.Tests/Other/MissionSelector)
  • TaskList
    used in the Three demo for a multi stage tutorial
  • MessageBox
    generic message box dialog(Ok, OkCancel, YesNo, YesNoCancel)
  • Messaging
    allows sending messages and attaching events to buildings and walkers
    Town uses this to send messages from animations to the current task where it plays a sound

CHANGED

  • DefaultMap no longer clamps points, clamping is done in CameraController instead

FIXED

  • tooltips sometimes not exiting

1.8.3

IMPROVED

  • continue game from last saved data
    new buttons using this functionality in Three and Town demos
  • whether a stage is finished is saved per stage and per save game
    this allows beating the stage again on a new save

FIXED

  • walkers using navmesh agents cancelling on load
  • exception in storage component with older data

1.8.2

IMPROVED

  • ItemStorage has new ItemStorageMode called Store
    allows redirecting to a seperate ItemStore component
    for example to combine storages across a building
  • TerrainMap now derives from DefaultMap
    this enables blocking through tilemaps on TerrainMap
  • various custom property drawers
    ItemQuantity, ItemStorage, BuildingRequirement, …
  • storage orders are now also persisted

FIXED

  • GetItemQuantity on MultiItemContainer leading to wrong display in UI Panel
  • service category recipient not triggering evolution

1.8.1

ADDED

  • additional debug options in the inspector in play mode
    for example items can be added directly to StorageComponents
    available for Building and various BuildingComponents

FIXED

  • DeliveryWalker looking for storages in Load before storages are full loaded
  • GridPathing allowed invalid paths by default, now behind const ALLOW_INVALID
  • ServiceCategory was not fully integrated in Evolution
  • Invalid tool selection in new game in TownDemo after placing startup
  • TMPro warning in TownDemo due to unnecessary CanvasRenderer
  • Validation that prevents global storage from being configured to access itself

1.8.0

minimum recommended unity version has been raised to 2021.3.29

ADDED

  • minimal demo scene demonstrating simple placement
    CityBuilderCore.Tests/Other/Placement/Placement.unity
  • Buildings can now be suspended and resumed
    temporarily stops them from working without having to demolish and rebuild them
    (see checkmarks Three and Town demos building dialogs)
  • simple SavingIndicator in all demos
  • simple spawn(BuildingAddonSpawn) and despawn(DemolishVisualDespawn) animations
    (see Placement demo)

IMPROVED

  • Migrations can be configured to use multiple entry points
    (see PlebMigration in Three demo Debug scene)
  • Box option in StructureBuilder to build in a rectangular shape
    (see RugTool in Placement demo)
  • Override option in StructureBuilder to remove other structures
    (see RugTool in Placement demo)
  • Demolish tool has new LevelsNext field to configure order of deletion (see DemolishTool in Placement demo)

FIXED

  • tooltip position in scaled canvas
  • various minor adjustments to accommodate higher unity version

1.7.4

this will be the last version based on unity 2019.4.18, the next update will increase the minimum version to a more recent LTS

ADDED

  • tagged requirements on DefaultMap and TerrainMap
    define certain building restrictions on the map by tag(building, road, structure)
    check out BuildingPlaygroundTagged and BuildingPlaygroundTerrain for some examples

IMPROVED

  • StructureBuilder can now be used for any structure

FIXED

  • removal of old roads on load
  • harvesting of grown trees in town demo
  • gaps in terrain road visuals in some maps

1.7.3

ADDED

  • Off Grid Link
    equivalent to OffMeshLink in NavMesh but for grid(road) walking
    see debug scenes LinkRoadDebugging and BuildingPlaygroundLink
  • Mesh Highlight Manager
    visualizes highlights by modifying meshes during runtime
    used in town demo to dramatically improve highlighting performance
    three demo uses mesh highlighting with nice rounded outlines
    see BuildingPlayground2D for simple pixelated outline
  • Variant Production Component
    more versatile production component that allows configuring different variants
    see ProductionDebugging test scene for some examples

IMPROVED

  • better handling of mouse position outside play area
  • town demo harvest tool performance dramatically improved

1.7.2

ADDED

  • Tooltips
  • Walker and Building Dialogs in Town Demo
  • Notifications in Three Demo(Risks, Monuments)

CHANGED

  • Building Alternative is rotated on build

FIXED

  • Error in Editor Windows with Unity 2021
  • TownConstruction finishing prematurely
  • Error caused by Harvest Tasks being restarted
  • Off Mesh Link on Bridges in Three Demo

1.7.1

ADDED

  • Notification System and Notifications for
    • Town Constructions finishing
    • Town Season changing
    • Town Walkers dying
    • Urban Tornados
  • Town Trees falling down is now visualized
  • Town Walkers can visualize Tools for Tasks
    • Woodcutters and Foresters use an Axe

FIXED

  • critical bug preventing loading of most walkers
  • bridges not working as roads after reloading
  • worker walkers bug when site loads later or is destroyed
  • dead town inhabitants not being removed from their home
  • some other minor fixes in the town demo

1.7.0

3D Colony Sim Demo

This release marks the official promotion of CityBuilderTown from experimental to an official demo. This means a removal of all placeholders and a rework of all elements of the demo. This includes a completely new Set of Low Poly 3D Models used in that demo.

1.6.1

ADDED

  • ZoomCollider on CameraController can keep camera from clipping
    (used in town demo and three demo stage two)

FIXED

  • TerrainModifier not replacing TerrainData in collider
    (caused bad highlighting in generated town demo scenes)

1.6.0

ADDED

  • TerrainRoadManager visualizes roads by changing terrain texture
  • Terrain option in Setup Dialog
  • MovementPlayground and BuildingPlayground test scenes
  • DepopulationHappening which kills a fraction of the population
  • TownDemo
    • title screen, menus, difficulty, map generation
    • market building, distribution task, peddler job
    • road tool and task
    • views for food, wood and actions
    • test project
    • inspector tooltips, xml documentation
    • …

IMPROVED

  • TerrainModifier can also save height and texture
  • GridHeight is applied to Buildings
  • Walker can use NavMeshAgent for movement
  • BuildingBuilder adjusts position based on camera direction
  • CameraController now saves rotation

FIXED

  • LayerKeyVisualizer on scaled canvas
  • HasPoint on NavMesh when elevated

1.5.1

ADDED

  • PopulationVisualizer that displays population quantity and capacity
  • ManualExpansion allows placement of ExpandableBuilding in Editor

CHANGED

  • DistributionComponent
    no longer discards items the seller brings back if the storage has been filled
    additional new option on SaleWalker to reserve space for the items it carries
  • TownHomeComponent spawns walkers even when empty

FIXED

  • ProductionWalkerComponent missing calls to base methods
  • StructureTerrainTrees not changing on load
  • TownDeliveryTask not finishing when items are brought directly
  • TownGatheringComponent and TownForestingComponent task cleanup and saving
  • TownFieldTask was missing walker assignment

1.5.0

first in a series of 2-3 updates that focus on the new CityBuilderTown demo, documentation and core framework improvements

ADDED

  • CityBuilderTown[EXPERIMENTAL]
    • terrain based
    • task system
  • Walker Actions and Processes
    • higher level walker control
  • Risk- and ServiceCategory
    • building and walker bars
    • service category evolution
  • Building Prefab Alternatives
  • ItemConstructionComponent
    • replaces building when items have been supplied

IMPROVED

  • Documentation
    • header comments for all core objects
    • descriptions for demo manual pages
    • core building components manual diagram
  • Walker now directly exposes an Animator
    • animation parameters on WalkerInfo(Walk, Direction, Carry)
  • additional storage modes(ItemSpecific, TotalItemCapped, TotalUnitCapped)
  • various interfaces simplified

FIXED

  • mouse wrongly touch panning
  • camera shake on middle mouse drag

1.4.6

ADDED

  • Mobile support for Urban and Defense Demos
    • adjusted UI
    • added touch controls
  • WalkerAreaMask (NavMesh areas for use in PathTag)

1.4.5

ADDED

  • More uses for PathTag (see Walkers manual page)
    • RoadBlockers in Three Demo can be set to let certain Walkers pass
    • Different Pathing by Ground Tile in StructurePathDebugging test scene

IMPROVED

  • URP upgradability for Three demo (see CityBuilderThree/URP)
  • Employment Priorities are displayed in descending order

FIXED

  • Service Values increasing over time instead of decreasing
  • walker rotation in urban tunnel scene
  • three props now use the correct materials
  • links in manual pdf

1.4.0

ADDED

  • Food View in Three Demo
    uses the overhauled views and bars and the new IItemHolder interface
    walkers can now also have bars; added bars that show items using their icons
  • Tornado Happening in Urban Demo

IMPROVED

  • Health Bars in Defense Demo reintegrated with Core Views and Bars
  • Rain in Three Demo now affects Heat and Water
    the new ILayerModifier interface can be used to globaly affect Layers
  • Religion in Historic Demo now affects Farming Efficiency
    the new ScoreEfficiencyComponent uses a Score to affect Building efficiency
  • Migration in Three Demo is now driven by a Score
    this happiness score combines employment, housing quality and food availability

FIXED

  • suppressed unused event warnings
  • recursive error in retrievers
  • missing sprites in urban demo
  • minor errors in tests

1.3.0

ADDED

  • Timings system (events, animations and text based on playtime)
  • Hexagon support in Setup, Map, Tiles, …
  • Decorator Structures that save rotations and sizes
  • Object Generator for easy map object generation

IMPROVED

  • FireWalker in Three Demo now actively walks to and extinguishes fires
  • Walkers use better points to enter and exit buildings(Pathfinding accepts multiple starts/ends)
  • BuildingRequirement can now require Buildings(see BuildingRequirementDebugging)
  • DefaultGameManager now saves the current randomization state

FIXED

  • AccessType Exclusive
  • Rotations in XY Maps

1.2.0

ADDED

  • Overview Windows for Buildings, Walkers and Items
    these display all the objects in a set with preview images
    objects can be filtered, cloned and deleted

IMPROVED

  • Complete visual overhaul of 3D City Builder Demo
    • 25 Original Low Poly Buildings
    • Humanoid Walkers with Animations
    • Maps, Props, Materials, Effects, …
  • Updated “Start from Scratch” Tutorial
    • Incorporates new Setup and Overview Windows
    • New sprites for Buildings and Walkers

CHANGED

  • Common walker properties have been moved to WalkerInfo
    PathTyp, PathTag, Speed, MaxWait, Delay

FIXED

  • Expandable buildings not loading their expansion
  • Buildings having wrong scale after being affected by BuildingAddonTransformer
    this lead to buildings in the three demo always being slightly off scale or very off scale when the framerate was low
  • Roads for Bridge being amended without rotation
  • Path Recalculation for moving walkers in Defense Demo
  • Roads being demolished when their RoadBlocker was demolished
    Roads are “underlying” and therefore only demolished when no non “underlying” structure is demolished at the same time
  • Pooled walkers retaining their items and state
  • …

1.1.0

ADDED

  • Setup Wizard window
    creates a clean project template with placeable buildings
    configure display modes, axis, sizes, … in a simple dialog
  • Expandable Buildings
    building size is determined during building
    expand building in one or two dimensions
    showcased in the new bridge building of THREE demo
  • enhanced Full 3D support
    showcased in new 3D demo scene in THREE demo
    support for perspective camera and 3D roads
    height parameter in walkers can modify their display
    (move along terrain or change to different layer in tunnel)
  • Road Switching
    allows destination walkers to move between road networks
    showcased in SwitchRoadDebugging scene in tests and tunnel scene in urban demo

IMPROVED

  • Building Requirements now support various modes and configurations
  • Road Requirements can now be configured to amend missing roads
  • Cell Size of grid is taken into account in default and isometric map

CHANGED

  • RoadBuilding functionality has been merged into regular Buildings

FIXED

  • incorrect camera area when camera was pitched enough to look up
  • structure level editor not working inside arrays
  • monument pathing when using worker pooling
  • …

1.0.0

ADDED

  • urban demo project
    simple city sim in isometric 2d
    showcases various 1.0 features
  • connections core system
    build a network of feeders and passers
    enables water and electricity networks
  • connected tiles that switch sprite based on their neighbors
    simple base class and variants for rectangle and isometric grids

IMPROVED

  • walkers can now be pooled using ObjectPool
  • roads now support multiple networks
    simply use MultiRoadManager instead of DefaultRoadManager

    rails and roads in urban demo

  • structures now support multiple levels
    easily control which levels a structure inhabits using the level toggles

    a single point in the urban demo can have a pipe, road and power line; pumps inhabit all three levels

  • new view type that displays building efficiency

CHANGED

  • demo materials have been switched from urp to legacy shaders
  • sort axis moved to camera controller

FIXED

  • blockers not working after save/load
  • building walkers not triggering on spawn
  • panning in xy isometric maps
  • speed controls in historic demo
  • …

0.9.0

Initial Release