명령줄
Windows
인수 없이 LeviLauncher.exe를 실행하면 런처 창이 열립니다. 명령을 주면 터미널에서 실행된 뒤 종료하며, 명령은 <명사> <동사> 형식을 따릅니다.
text
LeviLauncher.exe <command> [arguments] [flags]이 페이지는 LeviLauncher 1.1.0의 모든 명령을 나열합니다. LeviLauncher.exe help <command>는 각 명령의 플래그와 예제를, LeviLauncher.exe help는 개요를 출력합니다. 명령줄의 출력은 영어입니다.
text
LeviLauncher.exe install latest --loader --use
LeviLauncher.exe play
LeviLauncher.exe mod install LiteLDev/LegacyMoney
LeviLauncher.exe world export "My World" -o D:\Backups
LeviLauncher.exe instance list --json셸에서 실행하기
LeviLauncher.exe는 창 프로그램이므로 셸은 기본적으로 그것을 기다리지 않습니다. 프롬프트가 돌아오기 전에 출력이 필요하거나 종료 코드가 필요하면:
- cmd에서는
start /wait LeviLauncher.exe ...를 쓰고%ERRORLEVEL%을 읽습니다. - PowerShell에서는 출력을 파이프로 넘기거나(
LeviLauncher.exe instance list | Out-String)Start-Process -Wait -NoNewWindow를 씁니다.
명령줄은 창을 열지 않으며, 창이 열려 있는 동안에도 실행할 수 있습니다.
명령
일상
| 명령 | 하는 일 |
|---|---|
play [<instance>] |
게임을 시작하고 창이 나타날 때까지 기다림(launch의 별칭) |
install <version|file> |
Minecraft를 다운로드해 새 인스턴스로 설치(= instance create) |
use [<instance>] |
기본 인스턴스를 설정하거나 표시 |
stop [<instance>|<pid>...] |
실행 중인 Minecraft를 닫음(= process stop) |
인스턴스 관리
| 명령 | 하는 일 |
|---|---|
instance list [<filter>] |
설치된 인스턴스 목록 |
instance show [<instance>] |
인스턴스의 설정, 등록, 로더, 플레이어, 콘텐츠 수를 표시(instance <instance>도 가능) |
instance create <version|file> |
Minecraft를 다운로드해 새 인스턴스로 설치 |
instance copy-data [<instance>] --from system|<instance> |
게임 데이터(월드, 설정)를 자체 데이터를 가진 인스턴스로 복사 |
instance rename <instance> <new-name> |
인스턴스 이름 변경 |
instance set [<instance>] |
인스턴스 설정 변경(콘솔, 편집기 모드, 자체 데이터, 인수, 환경, 로고) |
instance remove <instance>... |
인스턴스와 그 폴더의 모든 것을 영구 삭제 |
instance register [<instance>] |
Windows가 이 인스턴스를 해당 채널의 설치된 Minecraft로 취급하게 함 |
instance unregister [<instance>] |
인스턴스의 Windows 등록 해제(게임 데이터는 유지) |
instance shortcut [<instance>] |
인스턴스를 시작하는 바탕 화면 바로 가기를 만들거나 제거 |
instance path [<instance>] [<kind>] |
인스턴스의 폴더를 출력(원하면 열기) |
mod list [<filter>] |
인스턴스의 모드 목록 |
mod show <package> |
카탈로그의 모드를 표시 |
mod search [<words>] |
LeviLamina 모드 카탈로그 검색 |
mod install <package[@version]>... |
카탈로그에서 모드를 설치, 업그레이드 또는 다운그레이드 |
mod update [<mod>...] |
카탈로그 모드를 최신 버전으로 업데이트 |
mod import <file>... |
.mcmod, .zip, .dll 파일에서 모드 추가 |
mod set <mod> |
모드의 매니페스트 변경 |
mod remove <mod>... |
인스턴스에서 모드 제거 |
mod enable <mod>... | --all |
모드 켜기 |
mod disable <mod>... | --all |
모드를 제거하지 않고 끄기 |
mod path [<mod>] |
모드 또는 인스턴스 모드 폴더의 경로 출력 |
loader versions |
게임 버전에 사용할 수 있는 LeviLamina 버전 목록 |
loader install [<version>] |
인스턴스에 LeviLamina를 설치하거나 버전 변경 |
loader remove |
인스턴스에서 LeviLamina 제거 |
world list [<filter>] |
인스턴스와 플레이어의 월드 목록 |
world import <file.mcworld>... |
.mcworld 파일에서 월드 가져오기 |
world export <world>... |
월드를 .mcworld 파일로 내보내기(백업) |
world copy <world>... |
월드를 다른 인스턴스로 복사 |
world rename <world> <new-name> |
월드의 표시 이름 변경 |
world get <world> [<key>[/<sub>...]] |
level.dat에서 월드 설정 읽기 |
world set <world> <key>[/<sub>...]=<value>... |
level.dat의 월드 설정 변경 |
world remove <world>... |
월드를 영구 삭제 |
pack list [<filter>] |
리소스 팩, 행동 팩, 스킨 팩 목록 |
pack import <file.mcpack|file.mcaddon>... |
.mcpack, .mcaddon 파일에서 팩과 애드온 설치 |
pack copy <pack>... | --all |
팩을 다른 인스턴스로 복사 |
pack remove <pack>... |
설치된 팩 삭제 |
screenshot list |
인스턴스와 플레이어의 스크린샷 목록, 최신순 |
screenshot remove <name|path>... | --all |
스크린샷 삭제 |
server list [<filter>] |
저장된 서버 목록과 온라인 여부 확인 |
player list |
GDK 인스턴스의 플레이어 프로필 목록 |
backup list [<instance>] |
인스턴스 백업과 월드 백업 목록(미리 보기 기능) |
backup create [<instance>] |
인스턴스의 게임 데이터와 모드 백업(미리 보기 기능) |
backup restore [<instance>] <archive.zip> |
인스턴스 백업 복원(미리 보기 기능) |
설치할 것 찾기
| 명령 | 하는 일 |
|---|---|
installer search [<version>] |
설치할 수 있는 Minecraft 빌드 목록 |
installer download <version> |
빌드의 설치 패키지를 설치하지 않고 다운로드 |
installer list |
다운로드한 설치 패키지 목록, 완료되지 않은 다운로드 포함 |
installer remove <version|file>... |
다운로드한 설치 패키지를 삭제해 디스크 공간 확보 |
installer mirrors <version> |
GDK 빌드의 다운로드 미러 측정 |
curseforge search [<words>] |
CurseForge에서 월드, 애드온, 팩, 스킨 검색(명사의 별칭: cf) |
curseforge show <id> |
CurseForge 프로젝트 표시 |
curseforge categories |
필터에 쓸 CurseForge 클래스와 카테고리 목록 |
curseforge install <id> |
CurseForge 파일을 다운로드해 인스턴스로 가져오기 |
이 PC와 런처
| 명령 | 하는 일 |
|---|---|
process list |
실행 중인 Minecraft 프로세스 목록, 런처가 시작하지 않은 것 포함(별칭: ps) |
process stop [<instance>|<pid>...] |
실행 중인 Minecraft를 강제 종료(마지막 자동 저장 이후의 진행 상황은 사라짐) |
account status |
로그인된 Microsoft 계정과 소유한 에디션 표시 |
account login |
Microsoft 계정에 로그인하거나 계정 전환 |
account logout |
런처의 Microsoft 계정을 잊음 |
config list |
런처 설정과 폴더 목록 |
config get <key> |
설정 값 출력 |
config set <key> <value> |
설정 변경 |
config unset <key> |
설정을 기본값으로 되돌림 |
cache clean [packages|downloads|partial]... |
캐시가 차지하는 디스크 공간 확보 |
doctor [--fix [<fix>...]] |
이 PC에서 Minecraft와 모드에 필요한 것을 확인, --fix로 수리(vcruntime, gameinput, loader-migration, developer-mode) |
self-update |
LeviLauncher 자체를 최신 릴리스로 업데이트 |
version |
버전 정보 출력 |
help [<command>...] |
모든 명령의 도움말과 예제 |
모든 list 동사는 ls로도, 모든 remove 동사는 rm으로도 쓸 수 있습니다. config가 읽고 바꾸는 설정은 모든 설정에 있습니다.
버전과 패키지
install과installer의<version>은installer search의 빌드입니다. 정확한 버전(1.21.50.07), 점으로 구분된 접두사(1.21.50은 최신1.21.50.x이며,1.21.5는 이와 일치하지 않음) 또는latest.<file>은 로컬.msixvc,.appx,.msix,.appxbundle,.msixbundle입니다.mod install의<package>는owner/repo,github.com/owner/repo또는 URL이며,#variant와@version을 붙일 수 있습니다.
전역 플래그
다음 플래그는 모든 명령에서 쓸 수 있습니다.
| 플래그 | 의미 |
|---|---|
-i, --instance <name> |
대상 인스턴스 |
-p, --player <id|gamertag> |
플레이어 프로필(GDK 인스턴스) |
--json |
stdout에 기계가 읽을 수 있는 출력 |
-q, --quiet |
식별자만 출력, 진행 상황이나 알림 없음 |
-v, --verbose |
더 자세한 정보와 stderr로 런처 로그 |
-y, --yes |
확인에 예라고 답함 |
--no-input |
절대 묻지 않음 |
-h, --help |
명령 도움말 |
--version |
버전 출력 |
어떤 인스턴스: -i, 없으면 환경 변수 LEVILAUNCHER_INSTANCE, 없으면 기본 인스턴스(use), 없으면 유일한 인스턴스. 어떤 플레이어: -p, 없으면 LEVILAUNCHER_PLAYER, 없으면 유일한 프로필, 없으면 로그인된 계정의 프로필.
출력
- 결과는 stdout으로 갑니다. 진행 상황, 알림, 오류는 stderr로 가며, 오류는
error:로 출력되고hint:와[ERR_GAME_RUNNING]같은 오류 코드가 붙습니다. --json은 JSON 문서 하나를 출력합니다. 목록은 배열, 그 외에는 객체이며, 키는 camelCase, 시간은 RFC 3339, 크기는 바이트 단위입니다.-q는 식별자만 한 줄에 하나씩 출력합니다.
종료 코드
| 코드 | 의미 |
|---|---|
| 0 | 성공 |
| 1 | 실패 |
| 2 | 사용법 오류 |
| 3 | 찾을 수 없음 |
| 4 | 충돌(예: 게임이 실행 중) |
| 5 | 로그인 또는 라이선스 |
| 6 | 네트워크 |
| 7 | 일부만 완료 |
| 8 | 시스템 변경 또는 관리자 권한 필요 |
| 9 | 시간 초과 |
| 10 | 취소됨 |
| 130 | 중단됨(Ctrl-C) |
launch --wait-exit는 대신 게임 자체의 종료 코드를 반환합니다.
창 인수
다음 인수는 명령을 실행하는 대신 창을 엽니다.
| 인수 | 효과 |
|---|---|
--launch=<instance> |
런처를 열고 인스턴스를 시작합니다. 바탕 화면 바로 가기가 이것을 씁니다. 런처가 이미 실행 중이면 거기서 인스턴스를 시작합니다. |
--debug |
런처 로그를 콘솔 창에도 표시합니다(debug, -debug, /debug도 동작). |