Skip to content

GUID Batch Update Tool

When to use it

Use this tool when the scene path or GUID recorded in the browser no longer matches the files in your project.

  • After moving or renaming a scene, check whether its recorded path needs updating.
  • After importing old data or migrating a project, check for missing or mismatched GUIDs.
  • If the main window reports a missing scene file, check whether the original file can still be found.

GUID Tool

Opening the tool

  • Click GUID Tool at the top of the main window.
  • Or choose Tools → CYN-lab → VRCAvatarSceneBrowser → GUID Batch Update Tool.

Interface and features

Buttons and status colors

GUID Tool controls

  • ① Check Data: reloads the scene records and checks whether their paths, GUIDs, and files match.
  • ② Fix All Problems: after confirmation, repairs records whose files can still be found.
  • ③ Show Problems Only: hides normal records so you can focus on items that need attention.

You can also click Fix on a row to repair just that record.

Status Color Meaning Action
Normal Green The path and GUID match, and the file exists No action needed
Path Needs Update / Path Mismatch Yellow The file located by the GUID differs from the recorded path Check the actual path, then fix the record
No GUID / GUID Needs Update Yellow The file exists, but its recorded GUID is missing or incorrect Fix the GUID
File Missing Red Neither the recorded path nor the GUID can locate the scene Check the original file or a backup

A missing scene file also produces an error icon on its thumbnail in the main window.

Missing scene warning

Data columns

Column Contents
Recorded path The scene path saved in the browser
Actual path The path found through the GUID
Status The current check result
Current GUID The GUID saved in the browser record
Actual GUID The GUID of the current scene file
Action Repairs the record when a fix is possible

Notes

  • Repairs modify the plugin's Data/scenes_data.json. You can back up this file before proceeding.
  • Yellow means the record is inconsistent; the scene may still open. Check the actual path first.
  • If neither the original path nor the GUID can find the file, the tool cannot restore the deleted scene.
  • The tool handles scene records only. It does not restore missing avatar objects or screenshot images.