Skip to content

Update Checker

Alexisleder edited this page Jul 8, 2026 · 1 revision

Update Checker

This page explains how the LederProtections update checker works.

LederProtections includes a simple Modrinth-based update checker that can notify server administrators when a newer version is available.


Overview

The update checker compares the installed LederProtections version with the latest version published on Modrinth.

It can notify:

  • the server console;
  • administrators when they join the server;
  • /lep version output.

The update checker is informational only.

It does not download, install, replace or modify plugin files automatically.


What the Update Checker Does

Feature Supported
Checks Modrinth for newer versions Yes
Shows update status in console Yes
Shows update status in /lep version Yes
Notifies administrators on join Yes
Downloads updates automatically No
Installs updates automatically No
Replaces plugin files No
Modifies server files No

Configuration

The update checker is configured in:

plugins/LederProtections/config.yml

Default configuration:

update-checker:
  enabled: true
  check-on-startup: true
  notify-admins-on-join: true

Configuration Options

Option Description
enabled Enables or disables the update checker.
check-on-startup Checks for updates when the server starts.
notify-admins-on-join Notifies administrators when they join if a newer version is available.

The update source is handled internally by the plugin.

Server owners do not need to configure a custom update URL.


Startup Check

If startup checks are enabled, LederProtections checks Modrinth after the plugin starts.

When the plugin is up to date, the console may show a message similar to:

[LederProtections] Update checker: LederProtections is up to date.

When the installed version is newer than the currently published Modrinth version, the console may show a message similar to:

[LederProtections] Update checker: the installed version is newer than the latest version published on Modrinth.

This can happen when testing a version locally before publishing it.


New Version Available

If a newer version is available, LederProtections may notify the console.

Example:

[LederProtections] A new version is available: 1.0.1
Download: https://modrinth.com/plugin/lederprotections

Exact wording may depend on language configuration.


Admin Join Notifications

If enabled, administrators with the update permission can be notified when they join.

Permission:

lederprotections.update

Recommended for:

  • server owners;
  • administrators;
  • technical staff.

Do not give this permission to normal players unless you want them to receive update notifications.


/lep version

The command:

/lep version

shows:

  • installed LederProtections core version;
  • update-checker status.

Example output:

Core: 1.0.0
Update checker: up to date

This command is useful for support and troubleshooting.


Permissions

Permission Description
lederprotections.update Allows receiving update notifications.
lederprotections.info Allows viewing version and runtime information commands.

Recommended admin setup:

lederprotections.info
lederprotections.update

Privacy and Safety

The update checker only checks for version information.

It does not:

  • upload server files;
  • upload player data;
  • download plugin updates automatically;
  • install files;
  • replace existing plugin jars;
  • modify configuration files.

It only checks Modrinth and reports whether a newer version is available.


Disabling the Update Checker

To disable the update checker:

update-checker:
  enabled: false
  check-on-startup: true
  notify-admins-on-join: true

When disabled, LederProtections should not perform update checks.


Disabling Admin Join Notifications

To keep startup checks but disable join notifications:

update-checker:
  enabled: true
  check-on-startup: true
  notify-admins-on-join: false

This is useful if you want console-only update notifications.


Disabling Startup Checks

To disable startup checks but keep admin join notifications:

update-checker:
  enabled: true
  check-on-startup: false
  notify-admins-on-join: true

This setup is less common.


Recommended Settings

Recommended production settings:

update-checker:
  enabled: true
  check-on-startup: true
  notify-admins-on-join: true

This keeps administrators informed without automatically changing server files.


Common Questions

Does the update checker install updates?

No.

It only checks Modrinth and reports available versions.


Does the update checker download files?

No.

It does not download plugin jars automatically.


Does the update checker modify my server?

No.

It does not replace files, edit configuration or install updates.


Why does it say my installed version is newer?

This can happen if:

  • you are testing a build before publishing it;
  • Modrinth has not updated yet;
  • the installed version is a development or pre-release build.

Why does it not show an update?

Possible reasons:

  • you are already using the latest version;
  • the update checker is disabled;
  • Modrinth has not published the newer version yet;
  • the server cannot connect to Modrinth;
  • the player does not have permission to receive join notifications.

Troubleshooting

No message appears in console

Check that:

  • update-checker.enabled is true;
  • update-checker.check-on-startup is true;
  • the server has internet access;
  • the server can reach Modrinth;
  • there are no console errors.

Admins do not receive join notifications

Check that:

  • update-checker.enabled is true;
  • update-checker.notify-admins-on-join is true;
  • the admin has lederprotections.update;
  • a newer version is actually available.

/lep version does not show expected status

Check that:

  • the plugin loaded correctly;
  • the update checker is enabled;
  • the server has internet access;
  • Modrinth is reachable;
  • the installed version is correct.

Recommended Next Pages

Clone this wiki locally