$getUserVar[]
$getUserVar reads a persistent variable for a user in a server. With only a name, it uses the current author and current server. Values are isolated by the guildMember context guildId:userId.
Syntax
$getUserVar[name] or $getUserVar[name;User ID] or $getUserVar[name;User ID;Guild ID]The optional User ID selects another user; the optional Guild ID selects another server. An empty User ID uses the author. For a user value shared across all servers, use $getVar[name;User ID].
Existing bots without a completed variable migration retain their legacy user-global behavior until migrated.
Variables are defined and configured in the Bot Creator Variables UI, where you can set default values. If a variable has not been set via $setUserVar but a default value exists in the definitions, $getUserVar returns that default. If neither a stored value nor a default exists, an empty string is returned.
JavaScript (BDJS) equivalent:
await db.user.get('name')— see db.user.
Examples
User Wallet Balance
$title[User Balance 🪙]
$description[<@$authorID>, you have **$getUserVar[coins;$authorID]** coins in your wallet!]
$color[#FEE75C]
$sendMessage[]