Community:VRCX

From VRChat Wiki
Revision as of 19:30, 23 September 2024 by Tony Lewis (talk | contribs) (Add launch parms + json)
Vrrat posed-right.png
V ยท EThis page is a stub.
You can help the VRChat Wiki by improving it.
[Reason: No reason provided.]
IconOnly CL Portal.png
V ยท ECommunity-written content
The following was created by the community. It may contain material not directly endorsed by the VRChat team. To learn more, consider reading Contributing to the VRChat Wiki.

VRCX is an assistant/companion application for VRChat that provides information about and helps you accomplish various things related to VRChat in a more convenient fashion than relying on the plain VRChat client (desktop or VR), or website alone.

It also includes some other neat features outlined below.

Getting Started

Download and install the latest installer (VRCX_Setup.exe) from ["here"]

Beta/nightly build available ["here"] or in-app Settings -> General -> Change build.

Features

๐Ÿ‘ช Friend, world, and avatar list management

  • Manage your friends list, world/group/avatar lists outside of VRChat.
  • Monitor the world/avatar activity of your friends and check their online status.
  • Keep track of when you first added them and when you last saw them.
  • See how much time you've spent together in worlds and how many times.
  • Keep track of friend name changes.
  • Save notes to help remember how you met.

๐Ÿ”Œ Automatically launch apps when you start VRChat

  • You can configure VRCX to launch other apps when you start VRChat.
For example, you could have VRCX launch an OSC app or a voice changer app when VRChat opens up.

๐Ÿ’พ World Persistence

For worlds that support the feature, VRCX can save world settings, save states, inventories, and other data!

Note: To use this feature, you must have "Allow Untrusted URLs" enabled in your VRChat settings.

For Developers: ["Wiki Page - World Persistence (PWI)"]

๐Ÿ” Search for avatars, users, worlds, and groups

๐ŸŒŽ Build a local, unrestricted world favorites list

๐Ÿ“ท Store world data in the pictures you take in-game

You can remember that one world you took those cool pictures in like... 6 months ago!

๐Ÿ”” Monitor/respond to notifications

You can send/receive invites and friend requests from VRCX as well as see the instance info of invites that you receive.

๐Ÿ“œ See stats/players for your current instance

๐Ÿ“บ See the links to videos and that are playing in the world you're in

As well as various other logged data.

๐Ÿ“Š Improved Discord Rich Presence

You can optionally display more information about your current instance in Discord.
World integration for popular worlds like PyPyDance, LSMedia, Movies&Chill and VRDancing.
This includes the world thumbnail, name, instance ID, and player count, depending on your settings and whether the lobby is private. 
You can also add a join button for public lobbies!

๐Ÿ”ฎ VR Overlay with configurable live feed of all supported events/notifications

๐Ÿ“ค Upload avatar/world images without Unity

๐Ÿ“„ Manage and edit uploaded avatar/world details without Unity

๐Ÿ’€ Automatically restart and join last instance when VRC crashes

โ†”๏ธ Export/import favorite groups

Miscellanous

  • Want a new look for VRCX? Check out Themes
  • See Building from source for instructions on how to build VRCX from source.
  • For a guide on how to run VRCX on linux, see here
  • If you looking for VRCX on Android, there is third-party project, see here

Common Issues

VRCX wont open or opens to a white screen

This can be caused by a many different things here's a list of things to try:

  • Install Microsoft Visual C++ Redistributable 2019.
  • Reboot your computer, maybe another process is trying to read the database file.
  • Disable antivirus software, Avast and AVG are known to delete Cef/VRCX.
  • Remove AVerMedia AssistCentral this is known to cause problems with VRCX for some unknown reason.
  • Run VRCX as administrator, this can fix it on some rare occasions.
  • Test a fresh database, first close VRCX then backup your current database by opening %AppData% and renaming the VRCX folder to something like VRCX.Backup, if this solves it but you'd like to still keep your data follow the steps bellow on how to repair your database.

