Skip to content

Pathos0925/WhosThatAvatar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

51 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WhosThatAvatar

  • Find and view public VRChat avatars.
  • Search public worlds for avatars by name, author, or description. (Experimental)

WhosThatAvatar no longer works with the latest version of Vrchat and is not being maintained!

How To Use

EITHER:

  • Download the source (compatable with Unity 5.6.3p1.) and run it in the Unity editor
    • (Recommended with highest compatability)
  • OR Use the web app here: [website is offline] (with limited compatability, see below)
  • OR download the compiled windows standalone player.

Controls

  • After loading an avatar, Hold left mouse button and drag to rotate around the avatar.
  • Hold right mouse button and drag to pan up and down.
  • Use the scroll wheel to zoom in and out.

Find and Browse Avatars

  • Clickt he "Find an Avatar" button in the top left corner.
  • Check "Search worlds" to scan indexed public words for avatars. Uncheck to browse all avatars.

Load an avatar from an avatar ID

Every avatar is identified with a unique ID, which usually starts with avtr_. Type or paste this into the search bar at the top, or in the url (after ?avater=) if using the web app.

Web App Limitation

The Unity WebGL web application currently has the following restrictions:

  • Limited shaders. Most shaders will be replaced with the standard shader.
  • API requests are sent through a CORS proxy as VRChat's API does not include CORS headers.
  • Loading may take up to 8 seconds or more, depending on your browser and specs. Firefox seems to work the best.
  • Some avatars may not work.
  • Large files may result in an out of memory error.

To paste an avatar ID into the web app,

  1. set the avatar querystring to the avatar ID you want to find. After "Avatar=" add the avatar ID. E.g https://[website is offline]/?avatar=avtr_e6b76bcf-ffab-45cc-85e2-c4ac1bd16e0f

FAQ

Is this allowed?

VRChat's stance on public use of the VRChat API, per Tupper on the VRChat discord:

Regarding reverse engineering our API - Our stance here is don't be malicious. This is unsupported and it might break.

Along those lines, at preasent, only public avatars can be viewed.

I dont want my avatar viewable

  • Add an empty child gameobject to your avatar with the name: WTA_IGNORE Instead of being viewed your avatar will give an error.

How does the search work?

Searching uses a cached DB of scanned worlds and allows:

  • Searching by Name, Author, or Description.

  • Faster search results

  • Finding avatar locations

  • Eases the load on VRChat's API

  • Only public avatars that can be found in a public world are added to the cache. At preasent there are about +8000 indexed avatars.

  • It's a serverless stack built on AWS to scan and track public worlds and avatars.

  • Updated worlds are scanned periodically for avatars and added to the cache.