Mod - Modrinth
Update Beacon
Automatically checks for and updates your servers mods - highly configurable
Source-provided project description. FreeMinecraftMods keeps creator credit and adds separate compatibility and decision guidance below.
Project overview
# UpdateBeacon [](https://moogsmods.com/discord?r=modrinth-updatebeacon) [](https://www.curseforge.com/members/finndog_123/projects) [](https://modrinth.com/user/FinnSetchell) 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 ` | 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 ` | Restore a mod's previous jar from backup | | `/updatebeacon pin ` | Pin a mod at its current version (suppress updates) | | `/updatebeacon unpin ` | Remove a pin | | `/updatebeacon ignore ` | Stop checking a mod entirely | | `/updatebeacon unignore ` | Resume checking a mod | | `/updatebeacon channel ` | 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: ```toml [[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](https://console.curseforge.com/) *(optional — only needed for CurseForge update checks)* --- ## Configuration Generated at `config/updatebeacon.toml` on first run: ```toml [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_second
FreeMinecraftMods decision guide
This mod is most relevant to players looking for management on fabric, neoforge. Treat those labels as discovery hints, then verify the exact file and dependency list on the official project page.
The source record was updated on Sep 18, 2026, which is a recent freshness signal. A recent date does not guarantee support for every loader or Minecraft version, so still inspect the current file list.
What to verify before choosing a file
- Confirm that the file is published by the credited creator on the linked official source.
- Match the Minecraft version exactly instead of relying only on a broad category label.
- Read dependencies, incompatibilities, and changelog notes before updating an existing instance.
- Match the loader or server platform and its required version. Forge and NeoForge are not interchangeable.
- Back up worlds and configuration files before testing the project in a long-term save or public server.
Compatibility at a glance
Minecraft versions in this snapshot: 1.20.1, 1.21.1, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1.1, 26.1.2, 26.3
Loaders and platforms: fabric, neoforge
Before you install
Match the exact Minecraft version and loader, install every required dependency, and test in a separate profile before opening an important world. Keep a backup before changing a working mod list.
Source, licensing, and corrections
FreeMinecraftMods does not mirror the project files. Use the official source for downloads, release notes, dependencies, support, and licensing details. Project names, images, and creator-written descriptions remain the property of their respective owners.
How listings are reviewed | Report incorrect project information | Rights-holder and DMCA information
This source record is available for discovery, but it does not yet contain enough verified description, classification, image, freshness, or compatibility information to be indexed as a full editorial page. It is therefore marked noindex and is not eligible for advertising.