Avatar Board - VRChat World Prefab
- Digital0 JPY
This is a batch loader for avatar pedestals in VRChat! Have fun sharing your favorite avatars with friends!
Demo World
https://vrchat.com/home/world/wrld_a6f048b2-0345-458a-bdd5-b464aa6f0b70
Setup Guide
1. Create a working VRChat world. Documentation: https://creators.vrchat.com/worlds/ 2. Import Avatar Board's Unity Package file. 3. Locate Avatar Board and place it inside the scene hierarchy in Unity's Hierarchy window. (Assets > BestTomodachi > System > AvatarBoard > AvatarBoard_{Version} > AvatarBoard_{Version}.prefab) Import TextMesh Pro Essentials if prompted. If Avatar Board's text isn't visible after importing TextMesh Pro, you can try removing and re-adding it to the scene. Text might appear incorrectly if the original TextMesh Pro materials are modified, but you can reimport them. There are three public variables you can edit on the top level of Avatar Board's hierarchy: FeaturedList, FeaturedListName, and FeaturedListDescription. If you want to configure Avatar Board to load your own lists of avatar IDs, you can populate the FeaturedList array. Change its size to the number of lists you would like to have. For each list, input a string of avatar IDs or input a URL that returns a response containing avatar IDs. Optionally, the response format can be ID:NAME on separate lines, which will cause NAME to be placed into the text field overlaying the avatar pedestal image instead of the avatar ID. FeaturedListName is the name you want to display for the avatar list as a whole, FeaturedListDescription is the description you want to provide for the avatar list as a whole, and both are optional. Initial loading priority is given to the first element of FeaturedList if populated with non-whitespace; otherwise, the synchronized list will have initial loading priority.
Additional Explanation
If you are trying to use it as a player in the world, you can interact with the "Synchronized List" button if present on the bottom-left, the menu button labeled "Avatar Board" in the bottom-center and any list buttons on the menu, the page input field and arrows on the bottom-right, and the avatar pedestals and overlaying text fields when IDs are loaded to them; however, the pedestals will not be visible if the menu is open. The menu allows for players to switch lists if the world author has added at least one, and the system will load the first list on start if it contains non-whitespace characters; otherwise, the synchronized list will be the only list. Player input to the synchronized list works much like it does for lists configured by the world author. If you are trying to use it as a world author, then you can set values for these public variables on the UdonBehaviour component prior to upload: FeaturedList FeaturedListName FeaturedListDescription These three array variables start with a size of one, but world authors can increase the size value of each array to fit their need. The count starts from zero, so these arrays initially contain only index zero. Values for each index can be set from within Unity's Inspector window. The values set to the UdonBehaviour component of the game object in the scene hierarchy will be used. Example value for FeaturedList: avtr_c38a1615-5bf5-42b4-84eb-a8b6c37cbd11avtr_d720f33e-ed8d-4b1e-8d74-9735e17c87d5 Example value for FeaturedListName: VRChat Robots Example value for FeaturedListDescription: These robots have been used as the default avatars of VRChat. A single URL beginning with "https://" is also an acceptable value for FeaturedList. The benefit of using a URL is that you can change the IDs without updating the world, and you can easily display custom names instead of avatar IDs. Example value for FeaturedList with a whitelisted domain: https://gist.githubusercontent.com/GithubUsername/58aebbf0a2e7c5def6eb14dda338e0a2/raw/avatars.txt This example URL doesn't point to an existing file, but a valid URL could point to a file with content such as this: avtr_c38a1615-5bf5-42b4-84eb-a8b6c37cbd11:Robot avtr_d720f33e-ed8d-4b1e-8d74-9735e17c87d5:Robot Kyle IDs are detected by a regular expression. You can test input here: https://regex101.com/?regex=avtr_%5B0-9a-f%5D%7B8%7D-%5B0-9a-f%5D%7B4%7D-%5B0-9a-f%5D%7B4%7D-%5B0-9a-f%5D%7B4%7D-%5B0-9a-f%5D%7B12%7D%28%3F%3A%3A.%7B1%2C64%7D%29%3F&testString=avtr_c38a1615-5bf5-42b4-84eb-a8b6c37cbd11%3ARobot%0Aavtr_d720f33e-ed8d-4b1e-8d74-9735e17c87d5%3ARobot+Kyle&flags=g&flavor=dotnet&delimiter=%22 In simplified terms, it's basically one of these two where X is 0-9 or a-f: avtr_XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX avtr_XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:Custom Avatar Name When using the format with a name, input should be on separate lines that terminate with the LINE FEED character. If input can't be on separate lines, names can be padded to 64 characters with whitespace.
Where to Find Avatar IDs
You can go to https://vrchat.com/home/avatars to find IDs for active, favorited, uploaded, and featured avatars. The ID is at the end of the avatar's URL. For example, the default avatar's URL is https://vrchat.com/home/avatar/avtr_c38a1615-5bf5-42b4-84eb-a8b6c37cbd11, so you can feed avtr_c38a1615-5bf5-42b4-84eb-a8b6c37cbd11 to a pedestal to load it. You can also try my PowerShell scripts here: https://besttomodachi.booth.pm/items/3745916
Version History
[2026/06/12] Input is now determined to be a URL if it starts with "https://". This fixes crash-like behavior when fed URLs beginning with "http://". [2026/04/18] Fixes and adjustments to text-related components. [2026/04/17] System rebuilt. Loading ability substantially improved. Recently selected avatar pedestal array removed due to VRChat adding the ability to select recent avatars. [2022/04/21] Adjustments made to arrow positions for "Avatar Board (World)(Quest).prefab" and "Avatar Board (Combo)(Quest).prefab" for a more centered appearance when using Quest. [2022/03/28] A modified setup designed for world authors to display avatars has been added, as well as a combined format. [2022/03/24] -New sync data was not received when inactive, so the main program's object is no longer targeted by the toggling program. -Now utilizes Udon Behavior arrays instead of Input Field arrays. The main program targets Udon Behaviors on Avatar Pedestal components within PageArrayObject, so this will maintain the ability to utilize Udon programs within environments created with the paging system. -Page Input Field now enforces a character limit to prevent an extremely large number from causing TryParse to return False and set Page to 1, rather than to the presumably much smaller and final value. Also, TryParse now no longer changes Page when returning False. -Main Input Field now imposes a character limit of 16,381, down from Unity's internal limit of 16,382, in order to allow overwriting selected text when at the limit. -Added input string handling for Unity's 16,382 character limit on Input Fields. Not for use with a direct string method. -In "Reject blank or identical", False for Inequality now sets SyncString to Main Input Field. -IsElementSizeperPageSame is now True by default. -Unity Input Fields behave differently for Quest, so a modified version has been added for compatibility. [2022/02/18] Fixed issue of page resetting to 1 for non-owners when new players join. [2022/02/17] Initial release of Avatar Board.