SORCERESS
Browse the wiki

The WizardGenie Workspace

Updated July 4, 2026Open the tool

Open the WizardGenie Workspace

The WizardGenie Workspace is the central environment for building and editing game projects. It works like a lightweight game-development IDE: browse project files, create and import assets, open files in the built-in editor, launch specialized asset editors, preview supported files, customize panels, and monitor workspace status from one screen.

What it does

The workspace brings together the tools you use most while developing a WizardGenie project:

  • A project Explorer with both folder-tree and thumbnail-grid views.
  • File creation, import, rename, copy, move, duplicate, paste, delete, undo, and redo actions.
  • Drag-and-drop importing from your computer.
  • Drag-and-drop organization inside your project.
  • A built-in code editor for common text and code files.
  • Quick actions for browser previews, 3D assets, voxel assets, audio playback, and character previews when supported files are present.
  • Dockable and movable panels with left, right, center, and bottom workspace areas.
  • A floating Explorer window that can be moved, resized, closed, or snapped back into a side dock.
  • A Hotkeys panel for reviewing and customizing shortcuts.
  • A Settings panel for visible workspace integrations and setup prompts.
  • A Welcome tab that introduces WizardGenie model modes and Desktop Edition setup options.
  • A status bar showing the current project, AI readiness, active work indicators, memory usage, and app version.

Workspace layout

The workspace is divided into several regions:

  • Center area — the main tabbed work area for welcome content, editors, previews, and other primary panels.
  • Left activity bar — a vertical strip for left-side panels such as Explorer and AI Chats.
  • Right activity bar — a vertical strip for right-side panels such as Inspector.
  • Bottom panel — a dockable horizontal area for panels that work better across the width of the screen.
  • Bottom activity bar — a compact row of icons used to open, close, and reorder bottom-docked panels.
  • Status bar — a bottom strip showing project and app status.
  • Floating Explorer — an optional movable Explorer panel.

Panel icons can be clicked to show or hide their panel. Active panel buttons are highlighted. Panel icons can also be dragged between supported zones to customize your layout.

Activity bars and dockable panels

The left and right activity bars each have a top section and a bottom section. Drag the small divider between them to adjust how much vertical room each section receives.

Common panel actions:

  1. Open or close a panel: click its icon.
  2. Move a panel: drag its icon to another supported activity-bar section.
  3. Reorder panels: drag an icon within a section and drop it where the insertion marker appears.
  4. Dock a panel to the bottom: drag it to the bottom drop zone or bottom activity bar.
  5. Open the bottom panel: click a bottom activity icon, or drop a panel into the bottom area.
  6. Close the bottom panel: click the active bottom icon again.
  7. Resize the bottom panel: drag the horizontal divider above it.

Visible shortcut hints include:

| Panel | Shortcut hint | | --- | --- | | Explorer | Alt+E | | AI Chats | Alt+A | | Inspector | Alt+? |

Project Explorer

The Explorer is the main file-management panel for your game project. It supports two viewing modes: list view and thumbnail grid view.

If no project is open, the Explorer shows buttons to open an existing project or create a new project.

List view

List view displays your project as an expandable folder tree.

You can:

  1. Click a file or folder to select it.
  2. Double-click a folder to expand or collapse it.
  3. Double-click a file to open or inspect it.
  4. Right-click files, folders, or empty space for context actions.
  5. Drag files onto folders to move them.
  6. Hold Ctrl or Cmd while dragging to copy instead of move.
  7. Use keyboard shortcuts for selection and file operations when the Explorer has focus.

Folders remember their expanded state between sessions where possible.

Thumbnail grid view

Grid view displays files as large icons or thumbnails. It is especially useful for images and visual assets.

Grid view includes:

  • Home button to return to the project root.
  • Up button to go to the parent folder.
  • Editable path bar — click the current path to type a project-relative location.
  • Thumbnail size controls — use the minus and plus buttons.
  • Ctrl/Cmd + mouse wheel resizing for thumbnail size.
  • Optional file-size display.
  • File-type filters.
  • Folder navigation by double-clicking folders.

Available grid filters are:

  • Images
  • 3D Models
  • Voxels
  • Scenes
  • Characters
  • Animations
  • Audio
  • Video
  • Code
  • Documents

When one or more filters are active, WizardGenie searches through subfolders under the current grid path and shows matching files across that folder tree. A short summary shows how many files were found. Files in filtered recursive results can display their containing subfolder beneath the filename.

Explorer toolbar actions

