Troubleshooting

Problems are organized by the step where they show up. If you do not see yours here, the FAQ covers the common questions, and the Discord is the fastest place to get a human.

The first aid kit

Three tools fix most problems on their own, in this order:

1. Try it again. Most one-off failures, like a network hiccup mid download, clear on a retry. LAS is built so a failed step leaves nothing broken behind.
2. Verify an item’s files. In the Wardrobe or Library, open an item’s menu and choose Verify files. LAS compares the files on disk against the record made at import and tells you if anything is missing or changed, and re-importing the item repairs it.
3. Run a data check. In Settings, the data check looks over your library, projects, and settings and repairs what it can. Anything unreadable is set aside for review, never deleted, and Open set-aside items shows what was put aside.

Setup and install

Setup is taking a long time the first run. The first avatar installs Unity itself, which is a large download. Windows asks for permission up to two times, choose Yes both times, and everything else runs on its own. You can keep using your PC meanwhile.

Setup is waiting at “Unity Hub needs a quick setup”. Unity requires a one-time sign-in before its editor can be installed. Open Unity Hub from your system tray, accept its terms, and sign in or create a free account (the Personal plan is fine). If Unity Hub offers to install the latest Unity editor, ignore it, since LAS installs the exact version it needs. Press Continue in LAS afterwards and setup picks up where it left off.

Setup did not finish. Nothing was left behind, so you can just try again. If it fails the same way twice, check your internet connection and free disk space, then ask in the Discord with the message you saw.

Import and library

An import failed with “the file looks damaged or incomplete”. The download did not complete. Download the product again from the store and re-import.

An import failed with “files could not be written”. Check free disk space, and check that your antivirus is not blocking LAS from writing to its data folder.

An item is waiting with a Review button. That is not an error. LAS could not identify the product automatically and never guesses silently, so press Review, answer a few questions, and the item goes straight into your wardrobe.

An item imported but its materials are missing. Some products ship textures or materials as a separate download. Import that package into the Library too and it pairs up automatically.

An item shows “The item’s files are no longer on this PC”. The files were moved or deleted outside LAS. Re-download or re-import the item, and if you use disk cleanup tools, exclude the LAS data folder.

An import seems stuck. Large outfits genuinely take a while to unpack. LAS watches for real stalls and ends them with an error rather than waiting forever, so leave it running. If it ends with a timeout, try the import again.

File names look garbled after unpacking elsewhere. If you unzipped a Japanese product with another tool first and got garbled names, delete that copy and drop the original archive into LAS instead. LAS unpacks Japanese archives with the correct encoding on its own.

Customize

An outfit will not attach automatically. A small number of products have no standard outfit skeleton and do not set themselves up with Modular Avatar. LAS tells you when an item needs manual setup in Unity rather than guessing at it. Ask in the Discord before spending money on a fix, since often there is a simpler route.

A morph slider seems to do nothing. VRChat reserves some face shapes for lip sync and blinking and drives them in game. LAS labels those, and your edit shows whenever the reserved use is idle.

Ability changes saved but were not applied. Your menu needs more expression memory than VRChat allows. Remove an ability or two, or continue and let the build try to compress the menu. The Abilities panel shows the running total, where a toggle costs 1 bit and a slider costs 8.

“Your avatar is missing from the Unity scene.” This can happen if the underlying Unity project was opened and closed by hand without saving. Follow the prompt to rebuild from a fresh project. Your wardrobe, styles, and abilities are all records LAS keeps, so the rebuild restores your avatar.

A style edit looks different in game than in the preview. AudioLink effects react to world audio, which the preview does not have, and reserved face shapes can be driven by VRChat itself. Both are worth checking in game before assuming an edit failed.

Test

The first test takes a minute. Starting Unity, entering play mode, and building with VRCFury all happen on the first run, and the status line narrates each stage. Tests after the first are much faster.

The test ended with “test objects were left in the scene”. Restart this avatar’s Unity editor from the Projects page before uploading, exactly as the message says. This clears the leftover test state so an upload cannot pick it up.

Physics feel wrong in the test. Note which chain, exit the test, and adjust its preset or Custom knobs in the Physics panel. Testing again is quick, so iterate freely.

Upload

Go Live explains most problems inline, and its checklist must be green before Upload to VRChat unlocks. The errors after that point:

“You’re not logged into VRChat in Unity anymore.” Try again and log in when the VRChat panel appears. Logins expire from time to time, and LAS never stores or refreshes them for you, by design.

“Unity’s VRChat panel wasn’t open.” Just try again. LAS opens it for you.

“VRChat’s checks refused this avatar.” The technical reason is shown below the message. Some refusals need a fix in the Studio, and the Discord can help translate the reason into a fix.

“This avatar belongs to a different VRChat account.” Avatars update only from the account that first uploaded them. Log into that account, or upload as a new avatar from your current one.

“Nothing has changed since the last upload.” Not an error. VRChat skipped the upload because the avatar is identical to what is already there.

“VRChat couldn’t be reached” or the transfer failed partway. Check your internet connection and try again. Nothing is left half uploaded.

The performance rank came back lower than expected. Go Live reports which stats are over VRChat’s limits, each shown next to the limit itself. Heavy textures, many meshes, and many physics chains are the usual causes. The optimization helpers can trim physics and merge meshes to fit the Poor limits, and removing a worn item or two is the manual route.

Still stuck?

• Ask in the Discord. Include what you were doing and the exact message you saw.
• Or write to [email protected].
• Settings can export a report file with the app’s local logs, and nothing in it leaves your PC unless you share it yourself. Attaching one speeds up help a lot.