AeroMc-Launcher/README.md

<div align="center">

<img src="src/assets/logo.png" alt="AeroMC Logo" width="140" />

# AeroMC

Ein Minecraft-Launcher für Windows mit getrennten Instanzen, Mod-Unterstützung und Microsoft-Anmeldung.

Aktueller Stand: Version 1.0.4

</div>

## Überblick

AeroMC richtet sich an Spieler, die mehrere Minecraft-Setups sauber voneinander trennen wollen. Jede Instanz kann ihre eigene Version, ihren eigenen Mod-Loader, eigene Mods, eigene Welten und eigene Java-Einstellungen haben.

Der Launcher konzentriert sich auf den Alltag: Instanz anlegen, Konto auswählen, Mods installieren, starten.

## Funktionen

- Beliebig viele getrennte Minecraft-Instanzen
- Unterstützung für Vanilla, Fabric, Quilt, Forge und NeoForge
- Versionsliste mit Filter: Releases, Snapshots oder alle
- Modrinth-Integration für **Mods, Ressourcenpakete und Shader** (inkl. Pflicht-Abhängigkeiten und Update-Prüfung)
- Microsoft-Login mit mehreren Konten
- Gemeinsamer Import für AeroMC-ZIP, Modrinth-Modpacks (`.mrpack`), Minecraft Launcher, CurseForge sowie MultiMC/Prism
- Reimport überschreibt vorhandene Instanzen mit gleichem Namen
- Export, Kopieren, Gruppieren, Löschen und Desktop-Verknüpfung pro Instanz
- Mehrfachauswahl mit Strg-Klick für Sammellöschen
- Globales Backup inkl. automatischer Zeitplan-Sicherungen
- Welten, Ressourcenpakete, Screenshots, Serverliste und Logdateien verwalten
- Online- und Offline-Start
- Eingebaute Konsole/Log-Ansicht
- Skin-Hintergrund des aktiven Kontos (mehrere Posen, einstellbare Deckkraft)
- Eigene Icons (inkl. eigenes Bild) und Notizen pro Instanz
- Java pro Instanz oder global, inkl. automatischem Download fehlender Versionen (Eclipse Temurin)
- RAM-, JVM-, Pre-Launch- und Post-Exit-Einstellungen (global und pro Instanz)
- Optionaler Wrapper-Befehl und HTTP-Proxy für Downloads
- Bedrock-Bereich für vorhandene Bedrock-Installation unter Windows
- Update-Funktion für neue Launcher-Versionen
- Design Hell/Dunkel und Sortierung der Instanzen

## Installation

Es gibt zwei Varianten:

- **AeroMC-Setup.exe** – installiert den Launcher, schneller Start im Alltag
- **AeroMC-Portable.exe** – startet ohne Installation, ideal zum Mitnehmen (etwas längerer Start)

Automatische Updates bleiben getrennt: Setup erhält nur Setup-Updates, Portable nur Portable-Updates. Ein automatischer Wechsel zwischen beiden Varianten findet nicht statt.

## Voraussetzungen

- Windows x64
- Legale Minecraft Java Edition mit Microsoft-Konto
- Internetverbindung beim ersten Download von Minecraft-Dateien, Loadern oder Inhalten
- Für Bedrock: installierte Minecraft Bedrock Edition aus dem Microsoft Store

## Erste Schritte

1. AeroMC installieren oder die portable Datei starten.
2. Über **Konten** ein Microsoft-Konto hinzufügen.
3. Eine neue Instanz anlegen.
4. Minecraft-Version und optional einen Loader wählen.
5. Optional Mods/Ressourcenpakete/Shader hinzufügen oder bestehende Setups über **Importieren** übernehmen.
6. Instanz starten (online oder offline).

## Instanzen

Jede Instanz hat:

- Namen und optionale Gruppe
- Minecraft-Version und optionalen Mod-Loader
- optionales Icon (vorgegeben oder eigenes Bild) und Notizen
- eigene Mods, Ressourcenpakete, Shader, Welten, Screenshots und Serverliste
- eigene Java-, RAM-, JVM-, Pre-Launch- und Post-Exit-Einstellungen (leer = globale Vorgabe)

Über die Seitenleiste einer ausgewählten Instanz erreichst du u. a.:

- Starten / Offline starten
- Instanz und Notizen bearbeiten
- Mods, Ressourcenpakete und Shader
- Welten und Bildschirmfotos
- Server verwalten
- Logdateien ansehen
- Minecraft-, Konfigurations- und Instanz-Ordner öffnen
- Desktop-Verknüpfung erstellen
- Exportieren, Kopieren, Gruppe ändern, Löschen
- Bei importierten Modpacks: Modpack aktualisieren