The Explorer toolbar includes buttons for:

  • Show or hide file sizes.
  • Switch between list and thumbnail grid view.
  • Undo supported file operations.
  • Redo supported file operations.
  • Import files.
  • Create a new file.
  • Create a new folder.
  • Refresh the Explorer.

In grid view, the toolbar also includes filter and thumbnail-size controls.

Selecting files and folders

Explorer selection supports common desktop-style behavior:

  • Click selects one item.
  • Ctrl/Cmd + click toggles individual items in the selection.
  • Shift + click selects a visible range.
  • Arrow Up/Down moves selection through visible items.
  • Shift + Arrow Up/Down extends the selection.
  • Home jumps to the first visible item.
  • End jumps to the last visible item.
  • Shift + Home/End extends selection to the first or last visible item.
  • Ctrl/Cmd + A selects all visible items.

Keyboard navigation works when the Explorer panel has focus. Click inside the Explorer first if shortcuts are not responding.

File and folder operations

Right-click menus and shortcuts support common project organization tasks.

Available actions include:

  • New file.
  • New folder.
  • New scene.
  • New voxel model.
  • New material from empty-space context actions.
  • Open.
  • Inspect.
  • Open with the built-in code editor.
  • Open with the default app.
  • Rename.
  • Cut.
  • Copy.
  • Paste.
  • Duplicate.
  • Move to Recycle Bin.
  • Undo and redo supported Explorer operations.
  • Copy absolute path.
  • Copy relative path.
  • Reveal in your operating system’s file explorer.

Common shortcuts:

| Action | Shortcut | | --- | --- | | Rename | F2 | | Cut | Ctrl/Cmd+X | | Copy | Ctrl/Cmd+C | | Paste | Ctrl/Cmd+V | | Duplicate | Ctrl/Cmd+D | | Move to Recycle Bin | Delete | | Select all visible items | Ctrl/Cmd+A | | Undo | Ctrl/Cmd+Z | | Redo | Ctrl/Cmd+Y or Ctrl/Cmd+Shift+Z |

Deleted items are moved to the Recycle Bin after confirmation.

Creating game assets from the Explorer

Right-click a folder or empty Explorer space to create project items. WizardGenie prompts for a name in an inline dialog. Press Enter or click Create to confirm; press Escape or Cancel to stop.

Supported creation actions include:

  • New File — creates a blank file with the name you enter.
  • New Folder — creates a folder with the name you enter.
  • New Scene — creates a starter scene structure with a scene layout, browser preview entry point, script entry point, and supporting utility file.
  • New Voxel Model — creates a starter voxel model with an empty voxel set and starter palette.
  • New Material — creates a starter material asset from the empty-space context menu.

Scene files may show lock/unlock actions in their context menu. A locked scene indicates that the scene layout is protected from automated edits; an unlocked scene allows edits. The lock indicator is checked when the context menu is opened.

Opening and previewing files

WizardGenie recognizes many common file types and shows helpful icons for code, images, audio, video, 3D models, voxel models, scenes, characters, animations, and documents.

Depending on file type, the Explorer may offer:

  • Open.
  • Inspect.
  • Open with Code Editor.
  • Preview in Browser for supported web preview files.
  • Open in 3D Studio for supported 3D assets.
  • Open in Voxel Studio for supported voxel assets.
  • Open Walk Preview or Open Drive Preview when matching character preview data is available.
  • Play/Stop for supported audio files.
  • Open with Default App.

Only one audio preview plays at a time. Starting a different audio preview stops the previous one.

For 3D asset creation and editing, see 3D Studio.

Importing and drag-and-drop

You can import files into the current project in several ways:

  • Click the Explorer Import Files button.
  • Right-click empty space and choose Import Files.
  • Drag files from your operating system into the Explorer.
  • Drag files directly onto a folder to import them there.
  • In grid view, drop files onto empty space to import them into the current grid folder.

You can also organize files by dragging inside the Explorer:

  • Drop selected files onto a folder to move them there.
  • Hold Ctrl or Cmd while dropping to copy instead.
  • In grid view, drop selected project files onto the background to move or copy them into the current grid folder.

If importing fails, the Explorer shows an error message with a close button. Try the Import button if drag-and-drop does not work with a particular file source.

Floating Explorer

The Explorer can appear as a floating window. This is useful when you want file access while working in a large editor or preview.

The floating Explorer can be:

  • Dragged by its title bar.
  • Resized from edges and corners.
  • Closed from the title-bar close button.
  • Brought to the front by clicking it.
  • Snapped to a side dock by dragging it near the left or right edge of the workspace.

When the floating Explorer is close enough to a dockable side, WizardGenie shows a snap indicator. Release the panel to dock it.

Built-in code editor

The workspace includes a built-in code editor for common text and code files.

