ForgeCLI

모드 검색 및 다운로드

-forgekey 매개변수나 환경변수 FORGEKEY를 통해 CurseForge API에 인증합니다. -projects 옵션으로 특정 모드 ID를 지정하고, -family로 Fabric, Forge, Bukkit 중 원하는 모드 로더를 필터링할 수 있습니다. -release 옵션으로 릴리스, 베타, 알파 버전을 선택하고, -version으로 특정 Minecraft 버전에 맞는 모드를 찾을 수 있습니다.

설치 경로 자동 처리

기본적으로 Windows에서는 %AppData%Roaming.minecraftmods 폴더에 모드를 설치합니다. -destination 옵션을 사용해 저장 경로를 변경할 수 있으며, -clear 플래그를 활성화하면 기존 모드를 모두 삭제한 후 새 모드를 다운로드합니다.

의존성 자동 해결

-dependencies 플래그(기본값 true)를 사용하면 선택한 모드가 필요한 종속 모드도 함께 다운로드합니다. 이는 모드 팩을 구성할 때 수작업으로 의존성을 확인하는 번거로움을 줄여줍니다.

Windows용 설치 방법

Chocolatey를 사용하는 경우, 관리자 권한으로 PowerShell 또는 CMD를 열고 다음 명령을 실행합니다:

choco install forgecli –version=0.0.3 -Y

참고: 현재 Chocolatey 공식 저장소 승인 대기 중이므로, 임시로 scoop을 사용하는 것이 권장됩니다.

Scoop을 사용하는 경우, 먼저 다음 명령으로 shotah 버킷을 추가합니다:

scoop bucket add shotah https://github.com/shotah/scoop-bucket.git

그 다음 forgecli를 설치합니다:

scoop install forgecli

macOS용 설치 방법

Homebrew를 사용하는 경우, 터미널에서 다음 명령을 순서대로 실행합니다:

brew tap shotah/tap

brew install forgecli

기본 사용법/명령어

가장 간단한 사용법은 CurseForge API 키와 함께 특정 모드를 다운로드하는 것입니다. 예를 들어, Fabric 계열의 두 모드를 다운로드하려면 다음과 같이 입력합니다:

forgecli -forgekey ‘$2a$10…’ -projects “416089,391366” -family “fabric” -debug

-debug 플래그를 추가하면 상세한 로그를 확인할 수 있어 문제 해결에 유용합니다.

JSON 파일을 사용한 배치 처리

다수의 모드를 관리해야 할 때는 forgeMods.json과 같은 JSON 파일을 사용할 수 있습니다. 파일 형식은 다음과 같습니다:

[

{

“name”: “fabric api”,

“projectID”: “306612”,

“releaseType”: “release”

},

{

“name”: “fabric voice mod”,

“projectID”: “416089”,

“releaseType”: “beta”,

“version”: “1.18.1”

}

]

이 파일을 사용하려면 다음 명령을 실행합니다:

forgecli -forgekey ‘$2a$10…’ -file “forgeMods.json” -family “fabric” -client -dependencies

이런 경우에 유용합니다

여러 모드를 자주 업데이트해야 하는 Minecraft 서버 관리자나 모드 팩 제작자에게 유용합니다. 수동으로 CurseForge 웹사이트를 방문해 각 모드를 검색하고 다운로드하는 대신, 하나의 명령으로 최신 버전의 모드와 그 의존성을 자동으로 받아올 수 있어 시간을 크게 절약할 수 있습니다.

지원 환경·시스템 요구사항

Windows, macOS, Linux에서 실행 가능합니다. Go 언어로 작성되어 있어 해당 플랫폼용 바이너리를 제공하며, 패키지 관리자(Chocolatey, Scoop, Homebrew)를 통해 쉽게 설치할 수 있습니다. CurseForge API 키가 필수이며, 이는 에서 발급받을 수 있습니다.

제한 사항·확인 사항

-version 매개변수는 부분 일치만 지원하므로, 예를 들어 1.18을 입력하면 1.18.2, 1.18.1, 1.18 등 관련 버전의 모드를 모두 가져올 수 있습니다. 이는 의도된 동작이지만 정확한 버전 고정이 필요한 경우에는 주의가 필요합니다.

-client 플래그는 현재 Fabric 모드에만 작동하며, Forge의 버전 XML 구조를 파싱하는 기능은 아직 구현되지 않았습니다. 따라서 Forge 계열 모드의 클라이언트 설치를 위해서는 별도의 방법이 필요할 수 있습니다.

README에 명시된 바와 같이, 버전 고정이 отсут하기 때문에 퍼블리셔가 예기치 않게 모드를 업데이트할 경우 예기치 않은 동작이 발생할 수 있습니다.