Skip to content

Professional Minecraft mod manager with hash-based identification, automatic updates, dependency resolution, search integration, and modpack export. Supports mods, modpacks, resource packs, data packs, plugins, and shaders across Fabric/Forge/NeoForge/Quilt.

License

Notifications You must be signed in to change notification settings

BryantWelch/mcmodupdate.app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

88 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Minecraft Mod Updater & Builder

A powerful web-based tool to update your Minecraft mods, discover new ones, and build modpacks with ease, all using the official Modrinth API.


MC Mod Updater Demo

๐ŸŽฏ About The Project

This tool was built to solve two common problems for Minecraft players: the tedious process of manually updating dozens of mods, and the challenge of building a new mod list with all the correct dependencies.

MC Mod Updater provides a simple, elegant solution by allowing you to either drag-and-drop your existing .jar files, your current .mrpack, or search for new mods directly. It then uses a powerful, hash-based search to accurately identify your mods on Modrinth and find the latest compatible versions for your chosen Minecraft version and mod loader.

โœจ Key Features

Core Functionality

  • ๐Ÿ” Accurate Mod Identification: Uses a hash-first search for 100% accuracy, with smart ID/Name search as fallback
  • ๐Ÿ”— Automatic Dependency Resolution: Automatically finds and includes required dependencies (APIs, libraries, etc.)
  • ๐Ÿ”Ž Mod Discovery: Built-in search to find and add new mods directly from Modrinth's database
  • ๐Ÿ“ฆ Modpack Export: Download as standard .mrpack files for easy import into launchers

Platform Support

  • ๐Ÿงต Fabric - Full support with latest versions
  • โš’๏ธ Forge - Complete compatibility
  • ๐Ÿ”ฅ NeoForge - Modern Forge alternative support
  • ๐Ÿชก Quilt - Fabric fork compatibility
  • ๐ŸŽฎ All Minecraft Versions - From legacy to latest releases

Performance & UX

  • โšก Smart Caching - Session-based caching reduces API calls and improves speed
  • ๐Ÿ“Š Batch Processing - Efficient handling of large mod collections
  • ๐Ÿšฆ Rate Limit Handling - Transparent API rate limit management with countdown
  • ๐Ÿ“ฑ Mobile Responsive - Works perfectly on phones and tablets
  • ๐ŸŽจ Modern UI - Clean, dark theme with intuitive controls

Rich Information Display

  • ๐Ÿ–ผ๏ธ Mod Icons & Details - Visual mod information with descriptions
  • ๐Ÿ‘ค Author Information - Direct links to mod creators
  • ๐Ÿ“ˆ Download Statistics - See mod popularity metrics
  • ๐Ÿ“ Changelogs - View what's new in mod updates
  • ๐Ÿท๏ธ Categories & Tags - Understand mod types at a glance

๐Ÿš€ How To Use

  1. ๐ŸŽ›๏ธ Select Your Target: Choose your mod loader (Fabric, Forge, NeoForge, Quilt) and Minecraft version
  2. ๐Ÿ“ Add Your Mods:
    • To Update: Drag and drop existing .jar files or your .mrpack into the upload area
    • To Discover: Use the search bar to find new mods from Modrinth
  3. โš™๏ธ Process Your List: Click the "Update" button and watch the magic happen
  4. ๐Ÿ“ฅ Review & Download: Get latest compatible versions plus dependencies that you can download individually, as a .zip, or as a complete .mrpack

๐Ÿ› ๏ธ Tech Stack

Built with performance and accessibility in mind, using modern web standards without heavy frameworks.

Frontend

  • Vanilla HTML, CSS, and JavaScript - No framework bloat, maximum performance
  • Responsive Design - Mobile-first approach with desktop enhancements
  • Progressive Enhancement - Works with JavaScript disabled (basic functionality)

Libraries & APIs

  • JSZip - Client-side .jar file reading and .mrpack creation
  • TOML.js - Parse mods.toml files for mod identification
  • Marked.js - Render mod changelogs from Markdown
  • CryptoJS - Calculate SHA-1 file hashes for accurate identification
  • Modrinth API - All mod data, versions, and metadata

Infrastructure

  • Netlify - Hosting with automatic deployments
  • Rybbit Analytics - Privacy-focused, cookie-free analytics
  • Custom Domain - Professional presence at mcmodupdate.app

๐Ÿ“Š Performance Features

  • Session Caching - Reduces API calls by 60-80% on repeat operations
  • Batch Processing - Handle 100+ mods efficiently
  • Smart Rate Limiting - Automatic backoff with user-friendly countdown
  • Optimized Assets - Fast loading with proper caching headers
  • Mobile Optimized - Lightweight and fast on mobile devices

๐Ÿค Contributing

Contributions make the open-source community amazing! Any contributions are greatly appreciated.

Ways to Contribute

  • ๐Ÿ› Bug Reports - Found an issue? Open an issue with details
  • ๐Ÿ’ก Feature Requests - Have an idea? Tag it with "enhancement"
  • ๐Ÿ”ง Code Contributions - Fork, branch, code, and PR!
  • ๐Ÿ“– Documentation - Help improve guides and explanations
  • ๐ŸŒ Translations - Help make it accessible worldwide

Development Process

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

๐Ÿ“„ License

Distributed under the Mozilla Public License 2.0. See LICENSE for more information.

This license ensures that:

  • โœ… You can use this tool freely for any purpose
  • โœ… You can modify and distribute the code
  • โœ… Any improvements to the original files must be shared back
  • โœ… Commercial use is allowed

๐Ÿ™ Acknowledgments

  • Modrinth Team - For providing an amazing, free API that makes tools like this possible
  • Minecraft Modding Community - For creating the incredible mods that make Minecraft endlessly enjoyable
  • Open Source Contributors - Everyone who helps improve this tool

Made with โค๏ธ for the Minecraft community

About

Professional Minecraft mod manager with hash-based identification, automatic updates, dependency resolution, search integration, and modpack export. Supports mods, modpacks, resource packs, data packs, plugins, and shaders across Fabric/Forge/NeoForge/Quilt.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages