diff --git a/README.md b/README.md index fdfc1b6..9ec60cf 100644 --- a/README.md +++ b/README.md @@ -4,9 +4,11 @@ # AeroMC -Ein Minecraft-Launcher für Windows mit getrennten Instanzen, Mod-Unterstützung und Microsoft-Anmeldung. +Ein Minecraft-Launcher für Windows mit getrennten Instanzen, Mod-Unterstützung, Spielaufzeichnung, Freundesystem und Microsoft-Anmeldung. -Aktueller Stand: Version 1.0.9 +Aktueller Stand: Version 1.1.4 + +AeroMC – Instanzliste mit Seitenleiste und Skin-Vorschau @@ -14,39 +16,60 @@ Aktueller Stand: Version 1.0.9 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. +Der Launcher konzentriert sich auf den Alltag: Instanz anlegen, Konto auswählen, Mods installieren, starten – und alles, was drumherum gebraucht wird, vom Aufnehmen bis zum Zusammenspielen mit Freunden. ## Funktionen +**Instanzen** - Beliebig viele getrennte Minecraft-Instanzen -- Unterstützung für Vanilla, Fabric, Quilt, Forge und NeoForge +- Unterstützung für Vanilla, Fabric, Quilt, Forge, NeoForge und OptiFine - Versionsliste mit Filter: Releases, Snapshots oder alle -- Modrinth- **und CurseForge**-Integration für **Mods, Ressourcenpakete und Shader** (Suche wahlweise über beide Quellen, Installation inkl. rekursiver Pflicht-Abhängigkeiten, Update-Prüfung samt Sammel-Update) -- Modpacks direkt von Modrinth **oder von der Technic-Plattform** durchsuchen und mit einem Klick als neue Instanz installieren – ohne vorherigen manuellen Download -- Microsoft-Login mit mehreren Konten -- Gemeinsamer Import für AeroMC-ZIP, Modrinth-Modpacks (`.mrpack`), Minecraft Launcher, CurseForge, MultiMC/Prism sowie Technic -- Reimport überschreibt vorhandene Instanzen mit gleichem Namen +- Performance-Paket beim Anlegen: Sodium, Lithium, FerriteCore, ImmediatelyFast, Entity Culling und ModernFix per Häkchen - Export, Kopieren, Gruppieren, Löschen und Desktop-Verknüpfung pro Instanz -- Mehrfachauswahl mit Strg-Klick für Sammellöschen, Tastenkürzel für die wichtigsten Aktionen (Strg+F, Strg+N, Entf) -- Mods/Modpacks/Instanzen auch per Drag & Drop aufs Fenster ziehen -- Mods zusätzlich als eigene Datei hinzufügen, wenn sie nicht über Modrinth/CurseForge zu finden sind -- Warnt beim Entfernen eines Mods, falls ein anderer installierter Mod ihn noch als Pflicht-Abhängigkeit braucht -- Globales Backup inkl. automatischer Zeitplan-Sicherungen, dazu Schnellsicherung einzelner Welten +- Eigene Icons pro Instanz – vorgefertigte Symbole, aus Minecraft extrahierte Block-/Item-Icons oder ein eigenes Bild – plus Notizen +- Mehrfachauswahl mit Strg-Klick, Tastenkürzel für die wichtigsten Aktionen +- Spielzeit-Statistik: Gesamtspielzeit, Spielstarts und Spielzeit pro Instanz + +**Mods, Modpacks und Inhalte** +- Modrinth- **und CurseForge**-Integration für Mods, Ressourcenpakete, Shader und Datenpakete (Installation inkl. rekursiver Pflicht-Abhängigkeiten) +- Update-Prüfung samt Sammel-Update, auf Wunsch automatisch vor jedem Spielstart +- Modpacks direkt von Modrinth, CurseForge oder der Technic-Plattform mit einem Klick installieren +- Mods als eigene Datei hinzufügen oder per Drag & Drop aufs Fenster ziehen +- Warnung beim Entfernen eines Mods, der noch als Pflicht-Abhängigkeit gebraucht wird + +**Import** +- Gemeinsamer Import für AeroMC-ZIP, Modrinth-Modpacks (`.mrpack`), Minecraft Launcher, CurseForge, MultiMC/Prism sowie Technic +- Schon bei der Installation: der Installer erkennt andere Launcher und AeroMC bietet deren Instanzen beim ersten Start zum Übernehmen an + +**Spielaufzeichnung** +- Nimmt nur das Minecraft-Fenster auf – ohne Desktop-Ränder und ohne Mauszeiger – und speichert als MP4 +- Auflösung, Qualität und Bildrate einstellbar, mehrere Tonspuren (Systemton, nur Minecraft, Mikrofone) mit eigener Lautstärke +- Clip-Modus: läuft im Hintergrund mit, **Alt+F10** speichert die letzten 30, 60 oder 90 Sekunden +- Servername im Aufnahmetitel, Aufzeichnungen-Galerie mit Vorschaubildern + +**Freunde** +- Freunde per Minecraft-Name hinzufügen, mit 3D-Spielerkopf, Online-Status und Spitznamen +- Meldung im Spiel, sobald ein Freund online kommt – bei mehreren Konten im jeweils richtigen Fenster +- **Beitreten**: startet eine passende Instanz und verbindet direkt mit dem Server eines Freundes +- **Einladen**: schickt Freunden deinen aktuellen Server – als Hinweis im Launcher und als Meldung im Spiel +- Eigener Server auf Wunsch verborgen, Freundesystem komplett abschaltbar + +**Konten, Welten und Backups** +- Microsoft-Login mit mehreren Konten +- Eigenen Skin im Launcher hochladen, mit Live-Vorschau anpassen (klassisch/schlank) und zurücksetzen +- Skin-Hintergrund des aktiven Kontos (mehrere Posen, einstellbare Deckkraft, optional wechselnd) - Welten, Ressourcenpakete, Datenpakete, Screenshots, Serverliste und Logdateien verwalten -- Serverliste mit Live-Status (Spieleranzahl, MOTD, Version), Übernahme einzelner Einträge in andere Instanzen sowie Desktop-Verknüpfung pro Server (startet die Instanz und verbindet direkt, ab MC 1.20) -- Online- und Offline-Start -- Eingebaute Konsole/Log-Ansicht inkl. Absturzberichte pro Instanz -- Windows-Benachrichtigung, wenn ein großer Download oder ein Backup im Hintergrund fertig wird -- Eigenen Minecraft-Skin direkt im Launcher hochladen, mit Live-Vorschau anpassen (klassisch/schlank) und zurücksetzen -- Skin-Hintergrund des aktiven Kontos (mehrere Posen, einstellbare Deckkraft) – wechselt bei mehreren angemeldeten Konten optional automatisch durch -- Eigene Icons pro Instanz – vorgefertigte Symbole, direkt aus Minecraft extrahierte Block-/Item-Icons oder ein eigenes Bild – plus Notizen +- Serverliste mit Live-Status und Desktop-Verknüpfung pro Server (startet die Instanz und verbindet direkt) +- Globales Backup inkl. automatischer Zeitplan-Sicherungen, dazu Schnellsicherung einzelner Welten + +**Technik und Komfort** - Java pro Instanz oder global, inkl. automatischem Download fehlender Versionen (Eclipse Temurin) -- RAM-, JVM-, Pre-Launch- und Post-Exit-Einstellungen (global und pro Instanz), inkl. Ein-Klick-Knopf für empfohlene GC-Flags -- Optionaler Wrapper-Befehl und HTTP-Proxy für Downloads -- Bedrock-Bereich für vorhandene Bedrock-Installation unter Windows, inkl. Installation zusätzlicher Add-ons -- Update-Suche läuft automatisch beim Start, dazu manuelle Prüfung in den Einstellungen -- Optionaler Autostart mit Windows, dann im Infobereich statt als Fenster -- Design Hell/Dunkel und Sortierung der Instanzen +- RAM-, JVM-, Pre-Launch- und Post-Exit-Einstellungen (global und pro Instanz), Ein-Klick-Knopf für empfohlene GC-Flags +- Eingebaute Konsole/Log-Ansicht inkl. Absturzberichte pro Instanz +- Bedrock-Bereich für eine vorhandene Bedrock-Installation, inkl. Add-on-Installation +- Update-Suche sofort beim Start, Updates installieren sich ohne Rückfragen +- Optionaler Autostart mit Windows (im Infobereich statt als Fenster) +- Design Hell/Dunkel, optionaler HTTP-Proxy und Wrapper-Befehl ## Installation @@ -55,11 +78,15 @@ 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) +Der Installer führt Schritt für Schritt durch Willkommen, Lizenz, Optionen (Ordner, Desktop-Verknüpfung) und – falls andere Launcher gefunden werden – einen optionalen Import. Administratorrechte sind nicht nötig, installiert wird nur für das eigene Benutzerkonto. Eine bereits vorhandene Installation wird automatisch übernommen; Instanzen, Welten und Einstellungen bleiben erhalten. + +Deinstallieren über **Windows-Einstellungen → Apps → AeroMC**. Instanzen und Welten bleiben dabei standardmäßig erhalten und lassen sich auf Wunsch mit entfernen (Papierkorb). + 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 +- Windows 10 oder 11 (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 @@ -68,10 +95,9 @@ Automatische Updates bleiben getrennt: Setup erhält nur Setup-Updates, Portable 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). +3. Eine neue Instanz anlegen, Minecraft-Version und optional einen Loader wählen – bei Fabric, Quilt oder NeoForge auf Wunsch gleich mit Performance-Paket. +4. Optional Mods/Ressourcenpakete/Shader hinzufügen oder bestehende Setups über **Importieren** übernehmen. +5. Instanz starten (online oder offline). ## Instanzen @@ -80,15 +106,16 @@ Jede Instanz hat: - Namen und optionale Gruppe - Minecraft-Version und optionalen Mod-Loader - optionales Icon (vorgegeben, aus Minecraft extrahiert oder eigenes Bild) und Notizen -- eigene Mods, Ressourcenpakete, Shader, Welten, Datenpakete, Screenshots und Serverliste -- eigene Java-, RAM-, JVM-, Pre-Launch- und Post-Exit-Einstellungen (leer = globale Vorgabe), inkl. Knopf für empfohlene GC-Flags bei den JVM-Argumenten +- eigene Mods, Ressourcenpakete, Shader, Welten, Datenpakete, Screenshots, Aufzeichnungen 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 (inkl. Schnellsicherung einzelner Welten), Datenpakete und Bildschirmfotos +- Welten (inkl. Schnellsicherung einzelner Welten), Datenpakete, Bildschirmfotos und Aufzeichnungen +- Spiel aufzeichnen - Server verwalten (Live-Status, Übernahme eines Eintrags in andere Instanzen, Desktop-Verknüpfung pro Server) - Logdateien und Absturzberichte ansehen - Minecraft-, Konfigurations- und Instanz-Ordner öffnen @@ -96,10 +123,12 @@ Jede Instanz hat: - Exportieren, Kopieren, Gruppe ändern, Löschen - Bei importierten Modpacks: Modpack aktualisieren -In der Instanzliste: Suche, Sortierung und **Strg + Klick** für Mehrfachauswahl. +In der Instanzliste: Suche, Sortierung und **Strg + Klick** für Mehrfachauswahl. Über **Statistik** in der oberen Leiste gibt es die Spielzeit aller Instanzen im Überblick. ### Tastenkürzel +Im Launcher: + | Taste | Wirkung | |---|---| | Strg+F | Suche fokussieren | @@ -109,6 +138,14 @@ In der Instanzliste: Suche, Sortierung und **Strg + Klick** für Mehrfachauswahl Greifen nicht, während ein Textfeld fokussiert ist oder ein Dialog mit eigener Suche offen ist. +Im Spiel (solange ein über AeroMC gestartetes Minecraft läuft): + +| Taste | Wirkung | +|---|---| +| Strg+Alt+F | Zeigt, welche Freunde gerade online sind | +| Strg+Alt+J | Kopiert die Server-Adresse der letzten Einladung | +| Alt+F10 | Speichert im Clip-Modus die letzten Sekunden (ersatzweise Strg+Alt+C) | + ## Import Über **Importieren**: @@ -116,7 +153,7 @@ Greifen nicht, während ein Textfeld fokussiert ist oder ein Dialog mit eigener | Quelle | Typische Nutzung | |---|---| | ZIP-Archiv | AeroMC-Export (`instance.json`) sowie einzelne MultiMC/Prism-Instanzen (auch gezippt) | -| Modpack | Modrinth-Katalog direkt durchsuchen und installieren, oder Datei importieren: `.mrpack` sowie CurseForge-ZIP (`manifest.json`) | +| Modpack | Modrinth- oder CurseForge-Katalog direkt durchsuchen und installieren, oder Datei importieren: `.mrpack` sowie CurseForge-ZIP (`manifest.json`) | | Minecraft Launcher | Profile aus dem offiziellen Launcher | | CurseForge | Instanzen aus dem CurseForge-Ordner | | MultiMC / Prism | Vorhandene MultiMC- oder Prism-Instanzen | @@ -126,9 +163,9 @@ 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. -Im Reiter **Modpack** desselben Dialogs lässt sich zusätzlich direkt im Modrinth-Katalog suchen und ein Modpack mit einem Klick installieren – ganz ohne vorherigen manuellen Download der `.mrpack`-Datei. Im Reiter **Technic** gibt es dasselbe für den Technic-Katalog. +**Schon bei der Installation:** Der Installer sucht nach Minecraft Launcher, CurseForge, MultiMC, Prism Launcher, PolyMC und Technic – ein portables MultiMC auch über seine Verknüpfung auf dem Desktop oder im Startmenü. Was dort angekreuzt wird, öffnet AeroMC beim ersten Start fertig durchsucht im Import; ausgewählt wird dann nur noch, was übernommen werden soll. In den anderen Launchern wird nichts verändert. -Alternativ: `.jar`-, `.mrpack`- oder `.zip`-Dateien direkt aufs Launcher-Fenster ziehen. AeroMC erkennt anhand des Inhalts, ob es sich um einen Mod (landet in der gerade offenen/ausgewählten Instanz), ein Modpack oder einen Instanz-Export handelt. +Alternativ: `.jar`-, `.mrpack`- oder `.zip`-Dateien direkt aufs Launcher-Fenster ziehen. AeroMC erkennt anhand des Inhalts, ob es sich um einen Mod (landet in der gerade ausgewählten Instanz), ein Modpack oder einen Instanz-Export handelt. ## Mods, Ressourcenpakete und Shader @@ -136,13 +173,43 @@ Im Inhalts-Dialog einer Instanz: - Katalog durchsuchen (Quelle Modrinth oder CurseForge, Sortierung, Kategorien) - Installation inkl. **automatischer** Installation aller Pflicht-Abhängigkeiten (rekursiv, auch quellübergreifend) -- Eigene Datei hinzufügen (`.jar`/`.zip`) – für Mods, die nicht über Modrinth/CurseForge zu finden sind, oder per Drag & Drop aufs Fenster ziehen -- Installierte Einträge aktivieren, deaktivieren, entfernen – beim Entfernen warnt AeroMC, falls ein anderer installierter Mod das noch als Pflicht-Abhängigkeit braucht +- Eigene Datei hinzufügen (`.jar`/`.zip`) – für Mods, die nicht über Modrinth/CurseForge zu finden sind, oder per Drag & Drop +- Installierte Einträge aktivieren, deaktivieren, entfernen – mit Warnung, falls ein anderer Mod sie noch braucht - 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. Für CurseForge-Inhalte wird ein eigener API-Key oder eine Weiterleitungs-Adresse benötigt (siehe **Einstellungen → Netzwerk**). +**Performance-Paket:** Beim Anlegen einer Fabric-, Quilt- oder NeoForge-Instanz installiert ein Häkchen Sodium, Lithium, FerriteCore, ImmediatelyFast, Entity Culling und ModernFix gleich mit. Was es für die gewählte Version noch nicht gibt, wird übersprungen. + +**Automatische Mod-Updates:** Unter **Optionen → Spiel → Mods** sucht AeroMC auf Wunsch vor jedem Start nach neueren Fassungen der Modrinth-Mods und installiert sie. Dauert die Suche länger als 20 Sekunden, startet Minecraft ohne Update. + +## Spielaufzeichnung + +Über **Spiel aufzeichnen** in der Seitenleiste: + +- Aufgenommen wird nur das Minecraft-Fenster – ohne Desktop-Ränder und ohne Mauszeiger +- Auflösung (Nativ, 1080p, 720p, 480p), Qualität (Niedrig/Mittel/Hoch) und Bildrate (30/60 fps) einstellbar +- Tonspuren: Systemton, nur Minecraft (isoliert) und beliebig viele Mikrofone, jede mit eigenem Lautstärkeregler – auch während der Aufnahme +- Der Server, auf dem gerade gespielt wird, erscheint automatisch im Titel +- Gespeichert wird als MP4 unter `Videos\AeroMC Launcher\`, zu finden auch unter **Bildschirmfotos verwalten → Aufzeichnungen** + +**Clip-Modus:** Läuft im Hintergrund mit, auch bei geschlossenem Aufzeichnungsfenster. **Alt+F10** (ist das belegt, z. B. durch ShadowPlay: Strg+Alt+C) speichert die letzten 30, 60 oder 90 Sekunden als `Clip_….mp4`, mit kurzer Meldung im Spiel. Endet Minecraft, endet auch der Clip-Modus. + +## Freunde + +Über **Freunde** in der oberen Leiste: + +- Freunde per Minecraft-Name hinzufügen, Anfragen annehmen, ablehnen oder zurückziehen – offene Anfragen zählt der Knopf mit +- Spitznamen vergeben, Online-Status und Server der Freunde sehen +- Meldung im Spiel mit 3D-Spielerkopf, sobald ein Freund online kommt +- **Beitreten** startet eine passende eigene Instanz (gleiche Minecraft-Version, bevorzugt mit dem Server in der Liste) und verbindet direkt; gibt es keine, wird eine Vanilla-Instanz angelegt +- **Einladen** schickt Freunden den eigenen aktuellen Server. Im Launcher erscheint die Einladung mit „Beitreten“, im Spiel als Meldung – dort kopiert **Strg+Alt+J** die Adresse für „Direkt verbinden“ + +Unter **Optionen → Allgemein → Freundesystem** lässt sich der eigene Server vor Freunden verbergen oder das Freundesystem ganz abschalten – dann ist man für niemanden sichtbar und kann nicht hinzugefügt werden. + +Das Freundesystem funktioniert nur zwischen Spielern, die AeroMC nutzen und mindestens einmal mit eingeschaltetem Freundesystem darüber gespielt haben. + ## Skin ändern Über **Konten → Skin ändern…** lässt sich der Skin des aktiven Microsoft-Kontos direkt im Launcher ändern: @@ -173,17 +240,19 @@ Speicherort: `Dokumente\AeroMC Launcher\Backups`. - Design (Dunkel / Hell) - Instanzen sortieren (nach letztem Start / nach Name) - Instanz-Verzeichnis -- Bedrock-Bereich anzeigen +- Bereiche: Bedrock-Bereich anzeigen - Windows-Benachrichtigung bei fertigem Hintergrund-Download/-Backup (nur wenn das Fenster nicht im Vordergrund ist) -- Autostart: mit Windows starten, im Infobereich statt als Fenster – solange aktiv, versteckt „Schließen" (X) den Launcher nur, statt ihn zu beenden (über das Symbol im Infobereich wieder öffnen oder wirklich beenden) +- Freundesystem ein-/ausschalten, eigenen Server für Freunde sichtbar oder verborgen +- Autostart: mit Windows starten, im Infobereich statt als Fenster – solange aktiv, versteckt „Schließen“ (X) den Launcher nur ### Darstellung - Block-Symbole räumlich (3D) -- Skin-Hintergrund: Quelle, Pose, Deckkraft, optional automatischer Wechsel zwischen mehreren angemeldeten Konten (mit einstellbarem Zeitabstand) +- Skin-Hintergrund: Quelle, Pose, Deckkraft, optional automatischer Wechsel zwischen mehreren Konten ### Spiel - Standard-RAM (min./max.) - Fenstergröße bzw. maximiert starten +- Mods: vor jedem Start automatisch nach Updates suchen und installieren ### Start & Java - Globale Java-Auswahl und Erkennung @@ -205,8 +274,8 @@ Ohne eigenen Key und ohne Weiterleitung funktionieren Modrinth-Inhalte weiterhin - Manuell, Zeitplan und Wiederherstellung ### Info -- Version, Autor und Links -- Update-Suche läuft automatisch kurz nach dem Start (Status erscheint grün, wenn alles aktuell ist) sowie jederzeit manuell per Knopf +- Version, Autor, Links und Lizenz +- Update-Suche läuft sofort beim Start, das Ergebnis steht direkt hier (grün, wenn alles aktuell ist); dazu jederzeit manuell per Knopf. Updates installieren sich ohne Rückfragen und starten AeroMC danach neu. ## Bedrock @@ -219,7 +288,9 @@ Der Bedrock-Bereich startet die vorhandene Windows-Store-Version und erleichtert ## Datenort -Nutzerdaten liegen lokal unter `%APPDATA%\aeromc`. +- Nutzerdaten (Instanzen, Konten-Verknüpfung, Einstellungen): `%APPDATA%\aeromc` +- Aufzeichnungen und Clips: `Videos\AeroMC Launcher` +- Backups: `Dokumente\AeroMC Launcher\Backups` ## Links diff --git a/docs/aeromc.png b/docs/aeromc.png new file mode 100644 index 0000000..c3733bf Binary files /dev/null and b/docs/aeromc.png differ