Help Managing your world

Your dashboard

A tour of what's where, so you know where to look.

Overview

The first page you see after signing in has a card for each of your Minecraft worlds: whether it's online, who's playing, today's messages, joins and deaths, and a small chart of the last week. A card also says when its pack is out of date. Select a card to open that world's page.

The sidebar lists your Minecraft worlds and the Discord servers you manage, and links to this help, the developer guide and the Discord support server. Each world's plugins are on its Plugins tab.

Status updates from the BedrockRelay team, such as planned maintenance or a known problem, show at the top of the Overview until they're over. Choose Hide to put one away.

A Minecraft world's page

The top of the page shows the world's status, its Minecraft version and its pack version. Below that are its tabs.

A Minecraft world's page, with its status heading and its tabs: Overview, Players, Plugins, Commands, Personality, Invite link, Verification and Settings
Each world's page has its tabs along the top.
TabWhat's on it
OverviewThe Relaying switch, today's numbers, who's online right now (with Moderate), a 30-day chart, and every Discord channel the world is connected to.
PlayersEveryone who has ever played, their details, linked accounts, and the moderation log. See Players and moderation.
PluginsThe plugins in this world: switch them on, choose where they post, and post live boards.
BlueprintsWorlds with Bedrock Holobuild: download its blueprints as files, or upload a structure to make a new one. Shown once Holobuild is in the world. See Holobuild.
PermissionsWho can use which commands in Discord: moderation, plugin commands and Minecraft commands. And your console, for running any command yourself. See Who can use what and The console.
PersonalityThe bot's name and how it talks when players or members speak to it. See Personality.
Invite linkOne short link for joining your world and its Discord server. See Invite links.
IntegrationsLinking the world to other services, such as its map on BedrockMap. Shown once there's something to link. See BedrockMap.
VerificationA Verify button in Discord, and approving players before they join. See Verification.
SettingsThe pack and its updates, where players join, chat from Minecraft, linked players, security, and removing the world.

Switching relaying off

The Relaying card at the top of a world's Overview tab is its off switch. Switch it off and nothing passes between that world and Discord, in either direction, until you switch it back on:

The Relaying card on a world's Overview tab, switched off, saying when it was switched off
Switched off, the card says since when.
  • No chat, joins, leaves, deaths or status notices go to Discord, and no plugin posts.
  • Discord chat doesn't reach the game, and /relay online, /relay run, /relay link and plugin commands say relaying is off instead.
  • Live boards stop updating (their messages stay), and proximity voice stops moving players.
  • On a Realm, our bot leaves the world and stays out. It joins again when you switch relaying back on. Meanwhile it can't see who's playing, so you can't warn or kick players or see their live details there; what was saved when they last left still shows on the Players tab.

Your channels, plugins and settings are all kept, so switching it back on carries on where it left off. A dedicated server's pack stays connected meanwhile, so the world still shows as online, marked Relaying off. Only the world's owner can use the switch; to stop one Discord server receiving a world, use Disconnect everything or /relay disconnect there instead.

Statistics

The Overview tab counts today's messages from Minecraft and from Discord, joins, deaths and the most players online at once. The 30-day chart shows messages each day by direction; hover over a day for its joins, deaths and peak, or choose Show as a table.

Statistics are counts, not the messages themselves. See Privacy and security.

Where players join

"Online" means the pack reaches BedrockRelay. That isn't quite the same as players being able to get in, so BedrockRelay also checks your server about once a minute the way Minecraft does before joining. If that check fails, the world shows Can't join and the Overview tab says why.

The Can't join notice on a world's Overview tab, saying nothing answered at the server's address, with a button to change the address
When players can't get in, the Overview tab says what BedrockRelay found.

BedrockRelay checks the address your server connects from, on the port in server.properties. If players use a different address, enter it under Where players join on the Settings tab, like play.example.com:19132. What to do when players can't join.

This is for dedicated servers only: Microsoft hosts Realms, so a Realm's Settings tab has no join address.

A Discord server's page

Select a Discord server in the sidebar to open its page. It has five tabs:

A Discord server's page, with its five tabs: Overview, Channel routes, Proximity voice, Activity and Settings
Each Discord server's page has five tabs. A dot on a tab means something there needs doing.
TabWhat's on it
OverviewAnything that needs fixing, the Minecraft worlds connected here, and which channel each posts to.
Channel routesEach channel's direction, events and shared chat, and adding a channel.
Proximity voiceSetting up and switching proximity voice.
PermissionsWho can use which commands here, for each Minecraft world connected to this Discord server. Read-only: each world's owner changes it on the world's own Permissions tab. See Who can use what.
ActivityWho changed what in BedrockRelay here, newest first. See below.
SettingsWhether BedrockRelay still has the permissions it needs, the language the bot writes in here, and Disconnect everything.

You can manage a Discord server's page if you have Manage Server there. Worlds that belong to someone else are marked, and only their owner can change their channels.

Activity

The Activity tab lists the changes made to BedrockRelay in that Discord server, and who made them: channels connected, changed or disconnected, /relay disconnect and /relay run, proximity voice, live boards and the language. Everyone who can manage that Discord server sees the same list, so when several people look after one, you can see what changed.

Changes made before the tab existed may be missing from it.

BedrockRelay's permissions

When you add BedrockRelay, Discord gives its role the permissions it asks for. Anyone who can edit roles can take them away again later. The Settings tab checks: if something's missing, it says what, the Overview shows a warning, and Update the bot's permissions takes you to Discord to approve them again.

A single channel's settings can also take permissions away in that channel alone. Those show on the channel's route: see When BedrockRelay can't use a channel.

Disconnect everything

The emergency brake for a whole Discord server, at the bottom of its Settings tab. It removes every channel route there at once, stops live boards there updating (their messages stay), and switches proximity voice off, keeping its channels. Anyone with Manage Server there can use it, whoever owns the Minecraft worlds. The worlds and their settings are kept, and their owners can connect channels again.

To stop just one channel, use /relay disconnect in it, or remove its route.

If BedrockRelay is removed from a Discord server

Anyone who can manage a Discord server can remove BedrockRelay from it in Discord. In case that was a mistake, nothing is deleted straight away: everything BedrockRelay had there is kept and paused, and nothing posts there.

  • The Discord server's page in the dashboard asks Did you mean to remove it? Choose No, add it back and everything carries on where it stopped. Any webhook Discord deleted meanwhile is made again. Or choose Yes, remove everything to clear it up now.
  • The owners of the Minecraft worlds connected there see those channels marked Paused on their world's page.
  • If nobody decides, everything BedrockRelay kept there is cleared up 30 days after it was removed. The Minecraft worlds themselves are never deleted.

Your account

The Account page shows who you're signed in as, the accounts you've connected, and what BedrockRelay keeps about you.

  • A sign-in lasts seven days on each device. Sign out everywhere signs you out on all of them.
  • If you've connected a Microsoft account for Realms, you can sign out of it here, which deletes it from BedrockRelay at once.
  • Join our Discord adds you to the BedrockRelay Discord server, where you can ask for help, suggest ideas and see what's new. Discord asks you once to allow it. If you own a world, you get the World Owner role there.
  • When you first sign in, you're asked to agree to the terms and privacy policy. If they change, you're asked again.

Ready to connect a world, or need to change something?

Open the dashboard