UpdateChecker

UpdateChecker is a marketplace update scanner for Paper servers.

Download Plugin

Plugin description

• Automatic and manual update scans

• Paged in-game GUI with clickable marketplace links

• Plugin status overview for:

  • Up to date

  • Update available

  • Broken / disabled

  • Not found

• Scans loaded plugins and optionally unloaded jars from the server plugins folder

• Automatic plugin discovery from each jar plugin.yml

• Provider matching for:

  • Modrinth

  • Polymart

  • SpigotMC

  • BuiltByBit

  • MythicCraft

• Manual per-plugin marketplace overrides through plugin-links.yml

• Configurable provider toggles, scan interval, timeout, and ignore list

• BuiltByBit API token support from:

  • config.yml

  • UPDATECHECKER_BUILTBYBIT_API_TOKEN

  • -Dupdatechecker.builtbybit.api-token=...

• Discord webhook dashboard with:

  • Latest scan summary

  • Installed plugin overview

  • Update / broken / not found lists

  • Server software, Minecraft version, IP, players, TPS, RAM, and CPU usage

• Automatic webhook refresh every minute

• Offline webhook update when the server shuts down

Compatibility

• Minecraft: 1.19.4 - 1.21.x

• API: Paper / Spigot

General Commands

• /updatechecker

  • Permission: updatechecker.use

  • Opens the UpdateChecker GUI. If no scan has finished yet, starts one first and opens the GUI when it completes.

  • /updatechecker scan

    • Permission: updatechecker.scan

    • Runs a manual update scan asynchronously.

  • /updatechecker reload

    • Permission: updatechecker.reload

    • Reloads config.yml, re-syncs plugin-links.yml, and rebuilds the plugin runtime state.

Permissions

• updatechecker.use

  • Allows opening the UpdateChecker GUI.

• updatechecker.scan

  • Allows running a manual update scan.

• updatechecker.reload

  • Allows reloading UpdateChecker and plugin-links.yml.

Config Files

config.yml

# Main scan settings.
scan:
  # Time between automatic scans, in hours.
  interval-hours: 1
  # HTTP timeout for marketplace requests, in seconds.
  timeout-seconds: 10
  # Include plugin jars that are not currently enabled by the server.
  include-disabled-jars: true
  # Run a scan automatically when the server starts.
  auto-scan-on-startup: true
  # Plugin names that should always be skipped during scanning.
  ignore-plugins: []

# Enable or disable individual update providers.
providers:
  modrinth:
    enabled: true
  polymart:
    enabled: true
  builtbybit:
    enabled: true
    # BuiltByBit uses only the official API, not HTML scraping.
    # Automatic BuiltByBit matching is disabled - use exact BuiltByBit links in plugin-links.yml.
    # Optional local override: set UPDATECHECKER_BUILTBYBIT_API_TOKEN env var
    # or JVM property: -Dupdatechecker.builtbybit.api-token=...
    # Raw tokens are treated as Private tokens automatically.
    # If left empty, the plugin falls back to a bundled Shared token limited to the author's resources.
    api-token: ''
  spigot:
    enabled: true
  mythiccraft:
    enabled: true

# Discord webhook integration.
discord:
  # Send scan summaries to a Discord webhook.
  enabled: false
  # Full Discord webhook URL.
  webhook-url: ''
  # Display name used by the webhook message.
  username: 'UpdateChecker'
  # Optional avatar image URL for the webhook message.
  avatar-url: ''
  # Optional embed color. Supports formats like #2ecc71, 0x2ecc71, or 3066993.
  # Leave empty to use automatic status-based colors.
  embed-color: ''
  # Optional server address shown in the webhook, for example 0.0.0.0:25565.
  # Leave empty to use automatic detection.
  server-address: ''

# Manual plugin URLs are stored in plugin-links.yml.

plugin-links.yml