ModMate

ModMate is a safety-first performance and diagnostics mod for large Minecraft Fabric modpacks. It combines user-controlled quality presets with narrowly verified compatibility optimizations for repeated hot paths found through real profiling. An optimization is enabled only when the installed upstream classes match the exact reviewed SHA-256 fingerprints; unknown versions fail closed and keep their original behavior.

This is the first public alpha for Minecraft 1.21.1 only. It does not guarantee a minimum FPS, and it is not a replacement for Sodium, Lithium, or every mod-specific performance fix.

Features

• Three quality presets: Performance, Balanced, and Quality
• Configurable 120/140/160/180 FPS target used by the adaptive controller, not advertised as a hard floor
• 4/6/8/12 GiB memory budgets with staged pressure responses
• Safe option ownership journal and rollback of ModMate-owned changes
• In-game settings screen (O) and diagnostics overlay (F8)
• Bounded background analysis of resource packs and shader packs without extracting ZIP files
• Automatic detection of overlapping optimization ownership
• Exact-fingerprint compatibility fast paths for supported versions of Carry On, BetterGrassify, Sodium Dynamic Lights, BedrockIf/Bedrockoid, Continuity, Entity Culling, Puzzles Lib, FancyMenu, Charm, and Sodium Leaf Culling
• Automatic fallback when a target mod or reviewed class version does not match

Measured alpha validation

Every value below compares three fresh-JVM baseline runs with three optimized runs. Each run used the same world, position, 854x480 window, graphics settings, and 180-second measurement period.

The heaviest Medieval MC combat scene improved from a 25.93 FPS median to 36.81 FPS. This is a meaningful relative improvement, not a claim that every system or modpack will reach 160-180 FPS. Peak heap also regressed by 4.43% in one Better MC shader test and by 0.85% in the Medieval MC combat test, so memory improvement is not guaranteed in every scene.

Requirements

• Minecraft 1.21.1
• Fabric Loader 0.19.2 or newer
• Fabric API 0.116.11+1.21.1 or newer compatible 1.21.1 build
• Java 21

ModMate may be installed on the client. Its current player-facing settings, HUD, pack analysis, and compatibility hot paths are client-side. The JAR can also load safely in a Fabric server environment, but this alpha does not advertise server-side world simulation optimization.

Installation

1. Install Fabric Loader and Fabric API for Minecraft 1.21.1.
2. Put the ModMate JAR in the instance mods folder.
3. Start the game. Existing video options are not changed on first launch.
4. Press O, review a preset and memory budget, then choose Apply.
5. Press F8 to show or hide the diagnostics overlay.

Safety and compatibility

• ModMate records original option values before applying changes.
• Rollback only restores values still owned by ModMate; manual user changes are preserved.
• Unsupported compatibility targets remain unmodified.
• Pack scanning is bounded by entry count, depth, logical size, and path checks.
• Benchmark automation and combat entity spawning are test-only launch features and are not active in normal play.

Known alpha limitations

• Only the 1.21.1 JAR contains the complete player-facing feature set in this release.
• FPS targets guide adaptation but cannot force the GPU, CPU, shader, or other mods to meet that number.
• Modpack-specific fast paths only activate for reviewed upstream binaries.
• Some scenes may use slightly more peak heap even when frame consistency improves.
• This alpha has been exercised with 549 and 691 Fabric Loader modules; it has not been proven against every possible 1,000-mod combination.

License and distribution

ModMate is distributed under an All Rights Reserved binary license. Personal, non-commercial use of the unmodified official release is permitted. CurseForge-hosted modpacks may reference the original ModMate project file through CurseForge's official manifest or dependency system. Reuploads, mirrors, modified redistribution, paid resale, and third-party launcher distribution require prior written permission. Commercial integration, customization, and support may be licensed separately.

The public build does not verify purchases or lock optimization features behind an external payment. See the included META-INF/LICENSE for the complete terms.

한국어 안내

ModMate는 대형 Fabric 모드팩의 반복 작업을 실제로 측정하고, 검증된 모드 버전에만 안전한 핫패스 최적화를 적용하는 성능·진단 모드입니다. 품질 프리셋, 메모리 보호, 설정 복원, 리소스팩·셰이더 분석, 진단 HUD를 제공합니다. 현재 공개 후보는 Minecraft 1.21.1 전용 Alpha이며 목표 FPS를 강제로 보장하지 않습니다. O로 설정 화면을 열고 F8로 진단 HUD를 전환할 수 있습니다.

Asset disclosure

The ModMate project icon was generated with AI assistance as an original brand mark. It is a logo and does not depict or claim in-game visual content.