Files
minecraft_launcher/docs/admin-site.md
claude-bot 9786cfe031
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
Refactor launcher profiles and port automation
2026-05-05 21:52:17 +09:00

59 lines
1.8 KiB
Markdown

# 관리자 사이트
런처 설치 페이지에 표시되는 프로필을 JSON 직접 수정 없이 웹 UI로 관리하는 로컬 관리자 사이트입니다.
## 실행
```bash
npm run admin
```
기본 주소:
- `http://127.0.0.1:8787`
## 현재 구현 범위
- 프로필 추가 / 수정 / 삭제 / 복제
- `맵` 기본 + `모드`, `플러그인`, `서버` 체크 조합
- `distribution.json` 업로드 / 새로 만들기 / 직접 편집
- 월드 ZIP 업로드
- 서버용 버킷 JAR 업로드
- 서버 포트 / 메모리 / 최대 인원수 / 화이트리스트 설정
- 저장 시 아래 두 파일을 동시에 갱신
- `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-paper.jar`
## 주의
- 접속 주소는 관리자 사이트에서 다루지 않습니다.
- 접속 주소는 사용자가 런처 라이브러리에서 직접 입력합니다.
- 지금 1차 버전은 로컬 운영용입니다.
- 기본 서버 바인딩은 `127.0.0.1` 이라 같은 PC에서만 접속됩니다.
## 추천 운영 방식
1. 관리자 사이트에서 프로필과 자료 파일을 입력
2. 로컬 런처에서 실제 표시와 실행 확인
3. 이후 필요하면 업로드 경로를 공개 URL 기반으로 확장