ZOYKUHot Board

ayr1k/amber-launcher기술 문서

An independent Minecraft: Java Edition launcher with isolated instances, Java management and Fabric support.

언어 대체 안내:해당 저장소의 한국어 문서가 제공되지 않아 공식 영문 원본(English)으로 표시됩니다.
npm i amber-launcher

AMBER

Your world. Your way.

Release License Build Website

Website · Downloads · User guide · Themes · 简体中文

An independent Minecraft: Java Edition launcher bringing instances, content, themes and server management into one workspace.

Screenshots

AlloyNocturne
AMBER Alloy theme home screen AMBER Nocturne theme home screen

Public AMBER 1.2.1 theme previews using demonstration data; these themes also work with AmberE. Click to enlarge. See the 1.6.4 notes below for current features and platform availability.

Overview

AMBER is an independent launcher for Minecraft: Java Edition. It keeps game instances separate and brings installation, mod management, recovery and launch settings into one workspace. Project-owned source is licensed under MPL-2.0.

1.6.4

Add optional, default-off conservative trimming of the launcher main process before Minecraft starts, with bounded waiting, shared cooldown and separate skip/whole-launch cancellation feedback.

Windows/macOS/Linux/FreeBSD packages share version 1.6.4. Native macOS/Linux acceptance is pending; FreeBSD is experimental server/tools-only.

Windows x64 release with additional platform downloads. Download the installer, source and checksums. Includes instance management, content recommendations, mod updates, backups and recovery.

  • Integrated title bar, independent window corners, remembered window placement and reorganized privacy settings.

  • Native Simplified Chinese and English, with instant language switching and importable text-only language packs.

  • Vanilla, Quilt, Fabric, Forge, NeoForge, LiteLoader and OptiFine workflows with explicit compatibility checks. Support depends on the game version and official artifacts.

  • Compatible Modrinth search, categories and sorting; selectable dependencies; mod updates, version locks and bulk content management.

  • Local mod import, cross-version mod-list migration, content recovery history, instance backup and restore, recycle bin and guarded permanent deletion.

  • Favorites, sorting, recent launches, instance checks, restart-resumable installation plans and data-location migration.

  • Themes, square or rounded controls, custom layout, local backgrounds and adjustable launch-panel opacity.

Install

Download the Windows x64 Setup executable from Releases, verify its SHA-256 checksum and run it. The installer offers Chinese and English. Close games and AMBER before upgrading; retain backups of important worlds. Uninstalling the program does not automatically remove game data. The installer is unsigned.

Account status

Minecraft API access for AMBER has been approved. Launch continues to verify eligibility. Approval is not an endorsement by Mojang or Microsoft. AMBER includes its public Microsoft Client ID. Login failure never silently switches to offline mode. AMBER requires online official eligibility verification for Microsoft and linked third-party launches. Explicitly created verified offline identities retain the official UUID, with an editable offline name with a maximum seven-day encrypted eligibility cache; this is a product policy, not a Mojang-approved exception. Legacy unverified offline accounts cannot launch in AMBER. Existing game instances and saves are preserved.

Third-party services require separate live validation. Offline mode does not grant Minecraft ownership or online-service access.

Platforms and verification

Windows x64: EXE; macOS Intel / Apple Silicon: separate ZIPs; Linux x64: DEB. macOS needs device testing; Linux needs full desktop/keyring and gameplay testing. FreeBSD amd64 is an experimental server/tools bundle only. Packages are unsigned and macOS is not notarized. See setup and limitations and the platform downloads.

Documentation

AMBER is not an official Mojang or Microsoft product. Minecraft, downloaded components and third-party projects retain their respective rights and licenses.

Rollback guide / 回滚说明

Product family

Project Purpose
AMBER Everyday use with Microsoft sign-in and eligibility verification
AmberE Offline and third-party identities; does not grant game ownership or authenticated server access
AmberX Experimental goal-based workflows, comparison and trials

Each project uses separate data and update channels.

Official theme store · Theme help · Theme format

Alloy, Nocturne, Harvest and Verdant are free official themes for AMBER and AmberE 1.2.1 or newer, available separately and not preinstalled.

Server and connection guide (remote rooms are a testing feature).

Acknowledgements

This section thanks users whose suggestions have been accepted into the project. It will remain here for future accepted contributions of ideas and feedback.

  • Bilibili user @北目宁游戏 (UID 391446396) — proposed letting a host select a modded environment and letting players confirm downloading the host's mods after joining the room. This inspired the room client environment synchronization introduced in 1.5.2.
  • Bilibili user @萨拉赫蒙-十恶不赦 (UID 2003495984) — suggested memory optimization, inspiring the manual launcher-only memory optimization introduced in 1.6.0. Thank you for the idea!
GitHub 공식 원본 저장소에서 아카이브된 문서 미러 · GitHub 저장소 방문
동기화 기준일: 2026-11-11