🛠 Mini Features

ProgressiveUnlock includes several small but powerful features that enhance the plugin's flexibility and server control.

🔄 AutoUpdater

The AutoUpdater helps keep your plugin configuration up to date.

It does not automatically download new plugin versions for security reasons.
Instead, it checks for new versions at a regular interval and logs a notification if one is available.
When a version update is detected, the plugin will automatically update config files by adding any new configuration options.
All added values are printed to the console, and missing keys are inserted into existing *.yml files without deleting existing values.
This allows the plugin to work smoothly after updates without manual config file editing.

You can configure how often the plugin checks for updates using:

update:
  check_interval_minutes: 180

Debug mode is designed for server administrators.

It requires OP status to use.
When enabled, it logs detailed reasons for each blocked action (e.g., why a tool, block, or entity is not allowed).
It helps diagnose configuration issues and is a powerful tool for fine-tuning unlock logic.
⚠️ Not recommended in production: Debug mode increases logging activity and may affect server performance.
A warning message is shown in the console when the plugin is running in debug mode.

Enable it in the config:

debug:
  enabled: true

This feature allows you to execute commands automatically when a player reaches a new level.

You can use this to:
- Grant permissions
- Give money or items
- Broadcast a message
- Trigger custom plugin commands
You can define as many commands as you like, and they will be executed in order.

Example:

runCommandsOnReach:
  - broadcast %player% just reached level 2
  - eco give %player% 100
  - lp user %player% permission set some.permission true

This allows full customization of level-up rewards and integrations with other plugins.