Update Beacon

Quick rating

Update Beacon

No reviews yet

Automatically checks for and updates your servers mods - highly configurable

QoL & Tweaks
Mod Loaders
NeoForge
Fabric
Minecraft

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.

Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Compatibility

Supported Environments

Dev Environment
Client Unsupported
Server Required

About

Project Details

Type
Mod
License
MIT License
Latest Version
ModBeacon 1.0.0-1.21.11 (NeoForge)
Authors
CurseForge
Modrinth

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

CurseForge ID
Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

UpdateBeacon

Discord CurseForge Modrinth

A server-side Minecraft mod that automatically checks for updates to your installed mods on Modrinth and CurseForge, then notifies your operators — and can download and apply the updates for you. No client installation required.


Features

Update detection

  • Checks every installed mod against both Modrinth and CurseForge (CurseForge is enabled by adding a free API key).
  • Hash-based matching — compares the SHA-512 of each installed jar against Modrinth's file records (and CurseForge fingerprints), eliminating false positives from version-string quirks (e.g. 1.4.147 vs 1.4.147+v240613).
  • Nested and bundled sub-mods are skipped automatically.
  • Per-mod update channels — track release, beta, or alpha independently for each mod.
  • Pins — freeze a mod at its current version to silence update notices until you unpin it.

Notifications

  • Console — logs available updates on every check.
  • In-game chat — colored output with clickable download links, sent to eligible ops.
  • Player login — ops see any pending updates when they join.
  • Webhooks — post to any number of endpoints at once (see below).

Downloads & applying

  • Download pending updates to a staging area with hash verification against the source's expected hash.
  • Apply staged jars on the next server stop, or run a timed apply countdown that restarts the server for you.
  • Replaced jars are backed up first, so any update can be rolled back.

Maintenance

  • Integrity scan — verify your installed jars against their published hashes.
  • Hot reload — re-read the config without restarting.
  • Optional scheduled checks on a repeating timer.

Commands

All commands are under /updatebeacon and require permission level 2 (op).

Command Description
/updatebeacon check Run a fresh update check and display results
/updatebeacon list Show cached results from the last check
/updatebeacon info <modid> Detailed info, channel, and a direct download link for one mod
/updatebeacon scan Integrity scan — verify installed jars against published hashes
/updatebeacon download Download all pending updates to the staging area
/updatebeacon staged Show what is downloaded and waiting to be applied
/updatebeacon apply [seconds] Apply staged updates now, or start a restart countdown
/updatebeacon apply cancel Cancel a running apply countdown
/updatebeacon rollback <modid> Restore a mod's previous jar from backup
/updatebeacon pin <modid> Pin a mod at its current version (suppress updates)
/updatebeacon unpin <modid> Remove a pin
/updatebeacon ignore <modid> Stop checking a mod entirely
/updatebeacon unignore <modid> Resume checking a mod
/updatebeacon channel <modid> <release|beta|alpha|any> Set a mod's update channel
/updatebeacon reload Hot-reload updatebeacon.toml without restarting

Webhooks

Add one [[webhooks]] block per target, each with its own URL and format:

[[webhooks]]
url = "https://discord.com/api/webhooks/..."
format = "discord_embed"

[[webhooks]]
url = "https://your-endpoint.com/hook"
format = "generic_json"

Supported formats:

  • discord_embed — rich embed for Discord webhooks
  • generic_json — simple JSON payload for custom integrations

Installation

Drop the mod jar that matches your Minecraft version and loader into your server's mods/ folder, then start the server once to generate the config.

Requirements:

  • A supported Minecraft version (see table above)
  • Fabric Loader with Fabric API, or NeoForge
  • A free CurseForge API key (optional — only needed for CurseForge update checks)

Configuration

Generated at config/updatebeacon.toml on first run:

[general]
enabled = true
check_on_startup = true
check_interval_minutes = 0   # 0 = disabled; any positive value = minutes between checks

[ignore]
mod_ids = []                 # mod IDs to skip, e.g. ["mymod", "anothermod"]
quiet_when_no_updates = true # suppress all notifications when everything is up to date

[console]
enabled = true

[chat]
enabled = true
ops_only = true              # only notify server operators
permission_level = 2         # minimum permission level to receive notifications

# Add one [[webhooks]] block per target. Supported formats: discord_embed, generic_json
# [[webhooks]]
# url = ""
# format = "discord_embed"

[downloads]
auto_download = false        # automatically download updates after each check
auto_apply = false           # swap staged jars into mods/ on server stop
backup = true                # keep replaced jars in .updatebeacon/backup/
allowed_mod_ids = []         # empty = all mods eligible; non-empty = whitelist
apply_countdown_seconds = 300 # default countdown length for /updatebeacon apply

[curseforge]
# Get a free API key at https://console.curseforge.com/
api_key = ""                 # leave blank to check Modrinth only

# Per-mod update channel: "release", "beta", or "alpha"
[mod_policy]
# lithium = "beta"

# Pin a mod to prevent update notifications. Use /updatebeacon pin <modid>
[mod_pins]

Staged downloads and backups live under .updatebeacon/staged/ and .updatebeacon/backup/.


Notes

Mods are matched on Modrinth by default; CurseForge checks turn on once you set a curseforge.api_key. Mods that aren't published on either platform are silently skipped.


BH Promo

UpdateBeacon

Discord CurseForge Modrinth

A server-side Minecraft mod that automatically checks for updates to your installed mods on Modrinth and CurseForge, then notifies your operators — and can download and apply the updates for you. No client installation required.


Features

