Scanner does not find a resource

• Confirm that each resource contains fxmanifest.lua or __resource.lua.
• Select the correct parent folder and avoid nesting resources too deeply.
• Confirm that vehicles.meta has valid <InitDatas> and <Item> elements.
• A folder with stream assets but no vehicle metadata may count as a resource without producing vehicle cards.
• Close applications that are locking files and scan again.

A change is not saved or affects the wrong file

• Check the path displayed in the editor before saving.
• Confirm that your Windows account has write permission.
• Do not edit a production or read-only mounted resource.
• Rescan after Code Mode or a rename so application state is current.
• Compare the result with .bak or .backup when available.

Invalid XML or a crashing resource

• Restore the backup or original copy.
• Use the Carcols validator or an external XML editor.
• Look for unclosed tags, missing quotes, unescaped & characters, and truncated <Item> structures.
• Code Mode does not validate XML before saving.

Handling entry is not found

handlingId in vehicles.meta must exactly match handlingName in handling.meta. Confirm that the file belongs to the same resource and was detected by Scanner.

YTD preview fails

• Confirm that the DDS header is valid.
• Formats outside DXT1/DXT3/DXT5/ATI2/BC5 or raw 24/32-bit may not preview.
• BC5 preview requires GPU/WebGL texture-compression support.
• A preview failure does not necessarily mean GTA V cannot read the texture.

YFT or YTD conversion fails

• Confirm that both the temporary drive and output drive have free space.
• Long paths, unusual characters, antivirus software, or file locks can block the converter.
• Reinstall if antivirus quarantined cw-converter or Extractor components.
• Clear the cache, restart the application, and retry with a fresh source copy.

Merger fails

• Duplicate model names: rename one model before merging.
• FXAP detected: do not continue unless the license permits it and you understand the risk.
• Existing output: use a new folder/name and inspect stream filename collisions.

Split produces incomplete or skipped vehicles

The base names of YFT/YTD files must equal the spawn name or use a delimiter such as _hi. Assets with custom naming may need to be split manually. Shared meta files always require a manual audit.

Engine sound is silent

• Start the sound pack before the vehicle resource.
• Match audioNameHash to sound_names.txt or the config prefix.
• Inspect REL/AWC manifest declarations and Sound Pack Builder issues.
• Disable older resources that declare the same sound.

Optimizer damages texture quality

Restore <file>.backup and retry with a higher maximum resolution. Some normal maps or specialized textures should not be forced to BC3 and need manual optimization with the appropriate format.

Sign-in fails or a code expires

• Confirm that 5mdev is reachable and the Windows clock is correct.
• Create a new code and keep the application open during approval.
• Revoke an old device if the activation limit is full.
• If Windows secure credential storage is unavailable, repair the Windows user profile/sign-in. Vehicle Editor will not store the token as plain text.

Update fails

• Sign in again if there is no device token.
• Check that firewall or antivirus software is not blocking 5mdev or the temporary installer.
• On a hash mismatch, do not run the file. Download a fresh installer from the official portal.
• If the app exits but no installer appears, check UAC prompts and antivirus history.

Information to include in a support report

• Vehicle Editor version;
• Windows version;
• feature name and exact reproduction steps;
• complete error message or screenshot;
• relevant folder structure and filenames, without sharing licensed assets;
• whether the original file worked before editing;
• whether the issue also occurs with a fresh copy of the original resource.