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

# Auto-Updates

> How MythicLabs plugins check for and notify you about new versions

Every MythicLabs plugin includes a lightweight update checker. It never downloads or installs anything automatically - it only tells you when a new version is available.

## How it works

On startup, and once every few hours after that, the plugin checks its latest published version against the one you're running. If a newer version exists, it logs a notice to console and pings online operators with the `[pluginname].update-notify` permission.

```text theme={null}
[MLVouchers] A new version is available: 1.1.0 (you're running 1.0.0)
[MLVouchers] Download it from https://builtbybit.com/resources/mlvouchers.122131/
```

## Configuration

Update checks are on by default and can be turned off per plugin in `config.yml`:

```yaml theme={null}
update-notifier:
  # if enabled, it will display the message in the console
  enabled: true
  # if enabled, it will broadcast the update message to all players who have the [pluginname].update-notify permission
  on-join: true
```

<Note>
  Disabling the update checker doesn't disable license validation - the two systems are independent.
</Note>

## Applying an update

<Steps>
  <Step title="Download the new version">
    Grab the latest `.jar` from your BuiltByBit purchase history.
  </Step>

  <Step title="Replace the old jar">
    Stop the server and replace the old `.jar` file in `plugins/` with the new one.
  </Step>

  <Step title="Check the changelog">
    Review the [changelog](/work-in-progress/changelog) for breaking changes before starting back up.
  </Step>

  <Step title="Restart">
    Start the server. Config files are migrated automatically where possible.
  </Step>
</Steps>

<Warning>
  Config migrations add new keys but never delete customizations you've made. Always back up your `plugins/` folder before a major version update.
</Warning>