Skip to content
 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ModInfo+ 📊✨

Track real-time GitHub download statistics for Mindustry mods directly in-game, now with search and GitHub integration!


🌟 What is ModInfo+?

ModInfo+ is a lightweight statistics viewer that connects to GitHub's API to fetch actual download counts for your favorite Mindustry mods. No more guessing — see exactly how popular each mod is with real data.

Now with mod search, GitHub repo stars, and in-game README viewing.


📊 Features

  • ✅ Real-time GitHub statistics with detailed mod view
  • ✅ Smart 5-minute caching system
  • ✅ Category-based organization (My Mods, Content Mods, Tool Mods)
  • ✅ Paginated view (2 mods per page for zero lag)
  • ✅ 60-second refresh cooldown
  • ✅ Download counts formatted (1.2K, 3.5M, etc.)
  • NEW: Click mod names for detailed statistics
  • NEW: Tier system (💎 Diamond, ⭐ Gold/Silver/Bronze, 🛡️ Rising Star)
  • NEW: Star button opens GitHub repo
  • NEW: Search mods by name or owner
  • NEW: View a mod’s README in-game
  • ✅ Star counts and release dates
  • ✅ Growth rate tracking (downloads/month)
  • ✅ Cache timer display (shows time until auto-refresh)
  • ✅ Color-coded status indicators
  • ✅ Clean, intuitive UI with navigation

🎮 How to Use

  1. Click the ModInfo+ button in the main menu
  2. Select a category from the top tabs
  3. Browse mods (2 per page) or use Search
  4. Click on any mod name to view detailed statistics
  5. Click the ⭐ Star button to open the GitHub repo
  6. Click View README to read the mod’s README in-game
  7. Use < Prev and Next > to navigate
  8. Hit Refresh to update stats (1-minute cooldown)
  9. Watch the cache timer count down until auto-refresh

📦 Currently Tracked

⭐ My Mods (3)

  • Unit Namer Mod
  • Shop System Mod
  • ModInfo+ Mod

📚 Content Mods (8)

  • The Infestations
  • Astralis
  • Lovecraftian Library
  • Thermal Engineering
  • Rusted Dunes
  • Echo Fleet
  • Arikoth
  • More Defences

🛠️ Tool Mods (2)

  • Mod Tools
  • HJSON++

Total: 13 mods tracked across 3 categories


🏆 Tier System

Click any mod to see its tier badge based on downloads:

Tier Downloads Badge
💎 Diamond 10,000+ 💎
⭐ Gold 5,000+
⭐ Silver 1,000+
⭐ Bronze 500+
🛡️ Rising Star <500 🛡️

📊 Detailed Statistics View

Basic Stats:

  • Total downloads (formatted)
  • Release count
  • GitHub star count

Timeline:

  • Latest release date
  • First release date

Growth Metrics:

  • Downloads per month (estimated growth)

Tier Badge:

  • Visual tier indicator with icon

Actions:

  • ⭐ Star → Opens GitHub repo
  • 📖 README → Reads mod README in-game

🔍 How It Works

ModInfo+ connects to the GitHub API and fetches:

  • All releases for each tracked mod
  • Download counts for each release asset
  • Repository information (stars, dates)
  • Total downloads across all versions

Smart Caching System:

  • Cached for 5 minutes per mod
  • Automatic refresh on expiry
  • Manual refresh cooldown: 60s

⚠️ Important Notes

  • Some mods may show 0 downloads due to no release assets or private repos
  • Ensure internet connection is active
  • GitHub API token included for access

🎨 UI Design v1.3

  • Category tabs → Switch between My Mods, Content Mods, Tool Mods
  • Pagination → 2 mods per page
  • Clickable mod names → Open detailed stats
  • ⭐ Star button → Opens GitHub repo
  • 📖 README button → Read mod README
  • Status colors → Yellow (loading), White (success), Red (failed)
  • Cache display → Time until next refresh
  • Navigation → Disabled at page limits
  • Tier badges → Visual achievement indicators
  • 🔍 Search bar → Search mods by name/owner

📜 Changelog

v1.3

  • 🔍 Added search bar for mods
  • ⭐ Star button opens GitHub repo
  • 📖 View mod README in-game
  • UI minor improvements and performance fixes

v1.2

  • Clickable mod names for detailed stats
  • Tier system (Diamond, Gold, Silver, Bronze, Rising)
  • Star counts and release dates
  • Growth rate tracking
  • Added 3 new content mods: Echo Fleet, Arikoth, More Defences

v1.1

  • Smart 5-minute caching system
  • Cache timer display
  • Added 8 new tracked mods (total: 10)
  • Reorganized into 3 categories
  • Improved navigation

v1.0 (Initial Release)

  • Real-time GitHub stats
  • Paginated 2-per-page view
  • Manual refresh 60s cooldown
  • Color-coded UI with status indicators
  • Initial tracked mods: Unit Namer Mod, Shop System Mod

📜 Version Info

  • Current Version: v1.3
  • Mods Tracked: 13
  • Categories: 3
  • New Features: Search, GitHub star button, in-game README, UI updates

Thanks for using ModInfo+ and helping grow the Mindustry mod community! 🎉

About

More mod info in mindustry

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages