CmlLib.Core.Installer.Modpack은 CmlLib용 에드온(Add-on) 프로젝트로,
CurseForge에서 제공하는 Minecraft 모드팩(.zip)을 손쉽게 읽고 설치할 수 있도록 도와줍니다.
CmlLib.Core.Installer.Modpackis add-on for CmlLib project,
Help easily read and install the Minecraft mode pack provided by Modpack files(.zip).
⚡ 주의: 이 프로젝트는 CmlLib Minecraft 런처 라이브러리를 기반으로 동작합니다.
독립 실행형 런처가 아닌, CmlLib를 사용하는 프로젝트에서 모드팩 관리 기능을 확장하는 용도입니다.
⚡ Caution: This project operates based on the CmlLib Minecraft launcher library.
Rather than a standalone launcher, it is intended to extend modpack management capabilities in projects using CmlLib.
- CurseForge 모드팩 ZIP 파일 읽기 (
manifest.json기반) - Minecraft 버전 및 Forge 로더 자동 감지
- Forge 설치 및 Minecraft 런처 통합
overrides폴더 자동 적용- Manifest에 정의된 모드 파일 다운로드 및 설치
ModPackInstallOptions기반 설치 진행 상태 추적 (파일/바이트 단위)- CmlLib
Process빌드 지원 → 설치 후 바로 게임 실행 가능
- Read CurseForge Modpack ZIP File (based on
manifest.json) - Automatic detection of Minecraft versions and Forge loaders
- Forge installation and Minecraft launcher integration
- Automatically apply the 'overrides' folder
- Download and install mode files defined in Manifest
- Tracking the progress of installation based on 'ModPack Install Options' (in file/byte)
- CmlLib 'Process' Build Support → Run the game immediately after installation
Modrinth 형식의 모드팩도 가능하게// 만듬- Fabric/Forge 자동 전환
- Neoforge 지원
- FTB 형식 지원
Modrinth Modpacks// made.- Fabric/Forge automatic select
- Neoforge Support
- FTB Support
NuGet 또는 직접 프로젝트 참조 방식 사용 가능:
use NuGet. Search CmlLib.Core.Installer.Modpack or You can use below script.
# 프로젝트에 직접 추가
git clone https://github.com/jwyoon1220/CmlLib.Core.Installer.Modpack.git사용 예시 / Example
using System;
using System.Diagnostics;
using System.IO;
using System.Net.Http;
using System.Threading.Tasks;
using CmlLib.Core;
using CmlLib.Core.Auth;
using CmlLib.Core.Installer;
using CmlLib.Core.Installer.Modpack;
using CmlLib.Core.Installer.Modpack.ModpackLoader;
class TestMain
{
/// <summary>
/// ModPack 파일 다운로드
/// Download modpack file to temp directory
/// </summary>
private static async Task<string> DownloadModpackAsync(string url)
{
var target = Path.Combine(
Path.GetTempPath(),
"modpacks",
Path.GetFileName(new Uri(url).LocalPath));
Directory.CreateDirectory(Path.GetDirectoryName(target)!);
using var http = new HttpClient();
await using var stream = await http.GetStreamAsync(url);
await using var file = File.Create(target);
await stream.CopyToAsync(file);
return target;
}
static async Task Main()
{
// =========================
// 1. ModPack 다운로드
// Download modpack file
// =========================
string packPath = await DownloadModpackAsync(
"https://github.com/ihwiyun/hwiyun-discord-bot-oauth/releases/download/server/modpack.zip"
// Modrinth example:
// "https://cdn.modrinth.com/data/xxxx/versions/yyyy/pack.mrpack"
);
// =========================
// 2. ModPack 로더 선택
// Select modpack loader by extension
// =========================
IModPack modpack;
if (Util.IsModrinthModpack(packPath))
{
modpack = new ModrinthModPack(packPath);
}
else if (Util.IsCurseForgeModpack(packPath))
{
modpack = new CurseForgeModPack(packPath);
}
else
{
throw new NotSupportedException("Unsupported modpack format");
}
await using (modpack as IAsyncDisposable)
{
// =========================
// 3. Manifest 로드
// Load modpack manifest
// =========================
Console.WriteLine("Loading modpack...");
await modpack.LoadAsync();
Console.WriteLine($"Provider: {modpack.Provider}");
Console.WriteLine($"ModPack: {modpack.Name} v{modpack.Version}");
Console.WriteLine($"Minecraft: {modpack.MinecraftVersion}");
Console.WriteLine($"Recommended RAM: {modpack.RecommendedRam} MB");
// =========================
// 4. 설치 옵션 구성
// Build install options
// =========================
string instancesRoot = @"C:\users\koroutine\instances";
string instanceDir = Path.Combine(
instancesRoot,
$"{modpack.Name}_{modpack.Version}");
var options = new ModPackInstallOptions
{
// Instance directory
GameDirectory = instanceDir,
// File-based progress (Forge / Minecraft install)
FileProgress = new Progress<InstallerProgressChangedEventArgs>(p =>
{
Console.WriteLine(
$"[File] {p.Name} {p.ProgressedTasks}/{p.TotalTasks}");
}),
// Byte-based download progress
ByteProgress = new Progress<ByteProgress>(p =>
{
Console.WriteLine($"[Bytes] {(p.ToRatio() * 100):F2}%");
}),
// Offline session (no Microsoft login)
Session = MSession.CreateOfflineSession("player"),
// Optional server IP
ServerIp = "your.server",
// Memory settings
MaximumRamMb = modpack.RecommendedRam,
MinimumRamMb = 1024
};
// =========================
// 5. 설치 + 실행 프로세스 생성
// Install modpack and build launch process
// =========================
Console.WriteLine("Installing modpack...");
Process process = await modpack.InstallAndBuildProcessAsync(options);
Console.WriteLine("Installation complete!");
process.Start();
}
}
}
요구사항 / requirement .NET 10
CmlLib.Core (4.0.6)
CmlLib.Core.Installer.Forge(1.1.1)
CmlLib.Core.Installer.NeoForge(4.0.0)
인터넷 연결 (CurseForge 모드 다운로드용) / internet connection.
Windows 11 25H2 환경에서 테스트 완료, Linux/MacOS는 검증되지 않았습니다.
Tested on Windows 11 25H2.