Skip to content
Ian Pontorno / Portfolio
Case study · Current flagship

Minecraft Intelligent Manager

MIM.

Desktop & Web Modding Platform

A desktop and web platform for organizing modpacks, diagnosing failures, protecting files, and collaborating across devices.

Systems EngineeringApplied AIDistributed SystemsSecurityBinary Safe Recovery
MIM Logo

“MIM began as a tool for organizing mods and grew as real problems emerged around diagnostics, storage, recovery, and synchronization.”

My work

I design and develop the product end to end: desktop and web experiences, integrations, file handling, module contracts, technical documentation, and automated checks.

Status

Actively developed

View progress ↗

01.The Engineering Challenge

Modpacks pile up hundreds of JAR files from different authors, and it doesn't take long before something breaks: two mods fight over the same dependency, a Mixin injects bytecode at the wrong moment, or a world save gets silently corrupted. The stacktrace Minecraft gives you is barely readable, and by the time something visibly fails, the actual cause happened several steps earlier.

MIM isn't a download manager with extra steps. Every one of these failure modes — dependency conflicts, corrupted saves, unsafe mods, fragmented state across devices — is a different kind of problem, so I split them into separate subsystems, each with its own contract and its own way of failing safely without taking the rest of the app down with it.

02.Decoupled Domain Engines as Capabilities

Five subsystems, each doing one job well:

SAGE — Crash Intelligence

Deterministic Diagnostics + AI Explanation

A rules-based engine reads the stacktrace and scores likely culprits using evidence, not guesswork. Only after that diagnosis exists does an LLM turn it into a plain-language explanation — it explains the verdict, it doesn't make one.

Aduana — Content-Addressed Storage

I/O & CAS

Every file gets a SHA-512 identity, so the same mod downloaded from Modrinth or CurseForge is recognized as the same file and never re-fetched. A cache keyed on mtime + size skips redundant I/O entirely.

FOMO Cloud — Distributed Synchronization

Distributed Systems

Works offline first: changes apply optimistically, queue in IndexedDB if you're disconnected, and resolve with last-write-wins once you're back online. Postgres Row-Level Security keeps each user's data isolated at the database level, not just in app logic.

Security Engine — Static JVM Analysis

Application Security

Inspects a mod's bytecode and AST without running it, looking for patterns you'd expect from malware: process spawning, reflection used to dodge checks, raw sockets, native libraries loaded without declaring it.

NBT Rescue — Binary Data Recovery

Binary & Storage

Before touching a world save, it backs it up, writes to a temp file, validates the result, and only then swaps it in atomically. If anything goes wrong mid-write, the original is still there.

03.Event-Driven System Architecture

How the five engines talk to each other without turning into one tangled system:

Presentation Layer

Electron Native Shell + Next.js App Router + Mobile PWA

Reactive Typed Event Bus

MimEventMap Contract · Fault-Isolated Observers

Tiered Persistence

IndexedDB + Content-Addressed Local FS + PostgreSQL (RLS)

MIM is organized around five isolated domain engines connected through a typed event bus (MimEventMap). Each one owns a single responsibility and talks to the others only through explicit contracts — so a failure in one engine, say NBT Rescue hitting a corrupted save, never cascades into the rest.

04.Empirical Measured Benchmarks

Auditable empirical metrics verified across automated test suites:

100%

Macro F1-Score

SAGE canonical crash corpus

84%

Top-1 Culprit

Strict root-cause attribution

8×–8.5×

Warm-Cache Speedup

Aduana 1k to 25k scaling

42 ms

Realtime Broadcast

Supabase WebSocket pub/sub

< 8 ms

Optimistic UI Mutation

React 19 + IndexedDB frame

0.06 ms

Mean Inference Latency

Per crash log evaluation

* Note: Benchmarks are project-specific measurements under the documented test conditions in headless suites.

05.Product Features & User Experience

Dual-Source Catalog Discovery

Integrated Modrinth and CurseForge search with identifier normalization.

JVM Tuning & Argument Presets

Memory and argument presets for different hardware profiles and garbage collectors.

3D WebGL Skinview Avatar

Interactive 3D Minecraft avatar rendering inside the user profile.

Graceful Showcase Video Fallbacks

Fallback to YouTube when embedded extraction or playback is unavailable.

06.Full Technology Stack

Next.js 16 (App Router)React 19TypeScript 5Electron 42PostgreSQLSupabase Realtime (WebSockets)Row-Level Security (RLS)IndexedDB (SmartCache)Node.js 22Chokidar (File Watching)yt-dlpFramer MotionTailwind CSS v4Turbopack