VSA-Mainapp-Release

Game Configuration Guide

The Game Config panel allows you to configure VRChat integration settings and enable automatic metadata extraction for your screenshots.

Note (Integral support status) Integral support is currently in progress. Some Integral camera parameter values may not be recorded or displayed correctly.

Overview

Game Config consists of the following 3 tabs:

Each tab can be switched from the tab menu at the top of the screen.

Access Method:

  1. Click the settings gear icon (⚙️) in the sidebar
  2. Select “Game Config” from the left menu

Tab Composition

Display Settings Tab

This is the default tab. Configure VRChat photo detection and OSC communication.

See “Monitoring Status Management” and “Detailed Settings” sections below for details.

Time Machine Tab

Display VRChat past instance history and rejoin worlds previously visited.

See “Time Machine Feature” section for details.

Server Tab

Monitor VRChat server status and maintenance information.

See “Server Status Feature” section for details.

Monitoring Status Management

Starting/Stopping Monitoring

The monitoring toggle controls whether VSA actively monitors VRChat’s activity.

How to Enable:

  1. Locate the monitoring toggle switch
  2. Click to toggle ON
  3. VSA will now monitor VRChat processes

What Monitoring Does:

Monitoring Status Indicator:

Checking Monitoring Status

Current Status Display:

Detailed Settings (Accordion Sections)

Expand the accordion sections to access detailed configuration options.

Folder Settings

Configure the folders where VSA reads and writes data.

Screenshot Folder:

Metadata Output Folder:

Log Folder:

Folder Path Display with Tooltip:

Auto Functions Settings

Configure automatic processes when VRChat is detected.

Automatic Import:

Automatic Compression:

Background Processing:

OSC Settings

OSC (Open Sound Control) enables camera parameter extraction from VRChat.

OSC Port Configuration:

OSC Communication Overview:

Supported Cameras for OSC:

How OSC Works:

  1. User adjusts camera settings in VRChat
  2. VRChat broadcasts OSC messages with camera data
  3. VSA listens on OSC port and stores the parameters
  4. When screenshot is taken, parameters are embedded
  5. VSA can later display detailed camera information

Verifying OSC is Working:

  1. Adjust a camera parameter (e.g., Aperture) in VRChat
  2. Check VSA logs for OSC messages
  3. Open Developer Mode to see OSC statistics
  4. See Troubleshooting section if no data received

Saving Settings

Changes to Game Config settings are automatically detected.

Auto-Save Behavior:

Change Indicators:

Important: Do not close the app immediately after changing settings - allow a moment for changes to save.

Troubleshooting

Monitoring Cannot Be Started

Symptom: Toggle switch won’t enable or monitoring shows as inactive

Causes and Solutions:

VSA doesn’t have permission to monitor VRChat:

  1. Run VSA as Administrator
    • Right-click VSA shortcut → “Run as Administrator”
  2. Check Windows Defender isn’t blocking VSA
    • Open Windows Security
    • Add VSA to Firewall exceptions
  3. Disable antivirus monitoring temporarily
    • Some security software blocks process monitoring

VRChat isn’t installed or not running:

  1. Install VRChat from official source
  2. Launch VRChat at least once to initialize
  3. Close VRChat completely before testing VSA monitoring
  4. Try toggling monitoring again

Metadata Not Extracted

Symptom: World names and user information showing as “Unknown”

Check VRChat Log Output:

  1. Confirm VRChat is outputting logs
  2. Check location: C:\Users\[Username]\AppData\LocalLow\VRChat\VRChat\
  3. Look for output_log_*.txt files dated today
  4. If not found, VRChat logging may be disabled

Verify Game Config Settings:

  1. Open Game Config panel
  2. Confirm “Metadata Output Folder” is set to VRChat log directory
  3. Verify folder path is correct
  4. Try changing to absolute path if using shortcuts

Test Metadata Extraction:

  1. Open VRChat and enter a world
  2. Wait 5-10 seconds for world information to be logged
  3. Take a screenshot in VRChat
  4. Return to VSA and check if metadata appears
  5. If still not working, check troubleshooting below

OSC Communication Not Established

Symptom: Camera parameters not showing in screenshot details

Verify VRChat OSC Settings:

  1. Open VRChat Settings
  2. Navigate to OSC configuration
  3. Ensure OSC is enabled
  4. Confirm port matches VSA setting (default 9001)
  5. If port is different, update VSA to match

