feat(installer): v0.4.0 — 파일제거기, 커스텀 폴더명, 포트포워딩 개편, 이름/개발자용 표기
- 음악퀴즈 파일제거 도구 신규 추가: 동의 → 휴지통/완전삭제 선택 → 커스텀 폴더 (현재값 + 기본 .mc_custom) 전체, 데스크톱 바로가기, gameDir 가 해당 폴더인 마인크래프트 런처 프로필 정리. - MC_CUSTOM_DIR .env 로 커스텀 게임 폴더 이름 유동화(.mc_custom 기본). 렌더러 사전에도 실제 폴더명 반영. - 간편포트포워딩: 실행 중 UPnP 매핑 유지, 창 닫힘/종료 시 자동 제거(activePort 추적). - 개발자용 빌드는 창/헤더 제목 앞에 (개발자용) 표기, exe 이름에도 반영. - exe 이름 변경: 음악퀴즈 간편설치기 / 음악퀴즈 리소스팩설치기 / 간편포트포워딩. - README 및 .env 템플릿 갱신, 버전 0.3.23 → 0.4.0. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
39
README.md
39
README.md
@@ -5,6 +5,8 @@
|
||||
- **관리 사이트** — 음악퀴즈 정보(JSON)와 음악·사진 목록, 데이터팩 출력을 한 곳에서 운영.
|
||||
- **음악퀴즈 간편설치기 (`.exe`)** — `manifest.json` 기반으로 사용자가 마인크래프트 본체·서버·모드를 자동 설치.
|
||||
- **리소스팩 간편설치기 (`.exe`)** — 음악퀴즈 음악·표지를 yt-dlp 로 받아 painting variant 텍스처 리소스팩으로 패키징.
|
||||
- **간편포트포워딩 (`.exe`)** — 원하는 포트를 입력해 UPnP 로 개방. 프로그램을 켜 두는 동안만 열려 있고 창을 닫으면 자동으로 닫힙니다.
|
||||
- **음악퀴즈 파일제거 (`.exe`)** — 설치기들이 만든 게임 폴더·캐시와 런처 프로필을 휴지통 이동 또는 완전 삭제로 한 번에 정리.
|
||||
|
||||
---
|
||||
|
||||
@@ -15,7 +17,9 @@
|
||||
| `src/server/` | 음악퀴즈 관리 웹사이트 (Express + EJS) | `bun start` 또는 `npm start` |
|
||||
| `src/installer/` | 음악퀴즈 간편설치기 (Electron) | `npm run installer` |
|
||||
| `src/installer-rp/` | 리소스팩 간편설치기 (Electron) | `npm run installer:rp` |
|
||||
| `src/shared/` | 두 설치기와 서버가 공유하는 타입·스토어 | — |
|
||||
| `src/installer-pf/` | 간편포트포워딩 도구 (Electron) | `npm run installer:pf` |
|
||||
| `src/installer-uninstall/` | 음악퀴즈 파일제거 도구 (Electron) | `npm run installer:uninstall` |
|
||||
| `src/shared/` | 설치기들과 서버가 공유하는 타입·스토어 | — |
|
||||
| `views/` | EJS 템플릿 (관리 사이트) | — |
|
||||
| `manifest/` | 음악퀴즈별 정의 JSON | — |
|
||||
| `file/list/` | 음악퀴즈별 음악·사진 목록 JSON | — |
|
||||
@@ -43,6 +47,8 @@
|
||||
|
||||
이렇게 분리해 두면 사용자가 평소 쓰던 마인크래프트와 음악퀴즈 설정이 섞이지 않고, 음악퀴즈만 삭제해도 본체에는 영향이 없습니다.
|
||||
|
||||
> **폴더 이름 바꾸기.** 기본값은 `.mc_custom` 이지만 `.env` / `.env.build` 의 `MC_CUSTOM_DIR` 로 다른 이름을 지정할 수 있습니다. 설치기·리소스팩설치기·파일제거기가 모두 이 값을 공유하므로, 값을 바꾸면 세 exe 를 같은 값으로 다시 빌드해야 서로 같은 폴더를 가리킵니다. (경로 구분자 `/ \` 와 `..` 는 무시되어 항상 `%APPDATA%` 바로 아래 단일 폴더가 됩니다.)
|
||||
|
||||
---
|
||||
|
||||
## 빠른 시작
|
||||
@@ -65,8 +71,17 @@ npm run installer
|
||||
# 3) 리소스팩 간편설치기를 Electron 으로 실행해 보기
|
||||
npm run installer:rp
|
||||
|
||||
# 4) 음악퀴즈 간편설치기 윈도우 .exe 빌드
|
||||
npm run dist:win
|
||||
# 4) 간편포트포워딩 / 파일제거 도구 실행해 보기
|
||||
npm run installer:pf
|
||||
npm run installer:uninstall
|
||||
|
||||
# 5) 윈도우 .exe 빌드 (개별)
|
||||
npm run dist:win # 음악퀴즈 간편설치기
|
||||
npm run dist:win:rp # 음악퀴즈 리소스팩설치기
|
||||
npm run dist:win:pf # 간편포트포워딩
|
||||
npm run dist:win:uninstall # 음악퀴즈 파일제거
|
||||
npm run dist:win:dev # (개발자용) 음악퀴즈 간편설치기
|
||||
npm run dist:win:rp:dev # (개발자용) 음악퀴즈 리소스팩설치기
|
||||
```
|
||||
|
||||
리소스팩 설치기는 `yt-dlp` 가 필요합니다. 자동 다운로드되지만, 막혀 있는 환경이라면 [`docs/yt-dlp-setup.md`](docs/yt-dlp-setup.md) 참고.
|
||||
@@ -155,9 +170,13 @@ minecraft_launcher/
|
||||
│ ├─ server/ Express + EJS 관리 사이트
|
||||
│ ├─ installer/ 음악퀴즈 간편설치기 (Electron 메인 + preload)
|
||||
│ ├─ installer-rp/ 리소스팩 간편설치기 (Electron 메인 + 음악/이미지 파이프라인)
|
||||
│ ├─ installer-pf/ 간편포트포워딩 도구 (Electron 메인 + preload)
|
||||
│ ├─ installer-uninstall/ 음악퀴즈 파일제거 도구 (Electron 메인 + preload)
|
||||
│ └─ shared/ 공용 타입, 매니페스트 스토어, mojang/upnp 유틸
|
||||
├─ installer/ 음악퀴즈 설치기 렌더러(HTML/CSS/JS)
|
||||
├─ installer-rp/ 리소스팩 설치기 렌더러(HTML/CSS/JS)
|
||||
├─ installer-pf/ 간편포트포워딩 렌더러(HTML/JS)
|
||||
├─ installer-uninstall/ 파일제거 렌더러(HTML/JS)
|
||||
├─ views/ 관리 사이트 EJS 템플릿
|
||||
├─ public/ 관리 사이트 정적 파일(styles.css 등)
|
||||
├─ manifest/ 음악퀴즈 JSON 정의 (운영자가 편집)
|
||||
@@ -172,18 +191,24 @@ minecraft_launcher/
|
||||
├─ manifest.json 사이트 루트 매니페스트 (자동 관리)
|
||||
├─ account.json 관리자 계정 (절대 외부 노출 금지)
|
||||
├─ package.json
|
||||
└─ tsconfig.{,server,installer,installer-rp}.json
|
||||
└─ tsconfig.{,server,installer,installer-rp,installer-pf,installer-uninstall}.json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 빌드 산출물 / 배포
|
||||
|
||||
| 산출물 | 빌드 명령 | 비고 |
|
||||
| 산출물(파일명) | 빌드 명령 | 비고 |
|
||||
| --- | --- | --- |
|
||||
| 관리 사이트 (Node 실행) | `npm start` | systemd 등으로 띄우기. 외부 도메인이 manifest 의 base URL 이 됩니다. |
|
||||
| 음악퀴즈 간편설치기 `.exe` | `npm run dist:win` | `electron-builder.yml` 설정 사용. |
|
||||
| 리소스팩 간편설치기 `.exe` | `tsconfig.installer-rp.json` 빌드 후 `electron-builder` 수동 패키징 | |
|
||||
| `음악퀴즈 간편설치기-<버전>.exe` | `npm run dist:win` | `electron-builder.yml`. |
|
||||
| `음악퀴즈 리소스팩설치기-<버전>.exe` | `npm run dist:win:rp` | `electron-builder-rp.yml`. |
|
||||
| `간편포트포워딩-<버전>.exe` | `npm run dist:win:pf` | `electron-builder-pf.yml`. |
|
||||
| `음악퀴즈 파일제거-<버전>.exe` | `npm run dist:win:uninstall` | `electron-builder-uninstall.yml`. |
|
||||
| `(개발자용) 음악퀴즈 간편설치기-<버전>.exe` | `npm run dist:win:dev` | 비공개(public=false) 팩만 노출. 제목 앞에 `(개발자용)` 표시. |
|
||||
| `(개발자용) 음악퀴즈 리소스팩설치기-<버전>.exe` | `npm run dist:win:rp:dev` | 상동. |
|
||||
|
||||
빌드 결과물은 `release/` 폴더에 생성됩니다(포터블 exe).
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user