Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
DropOut은 재현 가능하고 검사 가능한 게임 환경을 제공하는 결정론적(deterministic) 마인크래프트 런처입니다. 이 도구는 개발자들이 안정적으로 테스트할 수 있는 환경을 구축하도록 지원하며, 기술 스택으로는 Tauri 2, Rust, React 19 등을 사용합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기<b>DropOut</b>은 하나의 아이디어를 중심으로 구축된 현대적이고 개발자 수준의 마인크래프트 런처입니다: 게임 설정이 소프트웨어 프로젝트처럼 추적 가능해야 한다는 것입니다.
대부분의 런처는 게임 시작에 초점을 맞춥니다. DropOut은 주변 환경(계정 상태, Java 런타임, 게임 버전, 로더, 인스턴스 디렉토리, 에셋, 라이브러리 및 실행 로그) 또한 이해할 수 있도록 유지합니다.
마인크래프트 환경은 복잡한 시스템입니다. DropOut은 이를 버전 관리되는 작업 공간(versioned workspaces)으로 취급합니다.
DropOut은 세 가지 활성 표면을 가진 데스크톱 애플리케이션입니다:
| Surface | Path | Stack | Purpose |
|---|---|---|---|
| Desktop shell | src-tauri/ | Rust, Tauri 2 | 인증(Authentication), 다운로드, Java/버전 해결, 인스턴스 저장소, 실행 오케스트레이션(launch orchestration) |
| ... |
Rust 코어는 부작용(side effects)을 담당합니다. React UI는 Tauri 명령을 호출하고 상태를 렌더링합니다. docs 패키지는 제품, 아키텍처 및 사용자 워크플로우를 설명합니다.
사전 구축된 DropOut 번들은 릴리스 페이지에서 게시됩니다. 런처를 실행하는 데 Rust나 Node.js가 필요하지 않으며, 해당 기술은 개발 빌드에만 필요합니다.
| 플랫폼 | 아키텍처 | 다운로드 | 설치 |
|---|---|---|---|
| Windows 10/11 | x86_64, ARM64 | NSIS -setup.exe | 설치 프로그램을 실행한 다음, 시작 메뉴에서 DropOut을 실행합니다. |
| ... | |||
에셋 이름에는 버전과 아키텍처가 포함되어 있습니다. 예를 들어 Dropout_0.2.0-rc.2_amd64.AppImage와 같습니다. 사용하려는 OS와 CPU 접미사(x64/amd64/x86_64 또는 arm64/aarch64)에 맞는 파일을 선택하세요. |
모든 데스크톱 에셋에는 서명된 GitHub 빌드 출처(provenance)가 포함되어 있으므로, 설치하기 전에 이 리포지토리의 릴리스 워크플로우에서 왔는지 확인할 수 있습니다:
gh attestation verify ./downloaded-asset -R HydroRoll-Team/DropOut
Alpine Linux는 musl 아카이브가 시작되기 전에 네이티브 WebKitGTK 라이브러리가 필요합니다:
sudo apk add ca-certificates gtk+3.0 libayatana-appindicator librsvg openssl webkit2gtk-4.1
sha256sum -c Dropout_*-musl.tar.gz.sha256 &&
tar -xzf Dropout_*-musl.tar.gz &&
...
musl 아카이브는 Alpine 패키지에 동적으로 연결되어 있습니다. glibc 배포판에서는 대신 AppImage, .deb, 또는 .rpm을 사용하세요. 직접 번들을 구축하려면 데스크톱 릴리스 빌드를 참조하세요.
단계별 설치 지침, 첫 실행 가이드 및 문제 해결 방법은 문서에 있습니다: English · 简体中文.
이 리포지토리는 pnpm-workspace.yaml을 사용하지 않습니다. 각 JavaScript 서피스(surface)를 루트 잠금 파일(root lockfile)에 대해 설치하세요:
pnpm install
pnpm -C packages/ui --lockfile-dir "$PWD" install
pnpm -C packages/docs --lockfile-dir "$PWD" install
pnpm install은 또한 리포지토리의 prepare 스크립트를 실행하여 로컬 prek 후크를 설치합니다.
pnpm exec tauri dev
Tauri는 src-tauri/tauri.conf.json을 통해 React UI 개발 서버를 시작하고, http://localhost:1420에서 데스크톱 창을 엽니다.
pnpm exec tauri build
릴리스 아티팩트는 Tauri에 의해 Rust 타겟 디렉토리와 구성된 번들 디렉토리 아래에서 생성됩니다.
pnpm -C packages/ui dev
pnpm -C packages/docs dev
UI는 레이아웃 작업을 위해 브라우저에서 실행될 수 있지만, Tauri 기반 플로우(flow)는 데스크톱 셸(shell)을 필요로 합니다. 반복 가능한 브라우저 전용 UI 작업의 경우, packages/ui/README.md에 문서화된 개발 피처(fixtures) 및 Playwright 워크플로우를 사용하십시오.
| 태스크 | 명령어 |
|---|---|
| 루트 툴링 설치 | pnpm install |
| ... |
배포 유지 관리는 docs/cloudflare-deployment.md에 문서화되어 있습니다.
.
|-- assets/ # README 및 프로젝트 미디어
|-- crates/ # Rust 지원 크레이트 및 매크로
...
명령어 경계(command boundary)는 src-tauri/src/main.rs에 등록되어 있습니다. 기능 모듈은 src-tauri/src/core/ 아래에 존재합니다:
auth.rs와 account_storage.rs: Microsoft 및 오프라인 계정 상태를 처리합니다.instance.rs: 격리된 인스턴스 디렉토리와 메타데이터를 소유합니다.game_version.rs, manifest.rs, migration.rs: Minecraft 버전을 확인하고 실행 규칙을 결정합니다.fabric.rs, forge.rs, maven.rs, downloader.rs: 로더, 라이브러리, 에셋 및 버전 파일을 설치합니다.java/: 호환 가능한 Java 런타임을 감지, 검증 및 영구 저장합니다.modpack/, mods.rs, content_search.rs: 모드팩 파싱, 모드 메타데이터, 콘텐츠 검색을 처리합니다.assistant.rs: 선택적 문제 해결 어시스턴트(troubleshooting assistant)를 구동합니다.UI는 packages/ui/src/models/에 장기 상태(long-lived state)를 유지하고, packages/ui/src/pages/에서 라우트를 렌더링하며, packages/ui/src/components/에서 재사용 가능한 컨트롤을 공유합니다.
공개 로드맵은 https://roadmap.sh/r/minecraft-launcher-dev에서 확인할 수 있습니다.
DropOut은 장기적인 유지보수성을 염두에 두고 구축되었습니다. 유용한 기여는 보통 다음 영역 중 하나를 개선합니다:
표준 GitHub 흐름을 사용하세요: 포크(fork), 브랜치(branch), 커밋(commit) 후 HydroRoll-Team/DropOut에 풀 리퀘스트(pull request)를 열어주세요.
UI 기여자들은 또한 fixture 및 회귀 테스트 가이드를 읽어야 합니다.
GNU Affero General Public License v3.0에 따라 배포됩니다. 자세한 내용은 LICENSE를 참조하세요.
