Patch 5.0.3 - Editor Menu Default Actions Setup

Release Date: March 12, 2026 Version: 5.0.3 Type: Runtime Behavior Release

What Changed for Game Developers

⚙️ Editor Menu Default Actions Setup

  • Added “Grid Placement/Setup Default Input Actions” menu item to editor toolbar (Project > Tools > Grid Placement > Setup Default Input Actions)
  • Automated setup of all 15 default input actions with proper key bindings
  • Smart detection of existing actions to avoid overwriting custom configurations
  • Detailed console reporting of created vs preserved actions
  • Automatic editor restart after setup to apply Input Map changes
  • Comprehensive test coverage for default action creation and persistence
  • Improved project setup workflow for new users getting started with Grid Building
  • Added DefaultInputActionsHelper class to implement setup functionality (used by setup menu)

🔍 Runtime Validation Improvements

  • Added input action validation to DefaultInputActionsHelper class
  • New get_editor_issues() function validates input action configuration in editor
  • New get_runtime_issues() function validates input action configuration at runtime
  • Validation functions provide detailed issue descriptions for missing or misconfigured actions
  • Integrated with existing GBConfigurationValidator for centralized validation
  • Improved error detection and reporting for input action setup issues

🔧 Theme Cleanup

  • Removed hardcoded monogram font reference from runtime analyzer theme
  • Removed hardcoded monogram font reference from demo themes and template themes
  • Updated resource display scenes to use shared themes instead of custom inventory themes
  • All themes now use default system fonts for better cross-platform compatibility
  • No functional changes to runtime behavior

📝 Demo Scene Contract Test Improvements

  • Demo scene validation tests now focus on shipped demo behavior rather than internal node structure
  • Tests validate that demos boot with build stack intact and expose required HUD widgets
  • Ensures demos inherit warm template theme and avoid custom font overrides
  • Improves confidence that demo scenes work as intended for end users

🎨 Placeable View UI Improvements

  • Enhanced PlaceableView with configurable sizing and improved layout handling
  • Added fixed_view_height and fixed_icon_size export properties for consistent UI sizing
  • Improved default text display with proper minimum size constraints and stretch ratios
  • Better icon aspect ratio handling with STRETCH_KEEP_ASPECT_CENTERED mode
  • Enhanced tooltip support showing placeable display names on hover
  • Updated placeable selection template with improved width (145px) and “None” default text
  • More robust label sizing that prevents collapse when no placeable is assigned

Technical Changes

Validation System Enhancements

  • Added input action validation to DefaultInputActionsHelper class
  • New get_editor_issues() and get_runtime_issues() functions for input action validation
  • Enhanced GBConfigurationValidator with improved type safety and diagnostics
  • Centralized validation system now includes input action configuration checks

Version Bumps

  • Grid Building plugin: 5.0.2 → 5.0.3
  • Grid Building Inventory plugin: 5.0.0 → 5.0.3 (demo helper, not production-ready inventory)

Documentation Cleanup

  • Removed obsolete documentation files (5.0.1 and 5.0.2 patch notes, known bugs, etc.)
  • Removed archived documentation and test run logs
  • Removed deprecated instruction files
  • Cleaned up agent and IDE configuration rules

Migration Checklist

If you’re upgrading from 5.0.2 to 5.0.3, review the following:

  • Demo Level Transitions: If using demo level system, check if your game relies on inventory resets between levels
  • Testing: Test demo level transitions to ensure inventory preservation works as expected
  • Placeable UI: If using custom PlaceableView templates, test the new sizing constraints and default text behavior
  • UI Layout: Verify placeable selection UI layouts accommodate the new 145px width recommendation
  • Input Actions: Use “Project > Tools > Grid Placement > Setup Default Input Actions” menu to configure input actions for new projects
  • Runtime Validation: If using custom validation logic, review the new input action validation functions in DefaultInputActionsHelper for integration with your existing validation workflow

Compatibility

  • Godot Version: 4.4 (no change)
  • Breaking Changes: No breaking changes to plugin runtime
  • Backward Compatibility: Fully backward compatible
  • API Changes: Added new runtime validation functions to DefaultInputActionsHelper class:
    • get_editor_issues(action_names: GBActionNames) -> Array[String]
    • get_runtime_issues(action_names: GBActionNames) -> Array[String]
    • validate_action(p_action_name: StringName) -> Array[String]
    • get_configured_action_events(action_name: StringName) -> Array[InputEvent]
    • format_binding_description(events: Array[InputEvent]) -> String

Demo Level Changes

🎮 Player Inventory Preservation During Level Transitions

Demo System Change: Player inventory is now preserved during demo level transitions instead of being reset. If you need the old behavior, manually call world._reset_player_inventory() after level transitions.

Known Issues

No known issues in this release.

Future Plans

  • Enhance documentation for game developers
  • Further optimize runtime performance
  • Additional quality of life improvements for game developers

Acknowledgments

This release includes improvements to the demo level transition system, input action validation, and overall configuration validation. Thank you to the community for your continued support and feedback!

Previous Release: 5.0.2 - Movable Enforcement Bug Fixes