This page outlines validation utilities for configuration validation at initialization — checking that settings, resources, and dependencies are properly configured when the scene loads.

This guide = Validation of configuration at startup (via GBInjectorSystem or manual setup). Placement Rules = Runtime validation when placing objects (e.g., checking grid bounds).

Configuration Validation with PlacementValidator

In 5.0.9: PlacementValidator handles validation. It uses placement rules to validate potential placements at runtime.

Core Validation Classes

PlacementValidator: The main class that orchestrates validation. It takes a list of rules and evaluates them against the current placement context.
ValidationResults: A data container that captures the outcome of validation. It holds is_successful, issues (errors), and warnings.

How It Works

Setup: Create a PlacementValidator with your configured rules.
Validation: Call validate_placement(context) to check a potential placement.
Results: Get a ValidationResults object with success status and any issues.

ValidationResults

Property	Type	Description
`is_successful`	bool	True if no blocking issues were found.
`issues`	Array[String]	List of critical errors that prevent operation.
`warnings`	Array[String]	List of non-critical observations.

Usage Example

# Example: Using PlacementValidator
var validator= PlacementValidator.new(rules, logger)
var context= PlacementRuleContext.new()
context.target_cell= Vector2i(5,3)
context.grid_size= Vector2i(10,10)

var results= validator.validate_placement(context)
if not results.is_successful:
    for issuein results.issues:
        print("Validation failed: ", issue)

Add to entity (Component-based)

my_entity.add_child(rule_comp)