Kobu is a simple, no-fuss library that helps you fetch Minecraft versions, download modpacks from Modrinth and CurseForge, and fetch mod loaders — all with just a bit of code.

🚀 Quick Start

import kobu from "kobu";

// Get Minecraft versions
const latest = await kobu.minecraft.latest();
console.log(`Latest release: ${latest.release}`);

const releases = await kobu.minecraft.releases();
console.log(`Found ${releases.length} releases`);

// Get loader versions
const fabricVersions = await kobu.fabric.versions();
const paperBuilds = await kobu.paper.builds("1.20.4");

// Advanced filtering
const recentVersions = await kobu.minecraft.filter({
  type: "release",
  after: "2025-07-22",
  limit: 5,
});

📚 API Reference

Minecraft

// Basic version info
await kobu.minecraft.versions(); // All versions
await kobu.minecraft.releases(); // Release versions only
await kobu.minecraft.snapshots(); // Snapshot versions only
await kobu.minecraft.latest(); // Latest release & snapshot

// Detailed version info
await kobu.minecraft.version("1.20.4"); // Detailed version data
await kobu.minecraft.serverDownloadUrl("1.20.4");
await kobu.minecraft.clientDownloadUrl("1.20.4");

// Advanced filtering
await kobu.minecraft.filter({
  type: "release", // Filter by type
  after: "2023-01-01", // After date
  before: "2024-01-01", // Before date
  limit: 10, // Limit results
});

// Utilities
await kobu.minecraft.isValidVersion("1.20.4"); // Check if version exists
kobu.minecraft.compareVersions("1.20.4", "1.19.4"); // Compare versions

Fabric

await kobu.fabric.versions(); // Loader versions
await kobu.fabric.loaderVersions(); // Detailed loader info
await kobu.fabric.installerVersions(); // Installer versions
await kobu.fabric.supportedMinecraftVersions(); // Supported MC versions
await kobu.fabric.latest(); // Latest versions
kobu.fabric.downloadUrl("1.20.4", "0.15.3"); // Download URL

Paper

await kobu.paper.versions(); // Supported MC versions
await kobu.paper.builds("1.20.4"); // Available builds
await kobu.paper.build("1.20.4", 318); // Specific build info
await kobu.paper.latestBuild("1.20.4"); // Latest build
kobu.paper.downloadUrl("1.20.4", "", 318); // Download URL

Forge

await kobu.forge.versions(); // Forge versions
await kobu.forge.loaderVersions(); // Detailed loader info
await kobu.forge.supportedMinecraftVersions(); // Supported MC versions
await kobu.forge.latest(); // Latest versions
kobu.forge.downloadUrl("1.20.4", "47.2.0"); // Download URL

Modpacks (Coming Soon)

// Download from Modrinth
await kobu.modrinth.downloadModpack("sodium-plus");

// Download from CurseForge
await kobu.curseforge.downloadModpack("all-the-mods-9");

// Search modpacks
await kobu.modrinth.searchModpacks({ category: "optimization" });

🎯 Advanced Examples

Download Latest Server

// Get the latest Minecraft server
const latest = await kobu.minecraft.latest();
const serverUrl = await kobu.minecraft.serverDownloadUrl(latest.release);
console.log(`Download server: ${serverUrl}`);

// Get the latest Paper build
const latestPaper = await kobu.paper.latestBuild(latest.release);
console.log(`Latest Paper: ${latestPaper.fileName}`);

Version Compatibility Check

// Check if a Fabric version supports a Minecraft version
const fabricMcVersions = await kobu.fabric.supportedMinecraftVersions();
const isSupported = fabricMcVersions.includes("1.20.4");
console.log(`Fabric supports 1.20.4: ${isSupported}`);

Filter Recent Versions

// Get recent release versions with details
const recentReleases = await kobu.minecraft.filter({
  type: "release",
  after: "2025-07-22",
  limit: 5,
});

for (const version of recentReleases) {
  const details = await kobu.minecraft.version(version.id);
  console.log(`${version.id} - Java ${details.javaVersion.majorVersion}`);
}

Compare Loader Versions

// Compare different loaders for the same MC version
const mcVersion = "1.20.4";

const [fabricVersions, paperBuilds] = await Promise.all([
  kobu.fabric.loaderVersions(),
  kobu.paper.builds(mcVersion),
]);

console.log(`Fabric has ${fabricVersions.length} versions`);
console.log(`Paper has ${paperBuilds.length} builds for ${mcVersion}`);

🏗️ Development

# Install dependencies
bun install

# Run tests
bun test

# Format code
bun run format:apply

# Check formatting
bun run format:check