nyoUpdates | ⚡Blazing Fast Mod Manager

Added

• Bundle support - Automatically extracts and installs mods that come in bundle .zip files
  • Detects bundles with mods/ and earlyplugins/ folders inside
  • Extracts the .jar files to the correct locations
  • Handles nested structures (e.g., bundle-name/mods/mod.jar)
  • EarlyPlugins are only installed if the earlyplugins/ folder already exists with jars
  • Example: hyfixes-bundle-v1.9.7.zip → extracts hyfixes-1.9.7.jar to mods
• Bundle verification - Mods extracted from bundles are now found on CurseForge
  • Matches by version number when filenames don't match exactly
  • Example: local hyfixes-1.9.0.jar matches CurseForge hyfixes-bundle-v1.9.0.zip
• Linux/Mac official paths - Uses official Hytale paths:
  • Windows: %APPDATA%\Hytale\UserData\Mods
  • Linux: $XDG_DATA_HOME/Hytale/UserData/Mods or ~/.local/share/Hytale/UserData/Mods
  • macOS: ~/Library/Application Support/Hytale/UserData/Mods
• Steam Proton support - Automatically detects Hytale mods folder in Steam Proton on Linux
• Agnostic fallback search - If mods folder not found, searches common locations recursively
• Manual CurseForge mapping - New curseforgeMapping config option to manually specify CurseForge slugs
  • Useful for mods with similar names (e.g., "votifier" vs "hytale-votifier")
  • Example: "curseforgeMapping": {"hytale-votifier-1.0.0-SNAPSHOT.jar": "hytale-votifier"}
• New /updates mapping command - Add CurseForge mappings directly from in-game
  • /updates mapping add <id|name> <curseforge-url> - Add a mapping for a mod
  • /updates mapping remove <id|name> - Remove a mapping
  • /updates mapping list - Show all current mappings
• Improved /updates list command - Now shows mod IDs for easier ignore/mapping commands
  • Shows [OK], [IGNORED], or [MAPPED] status for each mod
  • Shows quick command reference at the bottom
• Improved /updates ignore command - Now accepts mod ID or name
• New /updates debug command collection:
  • /updates debug info - Show system info, paths, environment, config
  • /updates debug check - Run verbose check showing each mod's CurseForge URL, version comparison, and result
  • /updates debug mods - Show detailed information about each installed mod
• Unverified mods feedback - When mods can't be found on CurseForge, shows at end of check:
  • Mod name and filename
  • File size (for debugging)
  • All URLs that were tried (up to 5)
  • Possible matching projects found
  • Instructions for adding a manual mapping
• Improved /updates enable messages:
  • Shows detailed setup instructions
  • Warns about the --accept-early-plugins flag requirement
  • Explains what happens if the flag is missing
• Improved /updates disable messages:
  • Tries to delete EarlyPlugin JAR, falls back to renaming if locked
  • Shows warning if JAR couldn't be deleted (must delete manually)
  • Explains exactly what files need to be deleted manually
  • Shows how to use manual mode after disabling

Fixed

• CRITICAL: Prevents replacing wrong mods - Fixed bug where mods with similar names could be confused
  • Example: hytale-votifier-1.0.0 and votifier-1.4 are DIFFERENT mods, not versions of the same mod
  • NyoUpdates was incorrectly treating them as the same mod and "updating" 1.0.0 to 1.4
• Strict file verification - Now the installed file MUST exist in the project's file history
  • Checks for EXACT filename AND filesize match
  • If the file is not found in the project history, the project is rejected
  • No more false positives from mods with similar names
• Bundle extraction in pending.json - Fixed bug where bundle zip name was saved instead of extracted jar
  • Now correctly saves the extracted .jar filename for EarlyPlugin to process
• Version-based verification for bundles - Verifies mods that come from bundles
  • Matches modname-X.Y.Z.jar with modname-bundle-vX.Y.Z.zip on CurseForge
  • Removes "bundle" from comparison to find correct matches
• Improved slug generation - Now generates more variants to find mods on CurseForge
  • Strips "Hytale" prefix (e.g., "HytaleVotifier" → "votifier")
  • Splits camelCase names (e.g., "HytaleVotifier" → tries "votifier" separately)
• Manual mappings always trusted - Mods with manual mappings skip verification entirely
  • If you add a mapping, NyoUpdates trusts it 100%
  • This ensures mapped mods always get updates even if file doesn't match exactly
• No more "candidates" fallback - Previously, if only 1 similar project was found, it was used anyway
  • Now, if no exact match is found, the mod is SKIPPED entirely
  • Shows detailed warning with instructions to configure manually
• Custom mods path validation - Validates path exists before using
• Fixed --help for all commands - Now shows proper usage and examples

Changed

• Verification strategy: tries up to 5 CurseForge projects before giving up
• No more false updates: if verification is ambiguous, skips the mod entirely
• Better logging: shows all candidate projects when ambiguous
• Mods folder search now verifies presence of .jar files before accepting a path
• Removed deprecated /updates apply command (use /updates check instead)
• Improved command help messages with examples and better formatting