Updates Migration

Updates and Configuration Migration

Update checker

New 4.6.1 configs expose only:

update-check:
  enabled: true

The checker uses Modrinth and built-in defaults for its other behavior.

Existing config files are never overwritten

When config-version is missing or different from the running plugin version, BlueMapWebChat compares the physical config with the bundled defaults and writes a migration fragment:

plugins/BlueMapWebChat/config-migration-4.6.1.yml

The real config.yml is left unchanged. Review and copy the relevant settings yourself.

For 4.6.0 → 4.6.1, the new public settings are:

update-check:
  enabled: true

direct-message:
  admin-audit:
    enabled: false

config-version: "4.6.1"

Upgrade procedure

1. Back up plugins/BlueMapWebChat/ and the current JAR.
2. Replace the plugin JAR.
3. Restart the server.
4. Review config-migration-4.6.1.yml if generated.
5. Merge the desired settings into config.yml.
6. Set/review config-version: "4.6.1" after completing the review.
7. Run /bmchat reload for subsequent config-only changes.

Cross-server DM warning

All servers that exchange cross-server DMs must run BlueMapWebChat 4.6.1. Do not mix 4.6.1 with older BlueMapWebChat versions on servers that participate in private relay.