Files
minecraft_launcher/docs/admin-site.md
claude-bot e266387784
Some checks failed
Build / release (macos-latest) (push) Has been cancelled
Build / release (ubuntu-latest) (push) Has been cancelled
Build / release (windows-latest) (push) Has been cancelled
Windows Smoke Test / windows-smoke (push) Has been cancelled
Add admin distribution editor
2026-05-05 19:16:09 +09:00

61 lines
1.9 KiB
Markdown

# 관리자 사이트
런처 설치 페이지에 표시되는 프로필을 JSON 직접 수정 없이 웹 UI로 관리하는 로컬 관리자 사이트입니다.
## 실행
```bash
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 기반으로 확장