VRChat vrchat:// protocol launch URL is not generated correctly #1200

New Issue

MrUnknownDE · 2026-04-05T17:00:32+02:00

MrUnknownDE commented

2026-04-05 17:00:32 +02:00

Originally created by @64766C on 9/21/2022

When you click an invitation in notifications and select a private instance this popup shows up:

The launch URL here is not correctly generated as nowadays it requires shortName parameter.

Correct launch URL for a private instance looks like this: vrchat://launch?id=wrld_4432ea9b-729c-46e3-8eaf-846aa0a37fdd:37056~private(usr_353f05b1-3210-4640-b362-412e4f7c3743)~region(eu)~nonce(ED032C699F638DD986C659A4B18459F9E81E135D2688DDE9)&shortName=k7pw7nu5

VRCX does not include the shortName so trying to join a world with it ends up in error and you get sent to a local error world:

You can get the shortName with this request:

GET /api/1/instances/wrld_4432ea9b-729c-46e3-8eaf-846aa0a37fdd:37056~private(usr_353f05b1-3210-4640-b362-412e4f7c3743)~region(eu)~nonce(ED032C699F638DD986C659A4B18459F9E81E135D2688DDE9)/shortName HTTP/2
Host: vrchat.com
Cookie: cookies removed
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:105.0) Gecko/20100101 Firefox/105.0
Accept: application/json, text/plain, */*

Example response:

HTTP/2 200 OK
Date: Wed, 21 Sep 2022 10:25:01 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 42
X-Powered-By: vampires, or, at least, a bunch of people who never see the sunlight and cant digest garlic bread
Cache-Control: private, no-cache, no-store
Pragma: no-cache
X-Jobs: Like poking around our API? Come apply to work for us instead. https://vrchat.com/careers
Vary: Authorization, Accept-Encoding
Access-Control-Allow-Credentials: true
X-Frame-Options: deny
Etag: W/"2a-YEMuPZM0A3zMCRjKQzJ+0ockxbY"
Cf-Cache-Status: DYNAMIC
Server: cloudflare
Cf-Ray: 74e21830295595e2-ARN

{"shortName":null,"secureName":"k7pw7nu5"}

For whatever reason it seems that the secureName in the reponse is the value that should be used.

*Originally created by @64766C on 9/21/2022* When you click an invitation in notifications and select a private instance this popup shows up: ![image](https://user-images.githubusercontent.com/100468852/191482065-606b0648-961b-4f14-8b2e-14eff127c84d.png) The launch URL here is not correctly generated as nowadays it requires shortName parameter. Correct launch URL for a private instance looks like this: vrchat://launch?id=wrld_4432ea9b-729c-46e3-8eaf-846aa0a37fdd:37056~private(usr_353f05b1-3210-4640-b362-412e4f7c3743)~region(eu)~nonce(ED032C699F638DD986C659A4B18459F9E81E135D2688DDE9)&shortName=k7pw7nu5 VRCX does not include the shortName so trying to join a world with it ends up in error and you get sent to a local error world: ![image](https://user-images.githubusercontent.com/100468852/191482579-6cd3096e-0e41-49b9-b08b-bc54abdbfbe8.png) You can get the shortName with this request: ``` GET /api/1/instances/wrld_4432ea9b-729c-46e3-8eaf-846aa0a37fdd:37056~private(usr_353f05b1-3210-4640-b362-412e4f7c3743)~region(eu)~nonce(ED032C699F638DD986C659A4B18459F9E81E135D2688DDE9)/shortName HTTP/2 Host: vrchat.com Cookie: cookies removed User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:105.0) Gecko/20100101 Firefox/105.0 Accept: application/json, text/plain, */* ``` Example response: ``` HTTP/2 200 OK Date: Wed, 21 Sep 2022 10:25:01 GMT Content-Type: application/json; charset=utf-8 Content-Length: 42 X-Powered-By: vampires, or, at least, a bunch of people who never see the sunlight and cant digest garlic bread Cache-Control: private, no-cache, no-store Pragma: no-cache X-Jobs: Like poking around our API? Come apply to work for us instead. https://vrchat.com/careers Vary: Authorization, Accept-Encoding Access-Control-Allow-Credentials: true X-Frame-Options: deny Etag: W/"2a-YEMuPZM0A3zMCRjKQzJ+0ockxbY" Cf-Cache-Status: DYNAMIC Server: cloudflare Cf-Ray: 74e21830295595e2-ARN {"shortName":null,"secureName":"k7pw7nu5"} ``` For whatever reason it seems that the secureName in the reponse is the value that should be used.

MrUnknownDE closed this issue

2026-04-05 17:00:32 +02:00

Sign in to join this conversation.

No Label Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done Done

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github/VRCX#1200