minecraft_launcher/docs/launcher-catalog.md

Launcher Catalog

프로필은 관리자 측에서 미리 등록합니다.

• 기본 로컬 파일: app/assets/launcher/catalog.json
• 또는 운영용 원격 JSON

클라이언트는 설치 페이지에서 이 카탈로그를 읽기 전용으로 확인하고, 원하는 항목만 자기 라이브러리에 추가합니다.

형식

{
  "version": 1,
  "profiles": [
    {
      "id": "my-map-profile",
      "name": "My Map Profile",
      "description": "설명",
      "details": "설치 페이지 상세 패널에 표시할 긴 설명",
      "modsEnabled": true,
      "pluginsEnabled": false,
      "serverEnabled": false,
      "distributionUrl": "admin/data/distributions/my-map-profile.distribution.json",
      "worldArchiveUrl": "https://example.com/worlds/my-map.zip",
      "worldDirectoryName": "My Map"
    },
    {
      "id": "my-plugin-server-profile",
      "name": "My Plugin Server Profile",
      "description": "플러그인 서버 포함 프로필",
      "details": "주소가 없으면 로컬 서버를 실행하고, 주소가 있으면 해당 서버로 접속합니다.",
      "modsEnabled": false,
      "pluginsEnabled": true,
      "serverEnabled": true,
      "distributionUrl": "admin/data/distributions/my-plugin-server-profile.distribution.json",
      "worldArchiveUrl": "https://example.com/worlds/plugin-map.zip",
      "worldDirectoryName": "Plugin Map",
      "serverJarUrl": "https://example.com/server/paper.jar",
      "serverPort": 25565,
      "serverMemoryMb": 4096,
      "serverMaxPlayers": 20,
      "serverWhitelistEnabled": false
    }
  ]
}

필드

• id: 내부 식별자
• name: 라이브러리/설치 페이지 표시 이름
• description: 표시 설명
• details: 설치 페이지 상세 패널에 표시할 긴 설명
• modsEnabled: 모드 기능 사용 여부
• pluginsEnabled: 플러그인 기능 사용 여부. 켜면 서버도 같이 사용
• serverEnabled: 서버 기능 사용 여부
• distributionUrl: Helios distribution.json URL 또는 로컬 경로
• worldArchiveUrl: 월드 ZIP 또는 로컬 경로
• worldDirectoryName: 게임 saves/ 아래와 로컬 서버 world/에 사용할 월드 폴더 이름
• serverJarUrl: 로컬 서버 실행에 사용할 버킷 JAR 경로 또는 URL
• serverPort: 로컬 서버 포트
• serverMemoryMb: 로컬 서버 최대 메모리(MB)
• serverMaxPlayers: 로컬 서버 최대 인원수
• serverWhitelistEnabled: 로컬 서버 화이트리스트 사용 여부

런처가 계산하는 상태

아래 값들은 런처가 내부적으로 계산하는 상태라 파일에 직접 넣지 않아도 됩니다.

• launchReady: 실행에 필요한 필드가 모두 있는지 여부
• hostReady: 서버 기능 프로필이 로컬 호스팅 가능한지 여부

판정 기준:

• 공통 실행: distributionUrl, worldArchiveUrl, worldDirectoryName
• 로컬 서버 실행 추가 조건: serverEnabled=true 이고 serverJarUrl 존재

현재 구현 범위

• 맵 기반 싱글플레이 실행
• 맵 + 모드 클라이언트 실행
• 서버 기능 프로필의 직접 주소 입력 접속
• 서버 기능 프로필의 로컬 버킷 JAR 실행
• 자동 포트 개방 상태 표시