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

업로드 동작

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

• admin/data/uploads/

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

예:

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

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

주의

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

추천 운영 방식

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