Settings
Every configurable option in OPAL.
OPAL’s settings are grouped into categories. Defaults are called out in bold — you don’t need to touch most of these.
Appearance
| Setting | Default | Notes |
|---|
| Theme | System | Light / Dark / System |
| Accent color | O3DE Blue | Affects buttons, highlights, progress bars |
| Density | Comfortable | Compact reduces paddings ~25% |
| Sidebar width | 240 px | Resize live by dragging the divider |
Storage locations
| Setting | Default | Notes |
|---|
| Engine install directory | ~/.opal/engines | Each engine gets a subfolder |
| Project workspace | ~/O3DEProjects | Default location for new projects |
| Gem storage directory | ~/.opal/gems | Shared across projects when possible |
| Repository cache | ~/.opal/cache/repos | Indexed gem repo metadata |
Changing a storage path prompts to migrate existing contents — you can opt out and leave the old contents in place.
O3DE defaults
| Setting | Default | Notes |
|---|
| Build configuration | profile | debug / profile / release |
| CMake generator | Platform default | Ninja on Linux/macOS, VS on Windows |
| Default editor launch flags | (none) | Free-form string |
| Auto-register projects on import | On | |
Queues
| Setting | Default | Notes |
|---|
| Max concurrent downloads | 4 | |
| Max concurrent builds | 1 | |
| Global download speed limit | Unlimited | MB/s |
| Schedule enabled | Off | |
| Schedule window | 22:00–07:00 | Overnight-aware |
Notifications
| Setting | Default | Notes |
|---|
| Download complete | On | OS-native notification |
| Build complete | On | |
| Build failed | On | |
| Queue empty | Off | |
| Respect OS do-not-disturb | On | |
Accounts
Manage connected marketplace accounts. (Marketplace is a planned post-1.0 feature.)
Advanced
| Setting | Default | Notes |
|---|
| Telemetry | Off | Off by default. See privacy note below. |
| Auto-update OPAL | On | Prompts before applying |
| Experimental features | Off | Enables beta features gated behind this flag |
| Config export / import | — | JSON file of every setting |
Privacy
OPAL ships with telemetry
off. We don’t collect anything by default. If you opt in, we get crash reports and anonymous feature-use stats — nothing else. See the
Privacy page for the full breakdown.
Import / export
Advanced → Export config writes every setting to a JSON file you can back up or share with a teammate. Advanced → Import config reads it back.