Frequently Asked Questions (FAQ)

Have questions about pricing, setup, API keys, or compatibility? Check the common questions below.

General Questions

Does this tool send my project code or assets to external servers?

No. AI Scene Organizer only extracts metadata about the current scene hierarchy: GameObject names, component types, coordinates, layers, tags, and parent-child relationships. It never uploads your C# scripts, source code, 3D meshes, textures, or binary assets to the AI APIs. Your intellectual property remains secure.

Is there a free option to run this tool?

Yes! By setting your active provider to Google Gemini, you can sign up for Google AI Studio’s free tier. This allows you to organize your scene hierarchies without paying any API costs. Alternatively, OpenRouter offers access to multiple free open-source models.

Does this tool support Unity Undo?

Yes, absolutely. The engine uses Unity’s native Undo system (specifically Undo.RegisterCreatedObjectUndo, Undo.RecordObject, and Undo.SetTransformParent). Any rearrangement, renaming, atmospheric adjustment, or group creation can be reverted instantly using Ctrl+Z (or Cmd+Z on macOS).

Setup & API Keys

My API key is being rejected with a `403 Forbidden` or `401 Unauthorized` error. What’s wrong?

Gemini: Ensure you copied the full key and that your active provider is set to Gemini. If you are in a country where Gemini API is restricted, you might need to route through OpenRouter.
OpenAI: Ensure your OpenAI account has pre-funded API credits. OpenAI API keys are different from ChatGPT Plus subscriptions; you must have billing credits configured on the Developer Platform.
OpenRouter: Check that the key starts with sk-or- and is copied completely.

How are API keys stored? Are they checked into Git or SVN?

No. Your API Keys are stored in Unity’s local EditorPrefs (on your machine’s local user profile registry/app data folder) rather than inside the Assets/ directory. They are never saved inside scene files or asset files, making them completely safe from accidental commits to version control systems like Git or SVN.

Scene Performance & Large Projects

Will the tool lag on large scenes containing thousands of GameObjects?

The local scanner handles tens of thousands of objects in milliseconds. However, passing a scene with 10,000+ objects to an AI model would exceed token limits and cause slowdowns. To solve this, the AI Director has smart filtering options to only send selected objects, active objects, or a simplified structure. See Large Projects Workflow for detailed guidelines.

What versions of Unity are supported?

AI Scene Organizer supports Unity 2021.3 LTS, 2022.3 LTS, 2023.x, and Unity 6+ (including Unity 6000). Both Built-in Render Pipeline, URP (Universal Render Pipeline), and HDRP (High Definition Render Pipeline) are fully supported.