Patch 5.0.3 - UI Modernization & Stability Improvements

Release Date: March 26, 2026 Version: 5.0.3 Type: UI & Stability Release

What Changed for Game Developers

Production-Ready Theme Overhaul: Comprehensive modernization of the “Cool Blue” and “Warm Earth” themes to ensure visual parity and professional aesthetics.
New Styled Components: Added missing StyleBoxFlat definitions for all core UI elements, including CheckBox, LineEdit, OptionButton, and TabContainer.
Consistency Standards: Normalized content margins, widget separation, and scrollbar widths across all container types to ensure a balanced, high-end feel.
Dynamic Feedback: Added refined visual states for Hover, Pressed, and Focus across all input widgets, providing immediate and clear interaction feedback.
Font Accessibility: Removed legacy hardcoded monogram font references in favoring of default system typography for better cross-platform alignment.

Improved Input Action Persistence: Fixed a synchronization issue where manually created input actions weren’t being correctly written to project.godot by the setup tool.
Deferred Dependency Validation: IndicatorManager now defers its initial dependency check via call_deferred. This eliminates premature “NULL property” console warnings during complex scene injections.
Action Setup UX: The “Setup Default Input Actions” menu now provides clearer reporting on created vs. preserved actions.
Reduced Logger Noise: Silenced redundant “Logger not ready” verbose warnings during early initialization frames.

Enhanced Error Reporting: Refactored the internal logging pipeline to support batch reporting of validation issues, significantly reducing console clutter.
Structured Debug Groups: Systems now aggregate multiple related issues into single, formatted report blocks with contextual headers (e.g., “IndicatorManager validation issues:”).
Core Integration: Consolidated logging is now implemented across all major systems:
- GBInjectorSystem: Batch reporting for injection failures.
- GridTargetingSystem: Improved mode-change diagnostics.
- IndicatorManager: Structured initialization contexts.
- ManipulationSystem: Silenced redundant resolution logs.

Vacuous Truth Logic: Fixed CollisionsCheckRule and WithinTilemapBoundsRule to correctly pass when an object has no collision indicators (correctly identifying that no violation is possible).
Visual Bounds Fallback: WithinTilemapBoundsRule now intelligently falls back toSprite2D or Polygon2D bounds when collision shapes are absent, providing a safety net for decorative objects.
Improved Type Safety: Enhanced GBConfigurationValidator with better diagnostics for property-level configuration errors.

Null Target Handling: IndicatorManager.try_setup() now returns a structured failure report when the GridTargetingState target is missing, instead of surfacing a runtime error and leaving the report in a null/partial state.
Cancel Cleanup Coverage: Manipulation cancel now has regression coverage ensuring active indicators are cleared after canceling a move operation.
Test Coverage: Added/updated regression tests for the null-target indicator path and the move-cancel cleanup path so the behavior stays locked in.

Removed outdated 5.0.1 and 5.0.2 patch notes fragments from internal docs.
Removed archived test run logs and deprecated instructions to reduce repository bloat.

If you’re upgrading from 5.0.2 to 5.0.3:

UI Themes: If you use the plugin’s built-in themes, verify your custom overrides accommodate the new standardized container margins.
Input Actions: Run “Project > Tools > Grid Placement > Setup Default Input Actions” one last time to ensure all 15 actions are correctly written to your project file.
Diagnostics: Check the console for the new structured logs if you’ve been seeing initialization-phase warnings.

Previous Release: 5.0.2 - Movable Enforcement Bug Fixes