99 lines
4.9 KiB
Markdown
99 lines
4.9 KiB
Markdown
<div align="center">
|
||
|
||
<img src="src/assets/logo.png" alt="AeroMC Logo" width="140" />
|
||
|
||
# AeroMC
|
||
|
||
**Ein instanz-basierter Minecraft-Launcher für Windows – à la MultiMC / Prism.**
|
||
|
||
Verwalte beliebig viele isolierte Minecraft-Instanzen mit eigener Version, eigenen Mods und eigenem Java – lade Mods per Ein-Klick von Modrinth, melde dich mit deinem Microsoft-Konto an und spiele.
|
||
|
||
|
||
|
||
|
||
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## ✨ Features
|
||
|
||
| Bereich | Funktion | Status |
|
||
|---|---|---|
|
||
| **Instanzen** | Anlegen, Bearbeiten, Duplizieren, Löschen – jede Instanz ein isolierter Ordner | ✅ |
|
||
| **Instanzen** | Eigenes Icon (Emoji-Set **oder** eigenes Bild) | ✅ |
|
||
| **Versionen** | Minecraft-Version aus dem offiziellen Mojang-Manifest wählen (Release/Snapshot) | ✅ |
|
||
| **Java** | Automatische Erkennung installierter Java-Versionen (Adoptium, Oracle, Zulu, Corretto, Microsoft …) | ✅ |
|
||
| **Java** | Passende Java-Version wird automatisch pro Minecraft-Version gewählt | ✅ |
|
||
| **Mods** | Modrinth-Browser mit **Ein-Klick-Installation** in die Instanz | ✅ |
|
||
| **Login** | Offizieller Microsoft-Login (Device-Code-Flow) mit **Mehrkonten-Verwaltung** | ✅ |
|
||
| **Start** | Vanilla-Download (Client, Libraries, Natives, Assets) & Start | ✅ |
|
||
| **Loader** | **Fabric, Quilt, Forge & NeoForge** installieren & starten | ✅ |
|
||
| **Mods** | Katalog mit Kategorien/Sortierung + automatische Abhängigkeiten | ✅ |
|
||
| **Modpacks** | Import von Modrinth-Modpacks (.mrpack) | ✅ |
|
||
| **Instanzen** | Gruppen, Drag & Drop, Import/Export, Screenshots, Welten | ✅ |
|
||
| **Launcher** | Dark/Light-Theme, Konsole mit Log-Highlighting, Spielzeit-Statistik | ✅ |
|
||
|
||
---
|
||
|
||
## 🎮 Bedienung
|
||
|
||
1. **＋ Neue Instanz** → Name, Minecraft-Version und optional einen Mod-Loader (Fabric/Quilt) wählen.
|
||
2. Instanz anklicken → rechts erscheinen alle Aktionen (Starten, Bearbeiten, Mods, Welten …). Doppelklick startet direkt.
|
||
3. **Mods anzeigen** → Katalog mit beliebten Mods; ein Klick installiert die Mod inklusive aller Abhängigkeiten.
|
||
4. **Konten** (oben rechts) → Microsoft-Konto hinzufügen (mehrere möglich, aktives Konto spielt).
|
||
5. **Starten** → Der Launcher lädt alles Nötige und startet Minecraft mit deinem Konto.
|
||
|
||
> 💡 **Parallel spielen:** Konto A aktivieren → starten → Konto B aktivieren → starten. Jeder Start ist ein eigener Prozess, so laufen mehrere Clients mit verschiedenen Accounts gleichzeitig.
|
||
|
||
---
|
||
|
||
## 🔐 Microsoft-Login einrichten
|
||
|
||
Der Launcher bringt bereits eine **eingebaute Azure-App-ID** mit – Endnutzer müssen nichts eintragen und melden sich einfach mit ihrem eigenen Microsoft-Konto an.
|
||
|
||
> ⚠️ **Wichtiger Hinweis zur Freischaltung:** Seit 2024 müssen **neu registrierte** Azure-Apps von Microsoft/Mojang freigeschaltet werden, bevor sie sich bei den Minecraft-Diensten anmelden dürfen. Bis zur Freigabe endet der Login mit `Invalid app registration (403)`. Die Freischaltung wird über das offizielle Formular **[aka.ms/mce-reviewappid](https://aka.ms/mce-reviewappid)** beantragt. Der Launcher-Code ist vollständig – sobald die App-ID freigeschaltet ist, funktioniert der Login ohne weitere Änderungen.
|
||
|
||
**Eigene Azure-App verwenden (optional):** In den Optionen lässt sich eine eigene Client-ID hinterlegen. Anforderungen:
|
||
- Kontotyp: **Nur persönliche Microsoft-Konten**
|
||
- Authentifizierung → **„Öffentliche Clientflows zulassen" = Ja**
|
||
- Freischaltung über [aka.ms/mce-reviewappid](https://aka.ms/mce-reviewappid)
|
||
|
||
Der Login nutzt ausschließlich den offiziellen Microsoft-OAuth-Flow (echtes Konto, Spielbesitz vorausgesetzt). Ein Offline-/„Cracked"-Login wird **bewusst nicht** angeboten.
|
||
|
||
---
|
||
|
||
## 🗂️ Datenspeicherorte
|
||
|
||
Alle Nutzerdaten liegen unter `%APPDATA%\AeroMC\` (im Dev-Modus `%APPDATA%\aeromc\`):
|
||
|
||
| Pfad | Inhalt |
|
||
|---|---|
|
||
| `instances/<id>/instance.json` | Metadaten der Instanz |
|
||
| `instances/<id>/mods.json` | installierte Mods |
|
||
| `instances/<id>/minecraft/` | Spielverzeichnis (Saves, Configs, `mods/`) |
|
||
| `settings.json` | globale Einstellungen |
|
||
| `accounts.json` | angemeldete Microsoft-Konten (Tokens lokal) |
|
||
| `shared/{versions,libraries,assets}` | von allen Instanzen geteilte Spieldateien |
|
||
| `mc-versions.json` | zwischengespeicherte Mojang-Versionsliste |
|
||
|
||
---
|
||
|
||
## 🗺️ Roadmap
|
||
|
||
- [ ] Shader- und Ressourcenpakete über den Katalog
|
||
- [ ] CurseForge-Modpacks (braucht API-Key)
|
||
- [ ] Automatische Mod-Updates
|
||
|
||
---
|
||
|
||
## ⚖️ Rechtliches
|
||
|
||
Dieses Projekt steht in **keiner** Verbindung zu Mojang, Microsoft oder Xbox und ist kein offizielles Produkt.
|
||
„Minecraft" ist eine Marke von Mojang AB. Für die Nutzung ist ein **rechtmäßig erworbenes** Minecraft (Java Edition) sowie ein gültiges Microsoft-Konto erforderlich.
|
||
|
||
## 📄 Lizenz
|
||
|
||
MIT
|