Check Port Availability:

  1. Open Command Prompt (Windows + R, type cmd)
  2. Run: netstat -ano | findstr :9001
  3. If port is in use, change to different port:
    • VSA: Change “OSC Port” to 9002
    • VRChat: Change OSC port to 9002
  4. Restart both applications

Test OSC Connection:

  1. Start VSA and enable monitoring
  2. Open VRChat
  3. Select VirtualLens2 camera
  4. Adjust Aperture slider
  5. Return to VSA and check logs
  6. Look for OSC message confirmation

Enable Developer Mode for OSC Debugging:

  1. Go to Settings > Developer Mode
  2. Enable Developer Features
  3. Check OSC statistics in Developer panel
  4. Review received/sent message counts

Configuration File Corruption

Symptom: Settings reset to defaults or won’t save

Solution:

  1. Close VSA completely
  2. Navigate to: %APPDATA%\VSA\
  3. Delete config.json file
  4. Restart VSA
  5. Reconfigure Game Config settings

Time Machine Feature

Time Machine tab displays VRChat past activity history and rejoin previously visited instances.

VRChat Timeline Feature

Auto-analyze VRChat log files and visualize activity history.

Displayed Information:

Timeline View:

  1. Open Time Machine tab
  2. VRChat log files auto-analyze
  3. Timeline shows activity events
  4. Click event for details

Instance History Display

View list of previously visited instances.

Display Information:

Item Description
World Name VRChat world name
Instance ID Instance identifier
Visit Time Last visited date/time
Stay Duration Time spent in instance
User Count Users present at visit

List Operations:

Rejoin from History

Directly rejoin from instance history.

Rejoin Steps:

  1. Select instance to rejoin from history
  2. Click “Rejoin” button
  3. Auto-generate instance URL
  4. Rejoin dialog displays in VRChat
  5. Confirm to rejoin

Copy Instance URL:

  1. Select instance
  2. Click “Copy URL” button
  3. Instance URL copies to clipboard
  4. Paste in VRChat Jump screen to move

Use Cases and Examples

Example 1: Revisit Favorite World

  1. Find world in Time Machine
  2. Click “Rejoin”
  3. Move in VRChat executed

Example 2: Confirm Event World

  1. Filter by event date
  2. Confirm visited worlds
  3. Revisit memory worlds

Example 3: Move to Friend’s World

  1. Check friend’s timeline event
  2. Discover common visited world
  3. Rejoin with same world

Notes

Log File Required:

Private Instances:

History Retention:

Troubleshooting

Instance History Not Displaying:

  1. Check Log Folder setting
    • Verify “Log Folder” setting correct in Display Settings Tab
  2. Enable VRChat logging
    • Confirm logging enabled in VRChat settings
  3. Check recent logs
    • Launch VRChat, move world, check log generation

Server Status Feature

Server tab monitors VRChat server status and maintenance information.

VRChat Server Status Display

Display official VRChat server status in real-time.

Display Information:

Item Description
Server Status Online/Offline/Maintenance
Status Icon Visual status display
Last Update Status last updated date/time
Details Maintenance time, etc.

How to Read Status:

Maintenance Information

View VRChat maintenance information.

Maintenance Information Content:

Update Method:

  1. Click “Update” button for latest info
  2. Auto-update periodically (default: every 5 minutes)

Status Send Settings

Configure status sending to VRChat.

Enable/Disable Status Send

Toggle sending VSA status to VRChat.

When Enabled:

When Disabled:

Update Interval Setting

Configure status update frequency.

Setting Values:

Recommended: 5-10 minutes (adjust per environment)

Usage Examples

Example 1: Confirm Maintenance Time

  1. Open Server tab
  2. Check maintenance info
  3. Connect after end time

Example 2: Check Server Issue

  1. Unable to connect to VRChat
  2. Check Server tab status
  3. If “red”, server-side problem possible
  4. Contact support before troubleshooting

Troubleshooting

Status Info Not Updating:

  1. Check internet connection
    • Test internet with other apps
  2. Check firewall settings
    • Confirm firewall not blocking VSA
  3. Manual update with “Update” button
    • Periodic update may have failed
  4. Restart app
    • Completely restart VSA

Tips