Skip to content

v26.0.0-alpha.5.1 - Critical NeoForge Fixes

Pre-release
Pre-release

Choose a tag to compare

View all tags
@StarsailsClover StarsailsClover released this 01 Aug 00:14
v26.0-alpha.5.1
ae395f6

MCDebugLauncher v26.0.0-alpha.5.1

Release Date: 2026-08-01

Critical Fixes

This hotfix release addresses critical issues in Alpha 5 that prevented NeoForge 21.10+ instances from launching correctly.

Fixed

  1. NeoForge version selection now prioritizes stable releases

    • Previous: Alphabetical sorting caused 21.10.0-beta to be selected over 21.10.64
    • Fixed: Semantic version comparison ensures stable releases are selected before pre-releases
    • Impact: mdl create --loader neoforge --loader-version latest now correctly installs the newest stable version

  2. NeoForge patched client path corrected

    • Previous: Looked for net/neoforged/neoforge/<version>/neoforge-<version>-client.jar (incorrect)
    • Fixed: Now uses correct Maven path net/neoforged/minecraft-client-patched/<version>/minecraft-client-patched-<version>.jar
    • Impact: Eliminates "NeoForge patched client not found" warnings and ensures deobfuscated classes are available

  3. Version mismatch detection

    • Added runtime check to detect when instance.json and version.json versions don't match
    • Provides clear error message instead of cryptic "Missing main class" errors
    • Helps users identify when instance recreation is needed

Changed

  • Code quality: Removed 24 unused import warnings
  • Total warnings reduced from 58 to 34

Upgrading from Alpha 5

Important: If you created NeoForge instances with Alpha 5, you should recreate them with Alpha 5.1:

# Backup your worlds first if needed
mdl backup create <instance-name> world-backup

# Remove the old instance
rm -rf "%APPDATA%\mdl\instances\<instance-name>"

# Recreate with correct version
mdl create <instance-name> --mc-version 1.21.10 --loader neoforge --loader-version latest

Installation

Windows (x64)

  1. Download mdl-v26.0-alpha.5.1-windows-x64.zip
  2. Extract to a directory in your PATH (e.g., C:\Program Files\mdl\)
  3. Or run mdl setup to add to PATH automatically

Verify Installation

mdl --version
# Should output: mdl 26.0.0-alpha.5.1

Testing

All 18 unit tests pass. Manual testing confirms:

  • NeoForge 21.10.64 instances create correctly
  • Patched client is found at correct Maven path
  • Launch proceeds without "Missing main class" errors
  • Version mismatch detection triggers correctly

Known Issues

  • NeoForge extra JAR (client-<neoform>-extra.jar) may still show warnings but doesn't prevent launch
  • Some dead code warnings remain (reserved for future features)

Technical Details

Root Causes Fixed

  1. Version Selection Algorithm

    • Old: versions.first() after alphabetical sort
    • New: Semantic version comparison with stable > pre-release priority
    • Implementation: Custom compare_versions() function in src/loader/neoforge.rs

  2. Patched Client Path

    • NeoForge official installer outputs to net/neoforged/minecraft-client-patched/
    • Previous code used legacy path from pre-installer implementation
    • Fix: Updated path construction in src/instance/launcher.rs

Commits in This Release

  • edc37f1 Fix NeoForge version selection and mismatch detection
  • 2da8606 Clean up unused imports and variables
  • b5bf224 Fix NeoForge patched client path
  • ae395f6 Bump version to 26.0.0-alpha.5.1

Links

License

Apache License 2.0 - See LICENSE file for details

Assets 3
Loading