Enabling experiments and Beta APIs on Bedrock

The reliable way to turn on experimental features or Beta APIs for your Bedrock world: flip the toggle in your own Minecraft client, then re-upload the world to the panel.

The reliable way to turn on experimental features or Beta APIs for your Bedrock world: flip the toggle in your own Minecraft client, then re-upload the world to the panel.

Some addons, especially ones that use scripting, need experimental toggles or the Beta APIs turned on for the world. A Bedrock server has no in game settings screen to flip these, so the easiest dependable path is to change them in your own Minecraft Bedrock client and put the updated world back on the server.

Back up first

Experiments can make a world unstable or, in rare cases, corrupt it, and once a feature is switched on for a world you often cannot cleanly switch it back off. So take a backup before you touch anything.

  • Open the Backups tab in the panel and create a backup, or download the world folder from the Files tab and keep a copy somewhere safe. The Backups tab shows how many backup slots your server has.

The reliable method: toggle it in your own client

  • Stop the server from the Console tab.
  • Open the Files tab, go into worlds/, and download your world folder to your computer. It will usually come down as a .zip.
  • Import that world into your own Minecraft Bedrock client. The simplest way is to rename the download to a .mcworld file and open it, which imports it into your local worlds list. Keep a spare copy of the original in case you need to start over.
  • In the client, go to the world and open its settings, then find the experiments or Beta APIs toggles. Turn on the ones your addon needs. The game will warn you that experiments cannot be removed once enabled. That is expected.
  • Play into the world once, or just save and exit, so the game writes the change into the world files.
  • Export the world from the client back out to a .mcworld or .zip file.
  • In the panel's Files tab, replace the old world folder with the updated one. A clean way to do this: rename the old world folder to something like Bedrock levelold`, then upload and unzip your updated world into a folder with the original name so the server picks it up.
  • Start the server from the Console tab and confirm the addon or Beta API feature now works.

The reason this works is that the experiment flags live inside the world data itself, so once your client writes them in, the server just reads them from the uploaded world.

Advanced: editing the world NBT directly

If you would rather not round trip through the client, you can edit the world's NBT data (the binary save format Minecraft uses) to flip the experiment flags by hand. This is fiddlier and easier to get wrong, so only do it if you are comfortable with binary world editing. The full write up is here: Enabling experiments via NBT.

Troubleshooting

  • The feature still is not on after re-upload. Make sure the server is actually loading the world you edited. Check that the world folder name matches the level-name in server.properties, and that you replaced the right folder.
  • Client would not import the download. Confirm the file is renamed to .mcworld and that the zip contains the world files at the top level, not nested inside an extra folder.
  • World will not load or looks corrupted. Restore the backup you took at the start. This is exactly why the backup step comes first.
  • Toggle greyed out in the client. Some experiments depend on your client version. Update your Bedrock client to a version that matches or is newer than the server, then try again.

Still stuck? Jump into our Discord at discord.gg/GuavaHost and the team will help you out.