Skip to main content

World Sync Configuration

This page explains how to set up world synchronization for VRCLinking. Below you'll find details about legacy and current features, including role encoding options.

Guest Users (Legacy Feature)​

⚠️ Note: This feature is currently unsupported and only works partially. It may be revived if there’s demand.

The Guest Users feature was designed to let certain users (like your supporters) give a “Guest” role to their friends inside the VRChat world only.

  • How it works: You’d set a “Main” role (for example, your Supporter role). Anyone with this role could temporarily let their friends appear as if they had the Guest role—but only in the world. This does not give the role on Discord itself.
  • Use case: Allow supporters to share their perks with friends in your VRChat world without needing to give them the role on Discord.

Encode Roles vs Always Encode Roles​

When configuring roles for world sync, you have two options for how user roles are presented in-world:

Encode Roles​

  • If you select, say, 10 roles, the bot will:

    1. Check which of those roles each user has.
    2. Pick the highest role they have (based on role hierarchy).
    3. Only one role (the highest) is included in the world Data.

Always Encode Roles​

  • If you select 10 roles, and a user has 5 of them, then:

    • The user will show up as having all 5 roles in-world.
    • If they have all 10, they’ll be listed with all 10.

Use Encode Roles if you want users to only have their “main”/highest role visible. Use Always Encode Roles if you want all selected roles to be visible in-world for each user.

Example Use case​

  • Encode Roles: Often used for Supporter roles, where you want to show only the highest supporter role a user has, like Supporter, Super Supporter, or VIP. This keeps the world clean and focused on the most significant role.
  • Always Encode Roles: Often used for community roles, event roles, or any scenario where you want to show all roles a user has, like Moderator, Admin, Event Organizer, etc.