{"id":17702402,"url":"https://github.com/imtani/godot-property-selection-window","last_synced_at":"2025-04-24T02:09:26.809Z","repository":{"id":259235360,"uuid":"877038276","full_name":"ImTani/godot-property-selection-window","owner":"ImTani","description":"Making property management easier!","archived":false,"fork":false,"pushed_at":"2024-11-18T14:11:21.000Z","size":285,"stargazers_count":9,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-24T02:09:17.977Z","etag":null,"topics":["gdscript","godot","godot-engine","godot-plugin","plugin"],"latest_commit_sha":null,"homepage":"https://godotengine.org/asset-library/asset/3454","language":"GDScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ImTani.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-23T01:26:23.000Z","updated_at":"2025-02-28T14:32:44.000Z","dependencies_parsed_at":"2024-10-27T22:55:43.400Z","dependency_job_id":null,"html_url":"https://github.com/ImTani/godot-property-selection-window","commit_stats":null,"previous_names":["imtani/godot-property-selection-window"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ImTani%2Fgodot-property-selection-window","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ImTani%2Fgodot-property-selection-window/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ImTani%2Fgodot-property-selection-window/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ImTani%2Fgodot-property-selection-window/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ImTani","download_url":"https://codeload.github.com/ImTani/godot-property-selection-window/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250546082,"owners_count":21448260,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gdscript","godot","godot-engine","godot-plugin","plugin"],"created_at":"2024-10-24T19:07:04.328Z","updated_at":"2025-04-24T02:09:26.778Z","avatar_url":"https://github.com/ImTani.png","language":"GDScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Property Selection Window\n\n\u003cdiv align=\"center\u003e\n\n![Logo](https://repository-images.githubusercontent.com/877038276/e09cc1b7-e4d1-48bd-b122-930ba0f19fa1)\n\n[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Godot Engine](https://img.shields.io/badge/Godot-v4.2+-blue)](https://godotengine.org/)\n\nA powerful Godot plugin that streamlines property management with an intuitive interface. Designed for seamless integration with the Godot editor, it enhances your development workflow through advanced filtering, type-based organization, and efficient property handling.\n\n\u003c/div\u003e\n\n![Property Selection Window Preview](docs/media/window-preview.png)\n\n## Features\n\n### Property Tree\n- Hierarchical property visualization\n- Intelligent organization and nesting\n- Real-time value previews\n- Responsive layout with proper scaling\n\n### Advanced Filtering\n- Performance-optimized search with debouncing\n- Type-based filtering system\n  - Custom Classes are recognized\n- Toggleable engine property visibility\n\n### Property Management\n- Automatic type detection and formatting\n- Circular reference protection\n- Real-time value monitoring\n- Multi-select with checkbox support\n- Persistent selection states\n- Bulk selection operations\n\n## Installation\n\n**Via Asset Library**\n1. Open the Godot Asset Library within your project\n2. Search for \"Property Selection Window\"\n3. Download and install the plugin\n\n**Via Git**\n```bash\ngit clone https://github.com/ImTani/godot-property-selection-window.git\n```\n\n**Enable the Plugin**\n1. Navigate to `Project → Project Settings → Plugins`\n2. Locate `Property Selection Window`\n3. Enable the plugin via the checkbox\n\n## Implementation\n\n### Basic Usage\n\n```gdscript\nvar property_selector = PropertySelectionWindow.new()\nproperty_selector.create_window(\n    target_node,            # Node to inspect\n    initially_selected,     # [Optional] Pre-selected properties\n    show_hidden_properties, # [Optional] Show engine properties\n    type_filter,           # [Optional] Initial type filter\n    callback               # [Optional] Selection callback\n)\n\n# Handle selections\nfunc _on_properties_selected(selected_properties: Array[String]):\n    print(\"Selected:\", selected_properties)\n```\n\n### Advanced Features\n\n```gdscript\n# Filtering\nproperty_selector.set_type_filter(TYPE_FLOAT)    # Filter by type\nproperty_selector.set_filter(\"position\")         # Search filter\nproperty_selector.toggle_hidden_properties(true) # Show all properties\n\n# Tree Management\nproperty_selector.expand_all()      # Expand all nodes\nproperty_selector.collapse_all()    # Collapse all nodes\nproperty_selector.refresh_tree()    # Refresh property tree\n\n# Property Operations\nif property_selector.property_exists(\"position\"):\n    var type = property_selector.get_property_type(\"position\")\n    var value = property_selector.get_property_value(\"position\")\n    property_selector.set_property_value(\"position\", Vector2(100, 100))\n```\n\n## API Reference\n\n### Signals\n\n| Signal | Description |\n|--------|-------------|\n| `properties_selected(selected_properties: Array[String])` | Emitted when properties are confirmed |\n\n### Core Methods\n\n| Method | Description |\n|--------|-------------|\n| `create_window(...)` | Creates and displays the property selection window |\n| `set_target(new_target: Node)` | Updates the target node |\n| `set_filter(filter_text: String)` | Applies a search filter |\n| `set_type_filter(filter: int)` | Sets type-based filtering |\n| `toggle_hidden_properties(show: bool)` | Controls visibility of engine properties |\n\n### Utility Methods\n\n| Method | Description |\n|--------|-------------|\n| `expand_all()` | Expands all tree items |\n| `collapse_all()` | Collapses all tree items |\n| `refresh_tree()` | Refreshes the property tree |\n| `get_all_properties()` | Returns available properties |\n| `property_exists(property_name: String)` | Checks property existence |\n| `get_property_type(property_name: String)` | Returns property type |\n| `get_property_value(property_name: String)` | Retrieves property value |\n| `set_property_value(property_name: String, value: Variant)` | Sets property value |\n\n## Integration Example\n\nExample integration with [TimeRewind2D](https://github.com/imtani/godot-time-rewind-2d/) plugin:\n\n![Time Rewind Integration](docs/media/time-rewind-window.png)\n\n```gdscript\nfunc _open_property_selector_window(time_rewind: Node2D) -\u003e void:\n    if not is_instance_valid(time_rewind):\n        push_error(\"TimeRewind2D: Invalid time_rewind instance\")\n        return\n    \n    if not is_instance_valid(time_rewind.body):\n        push_error(\"TimeRewind2D: Invalid body reference\")\n        return\n\n    var property_selector = PropertySelectionWindow.new()\n    var rewindable_properties = time_rewind.get(\"rewindable_properties\") or []\n\n    property_selector.create_window(\n        time_rewind.body,\n        rewindable_properties,\n        false,\n        -1,\n        func(selected_properties: Array[String]):\n            time_rewind.set(\"rewindable_properties\", selected_properties)\n    )\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/NewFeature`)\n3. Commit your changes (`git commit -m 'Add NewFeature'`)\n4. Push to the branch (`git push origin feature/NewFeature`)\n5. Open a Pull Request\n\n## License\n\nDistributed under the MIT License. See [`LICENSE`](LICENSE) for more information.\n\n---\n\n\u003cdiv align=\"center\"\u003e\nBuilt for the Godot community\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimtani%2Fgodot-property-selection-window","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimtani%2Fgodot-property-selection-window","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimtani%2Fgodot-property-selection-window/lists"}