diff --git a/README.md b/README.md index 244b243..91cf43b 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ Ein Minecraft-Launcher für Windows mit getrennten Instanzen, Mod-Unterstützung und Microsoft-Anmeldung. -Aktueller Stand: Version 1.0.3 +Aktueller Stand: Version 1.0.4 @@ -20,86 +20,167 @@ Der Launcher konzentriert sich auf den Alltag: Instanz anlegen, Konto auswählen - Beliebig viele getrennte Minecraft-Instanzen - Unterstützung für Vanilla, Fabric, Quilt, Forge und NeoForge -- Modrinth-Integration mit einfacher Mod-Installation inklusive Pflicht-Abhängigkeiten +- 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-Dialog für AeroMC-ZIP, Modrinth-Modpacks, den Minecraft Launcher, CurseForge sowie MultiMC- und Prism-Instanzen -- Reimport überschreibt vorhandene Instanzen mit gleichem Namen statt Dubletten anzulegen -- Export, Kopieren, Gruppieren und Verwalten von Instanzen -- Mehrfachauswahl mit Strg-Klick für Sammellöschen mehrerer Instanzen -- Globales Backup und Wiederherstellung für alle Instanzen direkt im Einstellungsbereich -- Verwaltung von Welten, Screenshots und Spielordnern direkt aus dem Launcher -- Bedrock-Bereich für Start und Verwaltung vorhandener Bedrock-Daten unter Windows +- 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 und sorgt im Alltag für den schnelleren Start -- AeroMC-Portable.exe startet ohne Installation direkt als portable Variante +- **AeroMC-Setup.exe** – installiert den Launcher, schneller Start im Alltag +- **AeroMC-Portable.exe** – startet ohne Installation, ideal zum Mitnehmen (etwas längerer Start) -Für die meisten Nutzer ist die Setup-Version die bessere Wahl. - -Die portable Datei ist praktisch zum Mitnehmen, braucht beim Öffnen aber in der Regel etwas länger. - -Automatische Updates bleiben dabei sauber getrennt: Die Setup-Version erhält nur Setup-Updates, die portable Variante nur Portable-Updates. Ein Wechsel zwischen beiden Varianten passiert nicht automatisch. +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 -- Eine legale Minecraft Java Edition mit Microsoft-Konto für Java-Start und Anmeldung -- Internetverbindung beim ersten Download von Minecraft-Dateien, Loadern oder Mods -- Für Bedrock-Funktionen: installierte Minecraft Bedrock Edition aus dem Microsoft Store +- 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. +2. Über **Konten** ein Microsoft-Konto hinzufügen. 3. Eine neue Instanz anlegen. -4. Minecraft-Version und bei Bedarf einen Loader auswählen. -5. Optional Mods hinzufügen oder vorhandene Instanzen bzw. Modpacks über Importieren übernehmen. -6. Instanz starten. +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 in der oberen Leiste können mehrere Quellen übernommen werden: +Über **Importieren**: -- AeroMC-ZIP-Archive mit instance.json -- Modrinth-Modpacks im .mrpack-Format -- Profile aus dem offiziellen Minecraft Launcher, typischerweise aus C:\Users\DeinName\AppData\Roaming\.minecraft -- CurseForge-Instanzen, typischerweise aus C:\Users\DeinName\curseforge\minecraft\Instances -- MultiMC- und Prism-Instanzen +| 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 | -Wenn bereits eine Instanz mit demselben Namen existiert, wird sie beim Import ersetzt statt zusätzlich angelegt. +Existiert bereits eine Instanz mit demselben Namen, wird sie ersetzt. -Beim Import aus dem offiziellen Minecraft Launcher werden nur echte benutzerdefinierte Profile angezeigt. Standardprofile wie Latest Release oder Latest Snapshot werden ausgeblendet. Nutzt ein Profil den gemeinsamen Standard-Spielordner, übernimmt AeroMC daraus nur spielrelevante Daten wie Mods, Welten und Konfiguration statt den kompletten Launcher-Cache zu kopieren. +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 -Im Bereich Einstellungen > Backup können komplette Sicherungen aller Instanzen erstellt und wieder eingespielt werden. +Unter **Optionen → Backup**: -- Backups werden automatisch unter Dokumente\AeroMC Launcher\Backups gespeichert -- Gesichert werden alle Instanzen sowie die Launcher-Einstellungen -- Microsoft-Konten und Tokens werden bewusst nicht mitgesichert -- Vorhandene Backups werden im Wiederherstellen-Bereich direkt in einem Dropdown aufgelistet +- 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 -Wichtig: Beim Wiederherstellen werden alle aktuell vorhandenen Instanzen mit dem Inhalt des gewählten Backups überschrieben. Die Launcher-Einstellungen werden ebenfalls aus dem Backup übernommen. +Speicherort: `Dokumente\AeroMC Launcher\Backups`. -## Was AeroMC verwaltet +**Wichtig:** Konten und Tokens werden nicht mitgesichert. Beim Wiederherstellen werden aktuelle Instanzen und Launcher-Einstellungen durch den Backup-Inhalt ersetzt. -- Minecraft-Versionen und gemeinsame Spieldateien -- Instanzbezogene Mods und Konfigurationen -- Welten und Screenshots -- Mehrere Microsoft-Konten -- Java-Auswahl pro Instanz +## Einstellungen -Bei der Instanzliste unterstützt AeroMC außerdem Strg-Klick für Mehrfachauswahl und Sammellöschen. +### Allgemein +- Design (Dunkel / Hell) +- Instanzen sortieren (nach letztem Start / nach Name) +- Instanz-Verzeichnis +- Bedrock-Bereich anzeigen -Alle Nutzerdaten werden lokal unter %APPDATA%\aeromc gespeichert. +### 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 ist für bereits installierte Bedrock-Versionen unter Windows gedacht. AeroMC kann Bedrock nicht selbst installieren, aber vorhandene Welten, Pakete, Add-ons und Ordner leichter zugänglich machen. +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 @@ -109,9 +190,9 @@ Der Bedrock-Bereich ist für bereits installierte Bedrock-Versionen unter Window ## Rechtliches -AeroMC ist kein offizielles Produkt von Mojang oder Microsoft. +AeroMC ist kein offizielles Produkt von Mojang oder Microsoft. Minecraft ist eine Marke von Mojang AB. ## Lizenz -MIT +MIT \ No newline at end of file