Reference
Resource Scripts
Reference overview for 57 resource/data scripts in the v0.9.5 package.
v0.9.5Godot 4.6–4.74.7.1 recommendedReference
This page summarizes the current v0.9.5 workflow and keeps Early Access boundaries clear.
Reference page: this page is public-facing. It explains what the inventory means for users instead of expecting plugin-development knowledge.
Resource reference: 57 resource/data scripts
These are the current scripts under addons/dreamcatcher/resources/, including the v0.9.5 binding profile, UI, semantic audio/VFX, and animation-event resource families. Most extend Resource; DreamMapEvent extends Node2D and should be explained as a map-event object/data-runtime bridge rather than as a plain data resource.
What resources are: Godot resources are saved data objects. Dreamcatcher uses resources for editable game data such as actors, enemies, items, skills, quests, dialogue, maps, generated assets, loot, and genre-specific configuration. Resources are usually safer than hardcoding because tools, validators, and scenes can all point to the same data file.
Resource family map
| Resource family | What it represents | Usually edited with | Common warning |
|---|---|---|---|
| Actors, combat, and RPG data | Actors, classes, enemies, weapons, armor, skills, states, troops, perks. | Database, combat tutorials, Action RPG workflows, generated database resources. | A scene references an actor/enemy/skill that was renamed, moved, or deleted. |
| Inventory and economy | Items, shops, loot tables, recipes, rewards, costs, drops. | Database, Generated Asset Browser, shop/loot tutorials. | Reward, chest, shop, or loot event points to missing item data. |
| Narrative and quests | Dialogue, chapters, quests, choices, progress state. | Narrative Weaver, Visual Logic, Map Editor events. | NPC dialogue opens but choice/quest state does not update. |
| Generated asset metadata | Generated asset records, previews, reports, presets, dependencies. | Procedural Toolkit and Generated Asset Browser. | Asset file exists but its registry/metadata entry is missing or points to an old path. |
| Map, region, and tileset data | Tileset layout, map event pages, conditions, region behavior. | Map Editor, Scene Composer, map validation. | Map event, region, collision, music, or weather rule is present in the editor but not triggered in play. |
| Genre-specific resources | Cards, decks, race configs, sports configs, puzzle data, rhythm charts, tower waves, runner/farm/horror settings. | Genre starter workflows and specialized tool/reference pages. | Genre scene opens but the expected data resource is not assigned. |
| Workflow bindings | Project-owned binding profiles, UI recipes/bindings, semantic audio/VFX event maps, and animation event sets. | Dream Inspector Bindings, UI Builder, Sound Studio, Animation Studio, Generated Asset Browser, Migration Assistant. | A binding root is embedded/pathless, a semantic event/qualifier is unresolved, or runtime-bound metadata fails persistence/validation. |
Safe file rule: keep project-owned game data under your project folders such as res://dream/. Avoid editing or saving your own content inside res://addons/dreamcatcher/.
| File | Class | Extends |
|---|---|---|
| dream_actor_data.gd | DreamActorData | Resource |
| dream_animation_data.gd | DreamAnimationData | Resource |
| dream_animation_event.gd | DreamAnimationEvent | Resource |
| dream_animation_event_set.gd | DreamAnimationEventSet | Resource |
| dream_armor.gd | DreamArmor | Resource |
| dream_audio_event.gd | DreamAudioEvent | Resource |
| dream_audio_event_map.gd | DreamAudioEventMap | Resource |
| dream_binding_profile.gd | DreamBindingProfile | Resource |
| dream_board_path.gd | DreamBoardPath | Resource |
| dream_capture_rule.gd | DreamCaptureRule | Resource |
| dream_card.gd | DreamCard | Resource |
| dream_chapter.gd | DreamChapter | Resource |
| dream_class.gd | DreamClass | Resource |
| dream_creature_instance.gd | DreamCreatureInstance | Resource |
| dream_creature_roster.gd | DreamCreatureRoster | Resource |
| dream_creature_species.gd | DreamCreatureSpecies | Resource |
| dream_deck.gd | DreamDeck | Resource |
| dream_dialogue.gd | DreamDialogue | Resource |
| dream_enemy.gd | DreamEnemy | Resource |
| dream_environment.gd | DreamEnvironment | Resource |
| dream_fighter_data.gd | DreamFighterData | Resource |
| dream_generated_asset.gd | DreamGeneratedAsset | Resource |
| dream_generated_asset_metadata.gd | DreamGeneratedAssetMetadata | Resource |
| dream_generated_asset_preview.gd | DreamGeneratedAssetPreview | Resource |
| dream_generation_preset.gd | DreamGenerationPreset | Resource |
| dream_generation_report.gd | DreamGenerationReport | Resource |
| dream_grid.gd | DreamGrid | Resource |
| dream_horror_config.gd | DreamHorrorConfig | Resource |
| dream_item.gd | DreamItem | Resource |
| dream_loot_table.gd | DreamLootTable | Resource |
| dream_map_event.gd | DreamMapEvent | Node2D |
| dream_map_event_condition.gd | DreamMapEventCondition | Resource |
| dream_map_event_page.gd | DreamMapEventPage | Resource |
| dream_map_region_data.gd | DreamMapRegionData | Resource |
| dream_perk_data.gd | DreamPerkData | Resource |
| dream_puzzle.gd | DreamPuzzle | Resource |
| dream_quest.gd | DreamQuest | Resource |
| dream_race_config.gd | DreamRaceConfig | Resource |
| dream_recipe.gd | DreamRecipe | Resource |
| dream_region_behavior.gd | DreamRegionBehavior | Resource |
| dream_rhythm_chart.gd | DreamRhythmChart | Resource |
| dream_runner_config.gd | DreamRunnerConfig | Resource |
| dream_shop.gd | DreamShop | Resource |
| dream_skill.gd | DreamSkill | Resource |
| dream_sport_config.gd | DreamSportConfig | Resource |
| dream_state.gd | DreamState | Resource |
| dream_system_config.gd | DreamSystemConfig | Resource |
| dream_tileset_data.gd | DreamTilesetData | Resource |
| dream_tower_data.gd | DreamTowerData | Resource |
| dream_troop.gd | DreamTroop | Resource |
| dream_ui_binding.gd | DreamUIBinding | Resource |
| dream_ui_list_binding.gd | DreamUIListBinding | Resource |
| dream_ui_screen_recipe.gd | DreamUIScreenRecipe | Resource |
| dream_vfx_event.gd | DreamVFXEvent | Resource |
| dream_vfx_event_map.gd | DreamVFXEventMap | Resource |
| dream_wave_data.gd | DreamWaveData | Resource |
| dream_weapon.gd | DreamWeapon | Resource |
Common user-facing groups:
- Actors/combat/RPG:
DreamActorData,DreamClass,DreamEnemy,DreamWeapon,DreamArmor,DreamSkill,DreamTroop,DreamState,DreamPerkData. - Inventory/economy:
DreamItem,DreamShop,DreamLootTable,DreamRecipe. - Narrative/quests:
DreamDialogue,DreamChapter,DreamQuest. - Cards/board/puzzle/rhythm/sports/racing:
DreamCard,DreamDeck,DreamBoardPath,DreamPuzzle,DreamRhythmChart,DreamSportConfig,DreamRaceConfig. - Generated asset system:
DreamGeneratedAsset,DreamGeneratedAssetMetadata,DreamGeneratedAssetPreview,DreamGenerationPreset,DreamGenerationReport. - Maps/tiles/regions:
DreamTilesetData,DreamMapEvent,DreamMapEventPage,DreamMapEventCondition,DreamMapRegionData,DreamRegionBehavior,DreamGrid,DreamEnvironment. - Creature collector:
DreamCreatureSpecies,DreamCreatureInstance,DreamCreatureRoster,DreamCaptureRule.
