minecraft_launcher/docs/admin-site.md

관리자 사이트

런처 설치 페이지에 표시되는 프로필을 JSON 직접 수정 없이 웹 UI로 관리하는 로컬 관리자 사이트입니다.

실행

npm run admin

기본 주소:

• http://127.0.0.1:8787

현재 1차 구현 범위

• 프로필 추가 / 수정 / 삭제 / 복제
• modpack, map, server-pack 종류별 입력 폼
• distribution.json 업로드 / 새로 만들기 / 직접 편집
• 맵 ZIP, 서버 번들 ZIP 업로드
• 저장 시 아래 두 파일을 동시에 갱신
  • admin/data/catalog.json
  • app/assets/launcher/catalog.json

distribution 편집

• distribution 파일 칸에서 JSON 업로드 가능

• JSON 편집 버튼으로 현재 연결된 로컬 distribution.json 수정 가능

• 새로 만들기 버튼으로 샘플 템플릿에서 새 distribution.json 생성 가능

• 저장된 distribution 파일은 아래에 생성됩니다.

  • admin/data/distributions/

• 접속주소 필드는 관리자 사이트에서 다루지 않습니다. 런처 내부 접속 흐름과 분리해서 프로필 자료만 관리합니다.

업로드 동작

업로드 버튼으로 올린 파일은 아래에 저장됩니다.

• admin/data/uploads/

카탈로그에는 현재 프로젝트 기준 상대 경로가 저장됩니다.

예:

• admin/data/uploads/1715000000000-my-pack.zip

이 방식은 로컬 테스트에는 바로 쓸 수 있습니다.

주의

• 지금 1차 버전은 로컬 운영용입니다.
• 기본 서버 바인딩은 127.0.0.1 이라 같은 PC에서만 접속됩니다.
• 외부에서 쓰는 공개 관리자 사이트로 만들려면 인증과 공개 URL 저장 방식을 추가해야 합니다.

추천 운영 방식

1. 관리자 사이트에서 프로필과 자료 파일을 입력
2. 로컬 런처에서 실제 표시와 실행 확인
3. 이후 필요하면 업로드 경로를 공개 URL 기반으로 확장