Troubleshooting

The dock and Foundry's notifications say what is wrong in plain words. This page lists those messages and what to do about each. When they don't help, the browser console (F12) usually says more.

Joining the call

Message	What to do
Waiting for a GM to let you join	LiveKit and Jitsi need a GM online: a GM's browser signs each player's token. Ask a GM to load the world.
Enter the service's key in this browser's module settings	The GM's browser has no key or secret for the service. They are kept per browser: enter them in each browser a GM uses.
No voice and video service module is enabled	Enable a service (P2P, LiveKit or Jitsi); Plan your modules shows which are installed.
The service refused to let you in	Check the server address, key and secret in the service's settings. For Jitsi, check the app id and secret match the server's.
The call is full	P2P's Most players in a call is reached. Rejoin when someone leaves, or raise the limit.
This browser can't join the call	The browser lacks what calls need. Use a current Chrome, Edge or other Chromium browser.
The call went on in another tab or window	You opened the world twice. Close one of them.
Another module replaced Modular A/V's voice and video client	Another A/V module is enabled, such as LiveKit AVClient. Enable only one.

Connection

• Connection unsteady, reconnecting and Connection lost, trying again: Modular A/V reconnects by itself, with a fresh token each time. Nothing to do unless it keeps failing.
• P2P players can't hear each other across networks: their routers don't let browsers reach each other. Add a TURN relay server in Foundry's A/V settings; see P2P.
• Jitsi: nobody appears in the call: the server lacks Prosody's presence_identity module on the main VirtualHost. The console says so; see Jitsi.

Microphone and camera

Message	What to do
Your microphone (or camera) can't be used	Allow this site to use it in the browser's site permissions, then reload. Check no other app holds it.
You're muted, so the others can't hear you	You spoke while muted: unmute in the voice panel.
Voice activity can't run, so your microphone is always on	Mute yourself when not speaking, or use push to talk (Foundry's A/V settings).
A microphone effect failed; your microphone goes on without it	You are heard without noise cancellation. Pick the model again, or another one.
Your camera effect failed, so your camera stays off	See Camera background; turn the effect off to show your camera.

• Another player is too quiet: raise their volume in their menu in the dock; above 100% they are boosted for you alone. Or they can turn on the mic boost, which raises them for everyone.
• Your camera looks soft to the others: the browser opens most cameras at 640x480. Pick a higher Resolution in the voice and video settings window's Video tab; a camera that can't do it stays at its best.

Audio mixer

Message	What to do
Effects are modules of their own, and none is enabled in this world	A GM enables effect modules, from Plan your modules or Manage Modules.
{effect} rings on ahead of the voice gate	Move the reverb or echo to the sends: before the gate it holds the gate open, then gets cut.
{effect} is on a send, so your voice is heard twice	Move it before or after the gate: it isn't made for a send.
{effect} runs after the voice gate, so the gate still hears the noise	Move noise cancellation before the gate.
Channel stays at 100% until a send is running to carry it	Turn a send on, or leave Channel at 100%.
This browser can't turn your voice fully off cleanly	Keep Channel above 0%, or use Chrome or Edge, which can.
Failed. You are heard without it.	The effect stopped. Turn it off and on again; the browser console says why.
Skipped, not in this world, or not available in this browser	The preset names an effect this world lacks or this browser can't run. The rest of the preset applies.
Your GM changed your voice	A GM laid a preset over yours. Not for me in the mixer refuses it.
Part of it can't run here	Your browser can't run one of the effects in the GM's change. The rest applies.
Test my voice: it needs a microphone in the call	Join the call with a microphone first.
The audio mixer couldn't load	Reload the page. If it keeps happening, open an issue with the console's messages.

Plan your modules

• Couldn't reach GitHub: the GM's browser couldn't fetch the list of modules, so updates and new modules may be missing from the window. It still shows the modules your installed version knows.
• Copying isn't allowed here: the browser blocked the clipboard. Select the links and copy them yourself, or save them as a file.

Browsers

Chrome, Edge and other Chromium browsers run everything. Firefox and Safari aren't tested yet: there the camera background isn't offered and the dock's window can't stay always on top (a normal window of its own works).

Reporting a bug

Open an issue with:

• your browser and its version, and Foundry's version;
• the service (P2P, LiveKit Cloud, your own LiveKit, Jitsi) and the Modular A/V modules with their versions;
• what you did, what you expected, and what happened;
• the messages from the browser console, with any keys, secrets or tokens removed.