logo
More

Do you need an account?

Are you a player on a server, or an owner/admin?

Only people who manage a server need an account to link to the plugin. Regular players can just use /audio in-game without needing to register

Continue with registration

Web client (Audio & Voice Chat)

The OpenAudioMc web client is a small web page players open in their browser to receive streamed audio and use the voice chat feature. Minecraft cannot natively stream live audio, so each player connects to a dedicated web session that stays active while they are in-game.

This page explains how the web client works and how to connect from Java and Bedrock editions, plus tips for browsers, microphones, and troubleshooting.

How it works (quick)

  • Each player is given a session URL or code when they join a server with OpenAudioMc.
  • Players open that URL (or enter the code on the session site) in a browser and keep the page open in the background.
  • The web client receives live audio streams and voice chat, while the server keeps the session valid as long as the player is in-game.

Keep the page open (or pinned) while you play, closing it stops audio and voice chat for that player.

Connect with Minecraft: Java Edition

  1. Join a server running OpenAudioMc.

  2. Click the session link in chat that appears after joining, or run the session command manually:

    Command Example
    /audio
    <>Required
    []Optional

  3. Open the link in a supported browser and follow the on-screen instructions (allow microphone if you want voice chat).

That's it, the web client will stay connected while you're in-game.

Connect with Minecraft: Bedrock Edition

  1. Open your browser and visit one of the session sites:

  2. Follow the site instructions to get a login code. Copy the code.

  3. Join the Bedrock server running OpenAudioMc. In chat, paste the code with the /audio command. For example, if your code is xyz:

    Command Example
    /audio xyz
    <>Required
    []Optional

  4. After submitting the code in-game, the session links your browser session with your Bedrock player and audio/voice will start.

Tip: If your device and server are on different networks (NAT/CGNAT), the site handles the connection handoff for you using the code, you do not need to open ports.

Supported browsers & devices

  • Best experience: Google Chrome, Microsoft Edge, Brave.
  • Good support: Firefox (voice and audio work; behavior may vary with autoplay or focus).
  • Safari / iOS: Partial support. Due to iOS limitations, background audio and microphone behavior may be restricted, testing is recommended.
  • Mobile: Works in modern mobile browsers, but battery and OS background policies may stop the page if the app is suspended.

Always use the latest browser version for best compatibility.

Microphone & permissions

  • To use voice chat, allow the page to access your microphone when prompted.
  • In some browsers you must explicitly allow microphone access per-site in browser settings.
  • If the browser asks for permission but the voice still doesn't work, reload the page and re-allow the permission.

Autoplay & background playback

  • Some browsers block autoplay. The session site will prompt you to interact with the page if required (click a button) to enable playback.
  • Keep the tab open and avoid fully suspending the browser to prevent audio disconnects.

Privacy & security

  • Sessions use HTTPS. Do not share your session code or link publicly, anyone with the code can join that browser session.
  • Microphone audio is transmitted to other players in the server's voice channels; server operators can control voice chat behavior via plugin settings.

Troubleshooting

  • No link in chat after joining:

    • Ensure the server has OpenAudioMc installed and you joined the right server.
    • Try /audio manually:
      Command Example
      /audio
      <>Required
      []Optional

  • Audio plays in browser but not in Minecraft:

    • Make sure the session is connected to your in-game account (you used the given link or submitted the code with /audio).
    • Check the site indicates "connected" and the server shows your session as active.

  • Voice chat not working:

    • Confirm microphone permission is allowed in the browser.
    • Try a different browser (Chrome/Edge recommended).
    • Reload the session page and re-run /audio if needed.

  • Bedrock code refused or expired:

    • Codes are single-use or time-limited. Request a new code from the session site and retry.

Example video (Bedrock connection)

If you want, I can also update this into your repository as a properly formatted docs file (I prepared the text above). I can either create a new markdown file in your docs folder or open a PR updating an existing file, tell me which repository path you'd like me to target and I'll prepare the next step.