FAQ and troubleshooting
Start with the narrowest relevant check. Unity's Console and the Xorin tool rows usually contain more useful evidence than retrying the same request unchanged.
Installation
Xorin does not appear in the Unity menu
Confirm the project is running Unity 2022.3 LTS up to Unity 6.6, and on a Mac, that the computer has Apple Silicon; Intel Macs are not supported. Open Package Manager and verify that the Xorin package installed without package-resolution or compilation errors. If Unity cannot download it, confirm Git is installed and available from your terminal, then restart Unity and confirm the Xorin package appears as installed in Package Manager. Return to the installation guide to review the complete setup.
Accounts and providers
A request using Xorin credits says I am unauthenticated or out of credits
Open Settings, select Xorin account, sign in again, and check the displayed balance. Authentication errors and credit errors are separate; adding a BYOK key does not add Xorin credits.
Xorin asks me to sign in again
Your sign-in expired. Xorin starts the Unity ID sign-in for you; a message you send meanwhile waits and is sent once you are signed in.
A message says the model is no longer available
The model you selected is no longer offered, and you were not charged. Pick another model in the composer, or for the Strategy model, in Settings. Xorin usually switches to a replacement automatically. See model selection.
Context and indexing
Xorin cannot find a recently added file
Wait for Unity's asset import and Xorin's workspace indexing to
finish; indexing progress and completion are reported in the Unity
Console. Try an exact @filename mention. If the asset
remains missing, reimport it in Unity and start a new chat to avoid
stale conversation assumptions.
A dragged item is skipped
Wait for workspace indexing to finish and confirm the item is a
supported image, Hierarchy GameObject, component, indexed project
folder, script, prefab, ScriptableObject, material, scene, shader or
Shader Graph, or allowlisted text, configuration, or Unity UI file.
Non-image files and folders must be under the indexed
Assets or Packages roots. External non-image
files and folders, .meta files, audio clips, animation
clips, models, and other non-allowlisted assets cannot be dropped
directly. For example, .yaml is supported but
.yml is not. Use an @ mention when available.
The context ring is nearly full
The indicator is informational. Start a new chat, remove unnecessary mentions or images, and put only stable conventions in project memory.
A reused prompt is missing mentions or attachments
Reuse restores only references that remain available. Re-add any item named in the notice, and review the complete request before sending it. Reuse is disabled while another request is running and asks before replacing an existing composer draft.
Incomplete responses
The request paused at its turn limit
Use the inline card to add turns and resume, or select Stop. Open Adjust… to apply the increased limit to this request, this chat, or the device default. This resumes the paused request. See agent turn limits for details.
The response reached its output limit
Xorin preserves the partial response and displays Continue. Select it to start a follow-up request that finishes the incomplete task without repeating completed work. If the composer contains a draft, Xorin asks before replacing it.
Error messages
A request ended with an error card
Error cards name the model and explain the problem in plain words. Xorin retries temporary provider errors automatically and shows Retrying… while it waits. If the error remains, select Try again, or pick another model. The card says when you were not charged. Quote the Error ID when contacting support.
A request paused at its spend limit
A request pauses when it has spent $5. Select Continue to allow another $5, or Stop. If you stop, Xorin shows what the request cost and what it changed, so asking again does not repeat finished work. Scripts waiting to be applied are applied when you stop. If any are not kept, the chat history says so and the script row reads not applied.
Slow responses and timeouts
The Strategy model is taking a long time
Strategy models can spend time reasoning before displaying a response. Xorin recognizes gateway activity while a response is still being prepared. You can wait for the result or stop the request from the composer.
The request ended with a gateway timeout
The model stopped sending data, or the response ran past the service's overall time limit. Review any changes already applied, then retry with a smaller, focused request. If the issue repeats, use the task's Report action to send diagnostic information to support.
Scripts and compilation
A script request fails during compilation
Expand the tool result and check Unity's Console. Xorin performs bounded automatic repair and then attempts to restore and recompile the affected scripts if it cannot reach a fresh successful compile. If rollback is unavailable or cannot be verified, the result identifies the paths that require manual recovery. Xorin also repairs new errors in files the change did not write, and keeps a change when the only errors were already in the project.
An editor script stopped after 30 seconds
Xorin stops an editor script that is still running after 30 seconds so Unity does not freeze. The message says what was undone. Ask Xorin to do the work in smaller batches.
Compilation passed but the feature does not work
Compilation proves that the code compiled, not that runtime references or behavior are correct. Inspect serialized fields, run Play & Check, and reproduce the relevant interaction manually.
Changes and recovery
Should I use Keep changes or Undo changes?
Select View changes and inspect every accumulated script diff and Unity operation. Keep retains the whole active checkpoint; Undo restores its baseline. A pending checkpoint may contain changes from multiple requests, and selective per-file decisions are not currently available.
Why did Auto-keep not run?
Auto-keep runs only after normal request completion when every change in the active checkpoint succeeded on its latest attempt. Cancellations, request errors, partial work, or a change that still failed remain in manual review.
Xorin asked before deleting something
Xorin asks before deleting an object, component, asset, tag, or layer that the current request did not create. Choose Delete or Keep; your answer applies for the rest of the request.
Why are successful tool steps no longer visible?
Xorin keeps ordinary successful execution details out of the completed response by default. Open Settings and enable Show detailed work activity to expose the retained steps. Failures and interruptions remain visible regardless of this preference.
Task reports
I cannot submit a task report
Sign in to Xorin, choose a reason, and retry. If the session expired, sign in again and explicitly select Submit report; sign-in does not submit the form. For a size error, remove the screenshot or untick Include the chat. Network failures keep the form available for an explicit retry and are not silently queued.
How do I use a task report ID?
After submission, copy the confirmation ID shown in the report dialog and include it when contacting support. The task's Report action then shows the submitted ID; selecting it copies the ID again. Older tasks created before request IDs were retained may not be reportable.
See Report a task for the included data, consent controls, and retention periods.
Addressables
Addressables support is unavailable
Confirm that com.unity.addressables 1.19.0 or newer is
installed and let Unity finish compiling and importing. Xorin does
not install or upgrade the optional package. If settings do not yet
exist, ask Xorin to initialize Addressables before creating groups
or entries.
An Addressables content build is refused
Content builds require an explicitly approved Plan-mode step, an
exact existing profile, and a build target equal to Unity's current
active target. Content-update builds also require the previous
content-state .bin file. Exit Play Mode and wait for
compilation, import, or another build to finish before retrying.
Testing and generation
Play & Check did not prove the behavior I expected
It observes a bounded Play Mode window and can simulate clicks and key presses in projects using the Input System, but it does not cover every input path or judge game feel. The answer says when player input was not tested. Reproduce the interaction yourself or add project tests.
An asset-generation job failed
For image, 3D, or audio generation, select Xorin account in Settings, sign in, and check your Xorin credit balance. Then simplify the prompt and confirm supported settings. Provider availability and output formats can change. A failed generation is not charged, and Xorin continues the rest of the request. A failed external generation job may not be recoverable through Undo changes.
Known scope boundaries
- Xorin does not build, publish, or ship the game.
- Animator automation currently supports the base layer and Simple 1D blend trees, not 2D blend trees or layer management.
- Structured tools do not cover every Inspector field, Project Settings page, or arbitrary asset operation.
- Editor performance reports are not substitutes for profiling a development build on target hardware.