Update detection

  • Checks every installed mod against both Modrinth and CurseForge (CurseForge is enabled by adding a free API key).
  • Hash-based matching — compares the SHA-512 of each installed jar against Modrinth's file records (and CurseForge fingerprints), eliminating false positives from version-string quirks (e.g. 1.4.147 vs 1.4.147+v240613).
  • Nested and bundled sub-mods are skipped automatically.
  • Per-mod update channels — track release, beta, or alpha independently for each mod.
  • Pins — freeze a mod at its current version to silence update notices until you unpin it.

Notifications

  • Console — logs available updates on every check.
  • In-game chat — colored output with clickable download links, sent to eligible ops.
  • Player login — ops see any pending updates when they join.
  • Webhooks — post to any number of endpoints at once (see below).

Downloads & applying

  • Download pending updates to a staging area with hash verification against the source's expected hash.
  • Apply staged jars on the next server stop, or run a timed apply countdown that restarts the server for you.
  • Replaced jars are backed up first, so any update can be rolled back.

Maintenance

  • Integrity scan — verify your installed jars against their published hashes.
  • Hot reload — re-read the config without restarting.
  • Optional scheduled checks on a repeating timer.

Commands

All commands are under /updatebeacon and require permission level 2 (op).

Command Description
/updatebeacon check Run a fresh update check and display results
/updatebeacon list Show cached results from the last check
/updatebeacon info <modid> Detailed info, channel, and a direct download link for one mod
/updatebeacon scan Integrity scan — verify installed jars against published hashes
/updatebeacon download Download all pending updates to the staging area
/updatebeacon staged Show what is downloaded and waiting to be applied
/updatebeacon apply [seconds] Apply staged updates now, or start a restart countdown
/updatebeacon apply cancel Cancel a running apply countdown
/updatebeacon rollback <modid> Restore a mod's previous jar from backup
/updatebeacon pin <modid> Pin a mod at its current version (suppress updates)
/updatebeacon unpin <modid> Remove a pin
/updatebeacon ignore <modid> Stop checking a mod entirely
/updatebeacon unignore <modid> Resume checking a mod
/updatebeacon channel <modid> <release|beta|alpha|any> Set a mod's update channel
/updatebeacon reload Hot-reload updatebeacon.toml without restarting

Webhooks

Add one [[webhooks]] block per target, each with its own URL and format:

[[webhooks]]
url = "https://discord.com/api/webhooks/..."
format = "discord_embed"

[[webhooks]]
url = "https://your-endpoint.com/hook"
format = "generic_json"

Supported formats:

  • discord_embed — rich embed for Discord webhooks
  • generic_json — simple JSON payload for custom integrations

Installation

Drop the mod jar that matches your Minecraft version and loader into your server's mods/ folder, then start the server once to generate the config.

Requirements:

  • A supported Minecraft version (see table above)
  • Fabric Loader with Fabric API, or NeoForge
  • A free CurseForge API key (optional — only needed for CurseForge update checks)

Configuration

Generated at config/updatebeacon.toml on first run:

[general]
enabled = true
check_on_startup = true
check_interval_minutes = 0   # 0 = disabled; any positive value = minutes between checks

[ignore]
mod_ids = []                 # mod IDs to skip, e.g. ["mymod", "anothermod"]
quiet_when_no_updates = true # suppress all notifications when everything is up to date

[console]
enabled = true

[chat]
enabled = true
ops_only = true              # only notify server operators
permission_level = 2         # minimum permission level to receive notifications

# Add one [[webhooks]] block per target. Supported formats: discord_embed, generic_json
# [[webhooks]]
# url = ""
# format = "discord_embed"

[downloads]
auto_download = false        # automatically download updates after each check
auto_apply = false           # swap staged jars into mods/ on server stop
backup = true                # keep replaced jars in .updatebeacon/backup/
allowed_mod_ids = []         # empty = all mods eligible; non-empty = whitelist
apply_countdown_seconds = 300 # default countdown length for /updatebeacon apply

[curseforge]
# Get a free API key at https://console.curseforge.com/
api_key = ""                 # leave blank to check Modrinth only

# Per-mod update channel: "release", "beta", or "alpha"
[mod_policy]
# lithium = "beta"

# Pin a mod to prevent update notifications. Use /updatebeacon pin <modid>
[mod_pins]

Staged downloads and backups live under .updatebeacon/staged/ and .updatebeacon/backup/.


Notes

Mods are matched on Modrinth by default; CurseForge checks turn on once you set a curseforge.api_key. Mods that aren't published on either platform are silently skipped.


BH Promo

Screenshots

Gallery

  • Operator log when joining server
    Operator log when joining server Fetches all available updates every time the server starts and sends it to op players when they join the server
  • console
    console Example of Mod Beacon flagging updates in the console
  • Staged mods ready for restart
    Staged mods ready for restart If auto update is enabled in config, mods will be downloaded and staged when the server starts. They will be applied next time the server restarts using the apply command
  • /updatebeacon apply command
    /updatebeacon apply command restarts the server and applies all staged mods. Customisable timer with chat warnings
  • /updatebeacon apply command
    /updatebeacon apply command restarts the server and applies all staged mods. Customisable timer with chat warnings
  • Operator log when joining server
    Operator log when joining server Fetches all available updates every time the server starts and sends it to op players when they join the server
  • Console
    Console Example of Mod Beacon flagging updates in the console
  • Staged mods ready for restart
    Staged mods ready for restart If auto update is enabled in config, mods will be downloaded and staged when the server starts. They will be applied next time the server restarts using the apply command

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

<1,000
Total Downloads
CurseForge
<1,000
Modrinth
<1,000
Last Updated
CurseForge
Created
CurseForge
Modrinth
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works