Troubleshooting

This guide helps you resolve common issues with Asset Scaffolding. If you can't find a solution here, contact support at assetoptics@brahmaforge.com.

Installation Issues

Plugin Not Appearing

Symptoms:

• No Asset Scaffolding in Window menu
• No toolbar button

Solutions:

1. Check if enabled:
2. Go to Edit → Plugins
3. Search for "Asset Scaffolding"
4. Ensure checkbox is checked

5. Restart if prompted

6. Verify installation:

7. Check AssetScaffolding folder exists in Plugins

8. Verify all files are present

9. Check engine version:

10. Requires Unreal Engine 5.5+
11. Check Help → About Unreal Editor

Plugin Won't Load

Symptoms:

• Error on project open
• "Failed to load" message

Solutions:

1. Reinstall:
2. Delete the plugin folder
3. Re-download from Fab Marketplace

4. Reinstall

5. Check dependencies:

6. Some features need other plugins

7. Check Output Log for specific errors

8. File permissions:

9. Ensure read/write access
10. On macOS, check for quarantine

Recipe Issues

Recipe Fails to Create Asset

Symptoms:

• Click create but nothing happens
• Error message in notification

Solutions:

1. Check asset name:
2. No special characters
3. No spaces (use underscores)

4. Name must be unique

5. Check location:

6. Folder must exist
7. Write permissions required

8. Path can't be too long

9. Check Output Log:

10. Window → Developer Tools → Output Log
11. Look for specific error messages

Asset Created but Incorrect

Symptoms:

• Missing components
• Wrong parent class
• Properties not set

Solutions:

1. Recipe version:
2. Update Asset Scaffolding to latest

3. Recipes may have been updated

4. Custom recipe issue:

5. Open recipe in Designer
6. Verify configuration

7. Test with built-in recipe

8. Engine compatibility:

9. Some features vary by engine version
10. Check release notes

Recipe Not Found

Symptoms:

• Recipe missing from library
• Category empty

Solutions:

1. Refresh library:
2. Close and reopen Asset Scaffolding

3. Click refresh button

4. Check filters:

5. Clear any active filters

6. Check category selection

7. Custom recipes:

8. Import may have failed
9. Re-import the recipe file

Game World Issues

Game World Empty

Symptoms:

• No systems shown
• Missing previously added items

Solutions:

1. Project mismatch:
2. Verify correct project is open

3. Game World is per-project

4. Cache issue:

5. Close Unreal Engine
6. Delete Saved/AssetScaffolding folder

7. Reopen and rescan

8. Corrupted state:

9. Open Studio Mode → Settings
10. Click "Reset Game World"
11. Rescan project

Missing Asset Warnings

Symptoms:

• Red "Missing" status
• Assets were deleted externally

Solutions:

1. If intentional:
2. Right-click → Remove from Game World

3. Stops tracking the asset

4. If accidental:

5. Check Trash/Recycle Bin
6. Restore the file

7. Refresh Game World

8. If moved:

9. Right-click → Locate
10. Browse to new location
11. Game World updates tracking

Dependencies Showing Errors

Symptoms:

• Orphaned status
• Dependency chain broken

Solutions:

1. Recreate dependency:
2. Identify missing dependency
3. Scaffold it using a recipe

4. Dependencies resolve automatically

5. Manual fix:

6. Open the broken asset
7. Fix references manually
8. Refresh Game World

Studio Mode Issues

Recipe Designer Won't Save

Symptoms:

• Save fails
• Changes lost

Solutions:

1. Validation errors:
2. Check all required fields
3. Asset type must be selected

4. Name can't be empty

5. Permission issue:

6. Check user folder permissions

7. Recipes save to user-specific location

8. Disk space:

9. Ensure sufficient disk space
10. Check for full drives

C++ Classes Not Found

Symptoms:

• C++ Discovery shows nothing
• Your classes missing

Solutions:

1. Compile your code:
2. C++ must be compiled
3. Hot reload may help

4. Try full rebuild

5. UCLASS macro:

6. Classes need UCLASS()

7. Must be in proper module

8. Refresh:

9. Click refresh in Discovery
10. May take time for large projects

Import/Export Failing

Symptoms:

• Can't import recipe file
• Export produces invalid file

Solutions:

1. File format:
2. Must be .asrecipe extension

3. File must be valid JSON

4. Version mismatch:

5. Recipes from newer versions may not import

6. Update Asset Scaffolding

7. Corrupted file:

8. Try re-exporting from source
9. Check file isn't truncated

Performance Issues

Slow to Open

Symptoms:

• Long load time
• UI freezes on open

Solutions:

1. Large project:
2. Game World scans project
3. Large projects take longer

4. Wait for initial scan

5. Many recipes:

6. Custom recipes are loaded

7. Remove unused custom recipes

8. Disable auto-scan:

9. Settings → Auto-scan on open
10. Disable for faster open
11. Manual scan when needed

UI Lag

Symptoms:

• Slow response
• Delayed updates

Solutions:

1. Reduce visible items:
2. Use filters

3. Collapse categories

4. Close other panels:

5. Reduce editor load
6. Focus on essential panels

Asset Optics Integration Issues

Integration Not Working

Symptoms:

• No Asset Optics indicator
• Features disabled

Solutions:

1. Check both plugins:
2. Both must be enabled

3. Same project loaded

4. Asset Optics logged in:

5. Must be authenticated

6. Project must be selected

7. Restart:

8. Close Unreal Engine
9. Reopen both plugins

See Asset Optics Integration for more details.

Getting Help

Before Contacting Support

Gather:

• Unreal Engine version
• Asset Scaffolding version
• Operating system
• Steps to reproduce
• Output Log contents
• Screenshots

Contact

• Email: assetoptics@brahmaforge.com
• Web: asset-optics.brahmaforge.com

---

© 2026 BrahmaForge. All rights reserved.