GridBuilding 5.0 (Stable)

Stable documentation for GridBuilding/GridPlacement 5.0. Production-ready with known limitations.

This section documents the stable 5.0 line (historical reference).

Use this section when you are:

  • Maintaining an existing 5.0 project.
  • Debugging a regression specific to the 5.0-era architecture.
  • Investigating why later versions (5.1 / 6.0) introduced clearer separation between event payloads, snapshots, and service state.

If you are starting a new project, prefer:

  • v5-1 (Upcoming feature release)
  • v6-0 (C# Edition - Complete architectural redesign)

What you’ll find here

  • Guides: conceptual docs + patterns for the 5.0 architecture.
  • API: reference pages tied to the 5.0 content set.

Start here

Testing note (5.0)

5.0 shipped with a large, environment-heavy test suite.

  • Historical count (5.0-era): 1540 tests passing at 100%
  • Interpretation: the suites were comprehensive but bulky, and often relied on full environment scenes.

Known Issues (5.0)

  • Rotation Bug: A known issue in 5.0 causes incorrect object orientation during placement. This is resolved in the 5.1 (Development) release.

If you can migrate, the most common path is:

  1. Move to v5-1 first (still GDScript, but with the modernized boundaries).
  2. Then adopt v6-0 concepts when you’re ready for the C# Core architecture.