VRCX running slow

  • Settings > Appearance > Max Table Size
  • Lower this value to something like 100 this will decrease the amount of table entries *Settings > Advanced > Auto Clear Cache
  • Lower this interval to something like 3 hours this will decrease the amount of unnecessary worlds, users and avatars stored in RAM.

SteamVR Overlay not working

  • Disable SteamVR safe mode.
  • If your computer has an iGPU follow these steps.

How to repair VRCX database

   Method.1
  • Close VRCX.
  • Install DB Browser for SQLite.
  • File > Open Database...
  • Browse to %AppData%\VRCX\ then select VRCX.sqlite3.
  • File > Export > Database to SQL file...
  • Click Save and place the file somewhere.
  • File > Close Database
  • Rename VRCX.sqlite3 in %AppData%\VRCX\ to something like Backup.sqlite3.
  • File > Import > Database from SQL file...
  • It will immediately ask you where to save the newly created database, save it in %AppData%\VRCX\ as VRCX.sqlite3.
  • File > Write Changes.
  • Close DB Browser and delete the no longer needed VRCX.sqlite3.sql export file.
  • Start using VRCX as usual.
   Method.2 (if method.1 not works)
  • Close VRCX.
  • Rename VRCX.sqlite3 in %AppData%\VRCX\ to something like Backup.sqlite3.
  • Install DB Browser for SQLite.
  • File > Open Database...
  • Browse to %AppData%\VRCX\ then select Backup.sqlite3.
  • File > Save Database As
  • It will immediately ask you where to save the newly created database, save it in %AppData%\VRCX\ as VRCX.sqlite3.
  • Close DB Browser and start using VRCX as usual.

Keyboard Shorcuts

  • Ctrl + Shift + I open Chromium DevTools.
  • Ctrl + R restart VRCX.
  • Shift + Alt + R reload custom css.

Launch parameters & VRCX.json

VRCX Launch parameters

  • --debug launch Chromium DevTools with VRCX.
  • --config="C:\VRCX" set a custom path for VRCX's config and database.
  • --proxy-server="127.0.0.1:8080" set a HTTP/SOCKS proxy server for VRCX to use.

VRCX Protocol/Launch Commands

  • vrcx://user/usr_id open VRCX user dialog.
  • vrcx://avatar/avtr_id open VRCX avatar dialog.
  • vrcx://group/grp_id open VRCX group dialog.
  • vrcx://world/wrld_id open VRCX world dialog.
  • vrcx://world/wrld_id:12345 open VRCX world dialog with instance.
  • vrcx://world/https://vrch.at/0gmbxjpj open VRCX world dialog with unlocked instance.
  • vrcx://import/avatar/avtr_id,avtr_id... open VRCX avatar favorites import dialog.
  • vrcx://import/world/wrld_id,wrld_id... open VRCX world favorites import dialog.
  • vrcx://import/friend/usr_id,usr_id... open VRCX friend favorites import dialog.
  • vrcx://addavatardb/https://website/vrcx_search.php open VRCX remote avatar database provider dialog.

VRCX.json

  • VRCX_DatabaseLocation set a custom path for SQLite database, e.g. C:\\VRCX.sqlite3
    • NOTE when moving your VRCX.sqlite3 database be sure to move VRCX.sqlite3-shm and VRCX.sqlite3-wal as well, if they exist.
    • NOTE be sure to replace every backslash in the path with 2 backslashes to insure the JSON is valid.
  • VRCX_ProxyServer set a HTTP/SOCKS proxy server for VRCX to use, e.g. 127.0.0.1:8080

Is VRCX against VRChat's TOS?

No.

VRCX is an external tool that uses the VRChat API to provide the features it does.

It does not modify the game in any way, only using the API responsibly to provide the features it does. It is not a mod, or a cheat, or any other form of modification to the game.

To see VRChat's stance on API usage, see the #faq channel in the VRChat Discord.

Disclosure

VRCX is not endorsed by VRChat and does not reflect the views or opinions of VRChat or anyone officially involved in producing or managing VRChat properties. VRChat and all associated properties are trademarks or registered trademarks of VRChat Inc. VRChat ยฉ VRChat Inc.

Screenshot