Getting Started

Welcome to AI Scene Organizer! This guide will help you open the tool for the first time, run a demo scene, and perform your first AI-driven scene scan.

1. Opening the Welcome Window

Upon importing AI Scene Organizer, the Welcome & Setup Window should launch automatically. If it doesn’t, or if you closed it and need to find it again, you can access it via the Unity top menu:

Tools ➔ Decnet ➔ AI Scene Organizer ➔ Welcome & Support

This window provides:

  • A Quick Tool Launcher for opening the main dashboard, the Scene Analyzer, and the Dependency Visualizer.
  • An AI Setup Wizard containing step-by-step help to connect Gemini, OpenAI, or OpenRouter.
  • Shortcuts to Discord support, email contact, and documentation.

2. Generating a Demo Scene

To evaluate the tool safely without modifying your active project assets, we recommend generating a mock messy scene.

  1. Open the Welcome Window (Tools ➔ Decnet ➔ AI Scene Organizer ➔ Welcome & Support).
  2. On the Welcome Hub tab, click Open Tool on the Mock Scene card.
  3. Confirm the dialog popup.
  4. AI Scene Organizer will generate a temporary scene filled with:
    • Messy named GameObjects (e.g. Rock (1) (Copy) (3), stone_large_A).
    • Objects with missing scripts (simulating broken script imports).
    • Mismatched layers and tags.
    • Lights, cameras, and audio objects scattered randomly.

3. Opening the Dashboard

The main dashboard coordinates all features:

Tools ➔ Decnet ➔ AI Scene Organizer ➔ Dashboard

This tabbed window contains four areas:

  • Scanner: Analyzes the scene for structural issues based on active rule sets.
  • AI Director: The natural language prompt engine to organize your scene.
  • Atmospheric Controller: An AI assistant that configures lighting, skyboxes, and fog based on atmospheric moods.
  • Settings: Configuration settings (shortcut to Project Settings).

4. Running Your First Scan

Let’s locate issues inside the generated demo scene:

  1. Navigate to the Scanner tab of the dashboard.
  2. Click Scan Scene.
  3. A list of layout issues will appear, grouped by categories:
    • Missing Scripts: GameObjects referencing C# scripts that no longer exist or are broken.
    • Naming Conventions: Objects violating standard casing (e.g. camelCase, PascalCase, or snake_case) or containing messy clone suffix names.
    • Duplicate Objects: Multiple objects sharing identical positions and names.
    • Layer/Tag Mismatches: Objects that don’t match the layers of parent containers.
  4. You can click Fix on individual issues or click Fix All to scrub the scene instantly.

[!TIP] All actions executed by AI Scene Organizer are registered in Unity’s Undo stack. If you don’t like a rearrangement, simply press Ctrl+Z (or Cmd+Z on macOS) to restore your previous layout instantly.

Next Steps

This site uses Just the Docs, a documentation theme for Jekyll.