When no files are open, the editor displays a prompt to open files from the Explorer. Once files are open, the editor provides:

  • Multiple tabs.
  • Close buttons on tabs.
  • Dirty/modified indicators.
  • Line count display.
  • File extension display.
  • Save button.
  • Save status messages.
  • Line numbers.
  • Folding gutter.
  • Bracket matching.
  • Automatic bracket closing.
  • Indentation support.
  • Line wrapping.

Use Save or Ctrl/Cmd+S to save the active modified file.

Open editor tabs are restored between sessions where possible. Unsaved edits are also preserved locally so you can return to them after reopening the workspace. If a file changes outside the editor while your tab has no unsaved changes, the editor refreshes it automatically. If you have unsaved edits, your work is preserved and the tab remains marked modified until saved or reconciled.

Supported editor file types include common script, data, markup, stylesheet, documentation, configuration, shader, shell, text, log, and table-style files. Specialized WizardGenie character and animation data are handled by their own workflows rather than as normal code-editor files.

Hotkeys panel

The Hotkeys panel lists available actions grouped by category and lets you customize bindings.

To change a hotkey:

  1. Open the Hotkeys panel or dialog.
  2. Find the action you want to change.
  3. Click its current key binding.
  4. Wait for the Press key… prompt.
  5. Press the new key combination.
  6. Press Escape while rebinding to cancel.

Custom bindings are highlighted. You can reset an individual custom binding to its default, or use Reset all to restore all default hotkeys.

Modifier-only shortcuts are ignored while rebinding; press a normal key together with any modifiers you want.

Settings panel

The Settings panel changes depending on the edition you are using.

In the web workspace, the visible settings area focuses on account-connected AI access and provides a close button in the panel footer.

In the desktop workspace, the Settings panel shows setup for self-hosted and asset-generation integrations. Visible controls include:

  • A self-hosted endpoint URL field.
  • An optional authorization key field for self-hosted endpoints that require it.
  • A pixel-art asset-generation key field.
  • Show/hide buttons for key fields.
  • Setup status indicators.
  • A Save button.
  • Success or error feedback after saving.

The panel also displays a note that chat and coding model provider setup lives in the Providers & Agents panel.

Welcome tab

The Welcome tab introduces WizardGenie and gives quick guidance for choosing model strength for different tasks. It highlights:

  • A free starter model mode for quick prototyping.
  • When to switch to stronger model modes for architecture, larger refactors, harder bugs, and cleaner multi-file edits.
  • A model lineup summary presented in the UI.
  • Desktop Edition benefits such as local-first files and bring-your-own-key setup.

In the web workspace, the Welcome tab includes a Desktop Edition link. In the desktop workspace, it includes buttons to open setup settings.

Status bar

The status bar appears along the bottom of the workspace and shows:

  • WizardGenie version.
  • Current branch label.
  • Active agent work indicator, when applicable.
  • Current project name.
  • System memory usage, when available.
  • WizardGenie memory usage, when available.
  • AI readiness status.

If active agent work is running, the status bar shows a job indicator. Clicking it opens the AI Chats panel.

The AI status indicator shows:

  • AI Ready when configuration is available.
  • API Key Required when required AI configuration is missing in the current environment.

Tips and troubleshooting

I cannot see a panel I need

Check the left, right, and bottom activity bars. If the panel icon is visible, click it to toggle the panel. If you previously dragged it, look for it in another activity-bar section or in the bottom bar.

The bottom panel disappeared

If no panel is open in the bottom area, the bottom panel collapses. Click a bottom activity icon or drag a panel into the bottom drop zone to reopen it.

File changes are not visible

Click the Explorer refresh button. WizardGenie also refreshes when project files change, but rapid edits may be grouped briefly to keep the UI stable.

Keyboard shortcuts do not work in the Explorer

Click inside the Explorer first so it has focus. Shortcuts are ignored while typing in inputs, rename fields, or other editable controls.

A file says it is modified in the editor

The modified indicator means the open tab has unsaved changes. Click Save or press Ctrl/Cmd+S.

Importing files failed

Try the Explorer Import Files button instead of drag-and-drop. If the error remains, make sure a project is open and that the destination folder can be written to.

Audio keeps stopping when I play another file

This is expected. The Explorer plays one audio preview at a time.

My hotkey change did not apply

Make sure the binding button says Press key… before pressing the new shortcut. Pressing only a modifier key does not create a binding. Use Reset all if you need to return to defaults.

A grid filter does not show files I expected

Filters search from the current grid path downward. Use Home to return to the project root, or click the path bar and enter the folder you want to search from.