Safe first setup
Use a clean Godot 4.7 stable or Godot 4.6.3 project for the first test.
Avoid enabling many editor plugins at the same time.
Back up real projects before testing generated content.
Setup safety
🛠️ Troubleshooting & Safe Setup
Fix common setup issues, avoid unsafe first tests, and know what information to send when asking for support.
Guide includedBeginner-friendlyUser guide
Common fixes overview
FAQ included · written guide includedUse this guide for common setup fixes. Optional support media can be embedded later without changing the written workflow.
What this page gives you
Most setup problems can be diagnosed without confusion.
Best forBeginners who installed Dreamcatcher but something does not appear, enable, save, or export as expected.
IncludedGuide included
Next resultMost setup problems can be diagnosed without confusion.
Workflow
Recommended learning flow
Follow this sequence before exploring the rest of Dreamcatcher. It keeps the learning path small and safe.
Problem appears→Check plugin path→Check Godot version→Restart→Read Output panel→Test clean project→Send support template
Step-by-step
Guide content
Plugin does not appear
Check that res://addons/dreamcatcher/plugin.cfg exists.
Make sure the folder is not double-nested.
Restart Godot after copying the folder.
Plugin appears but does not enable
Confirm whether you are using Godot 4.7 stable or Godot 4.6.3.
Open the Output panel and copy the first error.
Temporarily disable other editor plugins if needed.
Generated files are missing
A preview is not always the same as saved content.
Use Dreamcatcher apply, assign, or save actions where available.
Refresh the Godot FileSystem after generated outputs are created.
Export issues
Godot export templates must be installed separately.
Dreamcatcher can help review readiness, but export presets and platform SDKs still belong to Godot/platform setup.
Visuals coming soon
Written guide available now
The written guide is available now. Optional videos and screenshots are coming soon.
01Correct plugin folderVisuals coming soon
02Wrong double-nested folderVisuals coming soon
03Plugin tabVisuals coming soon
04Output panelVisuals coming soon
05Editor layout resetVisuals coming soon
06Export templates screenVisuals coming soon
Checklist
Completion checklist
- ✓The plugin path is correct.
- ✓Godot was restarted.
- ✓The Output panel was checked.
- ✓The issue was tested in a clean project.
- ✓Other editor plugins were temporarily disabled if needed.
- ✓A screenshot and error text are ready for support.
Avoid
Common mistakes
- Skipping a clean-project test.
- Reporting an issue without Godot version or error output.
- Moving generated folders manually while Godot is open.
- Assuming every warning means the project is broken.
Quick summary
In short
This page helps you diagnose setup problems safely. Start with the plugin path, Godot version, restart, Output panel, and clean-project test before assuming the plugin is broken.
