@torba/mojang

Zero-binding Mojang JSON parsers. Parses Mojang version manifests and client JSONs into typed structures. No dependencies on other unipack packages.

Install

npm install @torba/mojang zod

API

Version manifest

import {
  fetchVersionManifest,
  findVersion,
  latestRelease,
} from '@torba/mojang';

const manifest = await fetchVersionManifest();

const version = findVersion(manifest, '1.20.1');
const latest = latestRelease(manifest);

console.log(latest.id); // e.g. '1.21.4'
console.log(latest.url); // URL to the version JSON

Client JSON

import { parseClient } from '@torba/mojang';

const res = await fetch(version.url);
const client = parseClient(await res.json());

client.id; // version string
client.mainClass; // entry point class
client.args.game; // game arguments
client.args.jvm; // JVM arguments
client.libraries; // library list with rules and artifact info
client.assetIndex; // asset index reference

Asset manifest

import { fetchAssetManifest } from '@torba/mojang';

const assets = await fetchAssetManifest(client.assetIndex.url);
// assets.objects: Record<string, { hash: string; size: number }>

Argument merging

import { mergeArgs } from '@torba/mojang';

// Merge vanilla args with a mod loader's overrides
const merged = mergeArgs(client.args, forgeArgs);

Notes

• This package is intentionally a leaf in the dependency graph — it has no unipack dependencies.
• Use @torba/minecraft to convert parsed Mojang types into Manifest artifacts.