FAQ & troubleshooting¶
Start with Overview, Setup, or Diagnostics on the dashboard. These show the connected group, setup progress, and permission problems.
Jump to no logs arriving, setup waiting for access, or linked roles missing.
Setup and access¶
Can I set up without using Discord commands?
Yes. Sign in to the dashboard, select your server, add LogDog if needed, and open Setup. You still let the account into your group (accept its join request, or invite it) and grant its permissions in VRChat. See Set up LogDog.
My server is missing, or I cannot edit settings
Check that you signed in with the correct Discord account. Dashboard access needs Manage Server, Administrator, or server ownership. Manage Server gives read access to most pages; setup and configuration require Administrator or ownership. A LogDog feature grant alone does not grant dashboard access.
Setup is waiting for the account to join (invite-only or closed groups)
If your group requires approval, accept the join request from the exact account shown in setup. Otherwise, check the setup notice LogDog posted in Discord (the dashboard bell carries the same instruction):
- Step 5 · Couldn't send a join request: your group takes no requests. Invite the account it names (linked to its VRChat profile). LogDog accepts the invite itself.
- Step 5 · Your group is closed to new members: set the group to Invite Only, then invite the named account.
- Step 5 · LogDog's account is banned from your group: lift the ban, then invite the account.
- Step 6 · LogDog could not accept your invite: VRChat would not let the account join, most likely because of a join requirement such as an age gate. Once the account can join, press I've done this, check now on the dashboard's setup page and LogDog tries the invite again. If the invite has expired, invite it again first.
LogDog checks every 10 minutes automatically, and I've done this, check now on the setup page asks it to check straight away. Delays can be longer if VRChat is unavailable.
I granted audit-log access, but setup has not completed
- Check the account name and profile link in Setup against the member in your group.
- In VRChat, check that this member holds the role with View Audit Log enabled. Enabling the permission on a role does not assign that role to the account.
- Return to Setup and press I've done this, check now to check straight away. Otherwise LogDog checks every 10 minutes automatically at first, and less often the longer setup waits.
LogDog reminds you after 1 and 7 days on this step, and after 30 days without access it leaves the group and returns setup to the group step so you can start again (your channel settings are kept). Pressing I've done this, check now restarts that clock.
The setup page should show completion after access is verified. You do not need to restart setup while waiting. If it still has not advanced, follow Grant audit-log access.
A moderator can use a command but cannot open its dashboard link
Discord feature grants and dashboard access are separate. The dashboard needs
Manage Server or Administrator. A moderator with Manage Server also needs the ban grant
to ban there, or ban or removeuser to remove a member. See
Staff permissions.
Logs and channels¶
Setup is complete but no logs are arriving
- Check Overview/Diagnostics for paused logging or missing VRChat access.
- In Log Routing, confirm the event is enabled and has a destination channel.
- Check LogDog's View Channel, Send Messages, Embed Links, and Attach Files in that channel. Keep Read Message History for message updates too.
- Check whether the group has new audit-log activity. LogDog checks periodically; a quiet group produces no new logs.
- Open VRChat Audit Logs and inspect a recent event's delivery status. If the event is recorded there but is not in Discord, the status says why and what to check.
After fixing access or routing, check the next eligible event for delivery to the configured channel. Allow a few minutes for polling; a quiet group has no new logs. You do not need to disconnect the group or restart setup to change routing.
How quickly do logs appear?
Usually within a few minutes, sometimes around 10 minutes or longer during delays. LogDog checks VRChat periodically; it does not receive every event immediately.
How do I change the destination channel?
Open Log Routing on the dashboard, or use /events → Channel in Discord.
You do not need to restart setup or delete the configuration.
How do I keep log channels private?
Configure the category/channel permissions in Discord: hide it from @everyone
and allow the staff roles that need it. LogDog attempts this for new categories,
but warns if Discord refuses and the category is created public. Existing channels
keep their permissions. LogDog's /permissions grants do not change visibility.
Can I change log colors?
Premium servers can change colors per event in Log Routing, or use
/events → Colors. Free servers use the configured severity colors.
Will LogDog post all the old audit logs into Discord?
No. The first sync posts the newest events, 25 by default. Older history that VRChat still has is imported for the dashboard instead, on both Free and Premium. See First sync.
Moderation and other features¶
A ban or join-request response failed
Read the failure on the Discord message. Ban/unban needs Manage Group Bans in VRChat; removing a member needs Remove Group Members; approving/denying requests needs Manage Group Invites. Deny & Block also needs Manage Group Bans. Role rank can prevent actions against equal/higher-ranked members. See the permissions matrix.
Linked roles are not being assigned
- Check Settings → Account linking: linking must be enabled and the intended Linked/18+ roles selected.
- In Discord's role settings, give LogDog Manage Roles and place its role above every role it assigns.
- Confirm the member completed the linking steps.
- If only the 18+ role is missing, check the status VRChat reports. A bio statement
does not grant this role. A member whose status changed can use
/reverify.
Successful linking grants the configured Linked role; the 18+ role also requires VRChat's verified 18+ status. If a VRChat group role is missing instead, use Role sync troubleshooting.
What's the difference between Ban and Remove from group?
Ban takes the user out of the group and stops them rejoining or asking to join until they're unbanned. A temporary ban lifts itself when its time is up. Remove from group only takes them out: they can rejoin, or ask to, straight away.
In VRChat, LogDog's role needs Manage Group Bans to ban and Remove Group Members to
remove. In Discord, the ban grant allows both; removeuser allows removing only. See
Removing a member.
How do I link my VRChat account?
Press Link Account on your server's linking message, paste your VRChat profile link,
add the one-time LOGDOG-… code to your VRChat bio or status, then press I've added the
code: Verify. See Link your VRChat account for the
full steps and what to do if the code isn't found.
How do I unlink my VRChat account?
Run /unlink in a server that uses LogDog. It removes your link from every
LogDog server, not just that one, along with the linked roles it gave you. To switch
VRChat accounts, unlink first, then link the new one. See
Unlink.
Where do setup alerts and reminders go?
Choose Settings → Notifications → Notification channel, or /config →
Notifications. See Service notifications
for fallback channels and the dashboard notification bell.
What does LogDog log?
See the Event catalog. Instance turnout records player counts, not individual attendance.
Premium and removal¶
Can I connect several groups to one server?
No. Each server connects to one VRChat group, and each group connects to one server. Disconnect the current group before connecting a different one.
LogDog lost access
If the account is still in your group, restore View Audit Log to its role. If the account was removed from the group, LogDog tries to get back in: it rejoins a group anyone can join, sends one join request to a group that takes requests, or asks you to invite it, naming the account. Its notice and the dashboard's Logging is paused for this server notification say what it found and what it did. If the Discord bot was removed, re-add it.
LogDog resumes after checking access. Follow the deadline in the alert; the default grace window is 24 hours. See Managing access loss.
If the bot was removed and the group belongs in a different server now, its VRChat owner
can move it right away with /setup there. See
Moving the group to another server.
How do I remove LogDog?
Use Settings → Delete configuration or /setup → Delete configuration to
disconnect the group, then remove the Discord bot. Existing Discord channels and
delivered logs remain for you to delete if desired. Disconnecting is not a complete
data-erasure request; see the Privacy Policy.
Still need help? Visit the support server with the feature, error message, and steps you tried.