Server Mod Updater

ServerModUpdater

Keep your Minecraft server mods up to date — without manually checking hundreds of mod pages.

ServerModUpdater is a lightweight, server-side mod management utility for Minecraft 1.21.1 / NeoForge, developed by HardySofty.

It checks installed mods against Modrinth and CurseForge, identifies available updates, generates detailed reports, and allows server administrators to update their mods directly through Minecraft commands.

The mod also offers optional AutoModpack integration, making it especially useful for servers with large or customized modpacks.

Features

🔎 Update Detection

• Scan installed .jar files for available updates.
• Check both Modrinth and CurseForge.
• Match installed files against published mod versions.
• Find updates compatible with the Minecraft version and mod loader.
• Combine results from both platforms into a single entry, preserving both links.
• Leave unidentified and unsupported mods untouched.

📦 Mod Updates with Backup Protection

Update individual mods or multiple mods using server commands.

When installing an update, ServerModUpdater:

1. Downloads the selected version.
2. Verifies the downloaded file.
3. Renames the previous .jar file to .jar.old.
4. Places the updated JAR in the original mod directory.
5. Notifies the administrator that a server restart is required.

Updates can be installed while the server is running. New versions take effect after restarting the server.

Automatic dependency compatibility is not guaranteed. Administrators should review updates before installing them.

🔗 Optional AutoModpack Support

ServerModUpdater supports AutoModpack installations, including mod files stored in additional modpack directories and groups.

AutoModpack integration is disabled by default and can be enabled in the configuration:

enableAutoModpack=true

After updating AutoModpack-managed files, the mod reminds administrators to run:

/amp generate

Then restart the server to apply the changes.

📋 Detailed Update Reports

Generate Markdown and JSON reports containing:

• Installed and available versions.
• Links to Modrinth and CurseForge.
• Original JAR locations.
• Update availability and verification results.
• Unidentified mods.

Reports are saved with timestamps, preserving previous scan results.

⚙️ Configuration and Localization

ServerModUpdater supports configurable API settings, request timeouts, retry behavior, release channels, and optional AutoModpack integration.

English and Russian localization are supported through the configuration file.

Example:

language=en_us
enableAutoModpack=false
includeBeta=false
includeAlpha=false

🖥️ Server Commands

Command	Description
/modupdates check	Check installed mods for updates
/modupdates status	Show the latest scan status
/modupdates list [page]	List available updates
/modupdates update list [page]	List selectable updates
/modupdates update <id> <provider>	Update a selected mod
/modupdates update all dryrun	Preview bulk updates
/modupdates update all confirm <token>	Confirm bulk updates
/modupdates update status	Show update progress
/modupdates rollback <id>	Restore a previous version
/modupdates diagnose curseforge	Diagnose CurseForge API connectivity
/modupdates configpath	Display the configuration file location
/modupdates help	Show available commands

Commands are intended for server operators and administrators.

Requirements

• Minecraft: 1.21.1
• Mod Loader: NeoForge
• Environment: Dedicated Server
• CurseForge API key: Required for CurseForge integration
• AutoModpack: Optional

ServerModUpdater does not need to be installed by players.

Important Notes

• ServerModUpdater does not guarantee compatibility between updated mods.
• Back up your server before performing bulk updates.
• Some mods may not be available through either platform.
• Download restrictions imposed by third-party platforms must be respected.
• Local downloading and installing a mod does not automatically grant permission to redistribute it.
• AutoModpack distribution must comply with the licenses and permissions of individual mod authors.
• Updates take effect only after restarting the server.

About the Project

ServerModUpdater was conceived and designed by HardySofty to simplify maintenance of large Minecraft server modpacks.

The project's concept, architecture, update workflow, and development direction were defined by its author. AI-assisted development tools, including OpenAI Codex, were used during implementation, debugging, and testing.

Author: HardySofty
Project: ServerModUpdater
Version: 1.2.0