> ## Documentation Index
> Fetch the complete documentation index at: https://docs.purpify.host/llms.txt
> Use this file to discover all available pages before exploring further.

# Enable Beta APIs

> Enable the Beta APIs experiment for a Purpify Minecraft Bedrock Edition world through World Manager or level.dat.

Enable **Beta APIs** only when a Bedrock add-on requires experimental script APIs. You can use **World Manager** or edit the active world's `level.dat` file.

## Before you begin

* Confirm that this is a native Minecraft Bedrock Edition server.
* Check that the add-on specifically requires the **Beta APIs** experiment.
* Stop the server before changing the world.
* Create a [server backup](/server/backups).
* Identify the active world before using the file method.

<Warning>
  Beta APIs can change or be removed in later Minecraft versions. After you enable an experiment for a world, you cannot return that world to a non-experimental state. Keep an untouched backup.
</Warning>

## Choose a method

<Tabs>
  <Tab title="World Manager">
    <Steps>
      <Step title="Open World Manager">
        Open the server in the Purpify game panel, then go to **World Manager**.
      </Step>

      <Step title="Edit the active world">
        Find the world currently used by the server and select **Edit**.
      </Step>

      <Step title="Open Experiments">
        Go to **Experiments**, then enable **Beta APIs**.
      </Step>

      <Step title="Save and restart">
        Save the world settings, restart the server, and watch the console for add-on or scripting errors.
      </Step>
    </Steps>
  </Tab>

  <Tab title="level.dat">
    <Steps>
      <Step title="Open the active world folder">
        Open the file manager and go to `worlds/<active-world>`, replacing `<active-world>` with the folder used by the server.
      </Step>

      <Step title="Open level.dat">
        Select `level.dat` to open the world-data editor.
      </Step>

      <Step title="Enable Beta APIs">
        Find the **Experiments** section and enable **Beta APIs**. Save the file.
      </Step>

      <Step title="Restart and verify">
        Restart the server and watch the console. Confirm that the add-on loads without a missing experiment or unsupported API error.
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Note>
  Use World Manager when possible. The `level.dat` method is useful when you need to edit the active world directly.
</Note>

## If Beta APIs does not work

* Confirm that you edited the active world rather than another folder in `worlds`.
* Stop the server before saving `level.dat`, then restart it after the change.
* Confirm that **Beta APIs** remains enabled after reopening the world settings.
* Check the add-on's `manifest.json` and installation instructions for its required Minecraft and script API versions.
* Restore the backup if the world or add-on stops loading correctly.

<Columns cols={2}>
  <Card title="Install Bedrock add-ons" icon="puzzle-piece" href="/server/install-addons">
    Install the behavior and resource packs that use the experiment.
  </Card>

  <Card title="Manage files" icon="folder-open" href="/panel/files-and-sftp">
    Learn how to edit and protect server files.
  </Card>
</Columns>
