v6.0 GDScript Migration Guide
GridPlacement 6.0 is a major architectural release that unifies validation, introduces advanced terrain brushes, and modernizes the core API.
This guide covers migrating from GridPlacement v5.0.x (GDScript) to GridPlacement v6.0.x (GDScript).
1. Unified Validation System
In v5.0, validation rules were scattered across various nodes. In v6.0, all placement validation is unified under the `PlacementValidator` and `PlacementRule` resources.
What Changed:
- `GridTargetingState.is_valid_placement()` is gone.
- The `RuleCheckSystem` node has been removed.
- All rules are now defined as `PlacementRule` resources.
2. Terrain and Atlas Brushes
v5.0 relied on a simple `TileMapLayer` target. v6.0 introduces Placement Brushes, allowing you to place patterns of tiles, use Godot 4.3's terrain system natively, and manage complex multi-tile structures.
3. Terminology Updates
| Old Name (v5.0) | New Name (v6.0) | Notes |
|---|---|---|
| `Placeable` | `PlacementEntryData` | The runtime data class |
| `PlaceableSequence` | `EntryGroup` | Used for grouping items |
| `PlaceableTagDefinition` | `PlacementCategory` | Used for catalog filtering |
4. Manipulation Capabilities Moved to Definition
In v6.0, manipulation settings (rotate, flip, delete) are defined directly on the `PlaceableDefinition` resource instead of inside your packed scene.