In der Instanzliste: Suche, Sortierung und **Strg + Klick** für Mehrfachauswahl.

## Import

Über **Importieren**:

| Quelle | Typische Nutzung |
|---|---|
| ZIP-Archiv | AeroMC-Export (`instance.json`) sowie einzelne MultiMC/Prism-Instanzen (auch gezippt) |
| Modpack | Modrinth `.mrpack` |
| Minecraft Launcher | Profile aus dem offiziellen Launcher |
| CurseForge | Instanzen aus dem CurseForge-Ordner |
| MultiMC / Prism | Vorhandene MultiMC- oder Prism-Instanzen |

Existiert bereits eine Instanz mit demselben Namen, wird sie ersetzt.

Beim offiziellen Minecraft Launcher werden nur benutzerdefinierte Profile angeboten (keine „Latest Release“/„Latest Snapshot“). Bei gemeinsamen Standard-Spielordnern übernimmt AeroMC spielrelevante Daten (Mods, Welten, Konfiguration), nicht den kompletten Cache.

## Mods, Ressourcenpakete und Shader

Im Inhalts-Dialog einer Instanz:

- Katalog durchsuchen (Sortierung, Kategorien)
- Installation inkl. Abhängigkeiten
- Installierte Einträge aktivieren, deaktivieren, entfernen
- Nach Updates suchen und alle aktualisieren
- Ordner der jeweiligen Inhaltsart öffnen

Ressourcenpakete und Shader funktionieren auch in Vanilla-Instanzen. Mods benötigen einen Mod-Loader.

## Backup und Wiederherstellung

Unter **Optionen → Backup**:

- Manuelles globales Backup (alle Instanzen + Launcher-Einstellungen)
- Automatische Sicherungen (täglich oder wöchentlich, einstellbare Anzahl)
- Optional zusätzlich vor jedem Spielstart sichern
- Wiederherstellung aus vorhandenem Backup

Speicherort: `Dokumente\AeroMC Launcher\Backups`.

**Wichtig:** Konten und Tokens werden nicht mitgesichert. Beim Wiederherstellen werden aktuelle Instanzen und Launcher-Einstellungen durch den Backup-Inhalt ersetzt.

## Einstellungen

### Allgemein
- Design (Dunkel / Hell)
- Instanzen sortieren (nach letztem Start / nach Name)
- Instanz-Verzeichnis
- Bedrock-Bereich anzeigen

### Darstellung
- Block-Symbole räumlich (3D)
- Skin-Hintergrund: Quelle, Pose, Deckkraft

### Spiel
- Standard-RAM (min./max.)
- Fenstergröße bzw. maximiert starten

### Start & Java
- Globale Java-Auswahl und Erkennung
- Fehlende Java-Version automatisch herunterladen
- Konsole: während des Spiels, nach Beenden schließen, bei Absturz anzeigen, Historie-Limit
- Globale Pre-Launch- / Post-Exit-Befehle
- Optionaler Wrapper-Befehl

### Netzwerk
- HTTP-Proxy (Host, Port, optional Benutzer/Passwort)
- CurseForge: eigener API-Key und/oder Weiterleitungs-Adresse inkl. Token

Ohne eigenen Key und ohne Weiterleitung funktionieren Modrinth-Inhalte weiterhin. Für CurseForge-Downloads wird einer der beiden Wege benötigt.

### Konten
- Mehrere Microsoft-Konten verwalten, aktiv setzen, entfernen

### Backup
- Manuell, Zeitplan und Wiederherstellung

### Info
- Version und manuelle Update-Prüfung

## Bedrock

Der Bedrock-Bereich startet die vorhandene Windows-Store-Version und erleichtert den Zugriff auf Welten, Pakete, Add-ons und Ordner. AeroMC installiert Bedrock nicht selbst. Fehlt die Installation, wird der Bereich automatisch ausgeblendet.

## Konsole, Logs und Crash-Reports

- Konsole über die obere Leiste oder bei Absturz
- Pro Instanz: gespeicherte Logdateien und Crash-Reports einsehen, kopieren und Ordner öffnen

## Datenort

Nutzerdaten liegen lokal unter `%APPDATA%\aeromc`.

## Links

- Webseite: https://m-viper.de
- Gitseite: https://git.viper.ipv64.net
- Autor: M_Viper

## Rechtliches

AeroMC ist kein offizielles Produkt von Mojang oder Microsoft.  
Minecraft ist eine Marke von Mojang AB.

## Lizenz

MIT