# NYCE Minecraft Patcher 1.1.2

Windows 10/11, .NET Framework 4.8. Portable, ohne Installation oder Adminrechte.
Minecraft 26.2 / Fabric 0.20.1 / Java 25 muss im Launcher eingerichtet sein.

## Benutzung

1. Patcher öffnen. Er prüft zuerst seine eigene Version und danach den Modsatz.
2. Unter Einstellungen den tatsächlichen Spielordner der Instanz auswählen.
   Bei Prism kann auch der Instanzordner gewählt werden. Die Auswahl wird sofort
   gespeichert und beim nächsten Start wieder angezeigt.
3. Die Startaktion einmal einrichten. „Spielen“ aktualisiert das Paket und
   führt danach die gespeicherte Startaktion aus. „Aktualisieren“ installiert
   ausschließlich Dateien; diese Funktion steht unter „Mods & Updates“ als
   „Nur Mods aktualisieren“. Unten stehen nur „Spielen“ und die Statusanzeige.
   Minecraft muss für Änderungen geschlossen sein.

Ordnerauswahl: %LOCALAPPDATA%/NYCE-Minecraft/folder.txt.
Startaktionen werden dort getrennt je normalisierter Instanz gespeichert.

Prism: richtige Instanz und direkter Beitritt zu mc.nyce-network.com über die
offizielle CLI. Bei angepassten Instanzverzeichnissen eine Instanz-Verknüpfung
hinterlegen. Für TLauncher, Lunar und andere Launcher eine vorhandene Instanz-
Verknüpfung, EXE oder JAR auswählen. Ohne passende Startschnittstelle muss man
Profil/Server im Launcher bzw. Spiel auswählen; kein universeller Direktbeitritt.
Optionale dokumentierte EXE-Parameter können {instance} und {server} als zitierte
Argumente einsetzen. Keine Konten, Tokens oder Passwörter hinterlegen.
Der Patcher ändert weder die unterstützten Spielversionen eines Launchers noch
dessen Profil-, Konto- oder Fabric-Einstellungen.

## Zusatzmods und automatische Konfliktreparatur

Unabhängige Zusatzmods bleiben erhalten. Automatische Reparatur ist ausdrücklich
autorisiert für Konflikte mit dem freigegebenen Paket: andere Versionen derselben
Fabric-ID, abweichende Dateien auf benötigten Paket-Pfaden und veraltete verwaltete
Paket-Dateien werden gesichert und ersetzt bzw. aus dem aktiven Modordner entfernt.
Vorhandene Dateien des offiziellen Pakets werden anschließend verwaltet.
Kein Leeren des Modordners, keine Löschung nach breiten Dateinamensmustern.
Beliebige Inkompatibilitäten zwischen Zusatzmods werden nicht diagnostiziert.

Quelle: https://nyce-network.com/minecraft-files/manifest.json. Nur Client-JARs
und die freigegebene StackPlus-Konfiguration; keine Server-Mods oder Datapacks,
keine neuen Upstream-Versionen. Kein Hintergrunddienst, Zeitplan oder Telemetrie.
Bei server_ready=false sind neue Dateien vor dem Serverneustart bereitgestellt:
Prüfen/Installieren und Spielstart sind möglich. Prism startet dabei ins
Hauptmenü, ohne automatischen Serverbeitritt. Andere Startaktionen bleiben
unverändert; deren Serverbeitritt ist von ihren Einstellungen abhängig.
Der Patcher führt keinen Serverneustart aus.

## Sicherung und Wiederherstellung

Alle Downloads werden vor Änderungen per SHA-256 geprüft. Betroffene Originale
werden kopiert und ihre Sicherung erneut per Hash geprüft. Sicherungen bleiben
im Spielordner unter .nyce-updater/backups/. Normale Fehler rollen die gesamte
Änderung zurück. Spielstände werden nicht angefasst.

Bei Rechnerabsturz/Stromausfall verhindert .nyce-updater/recovery.json weitere
Änderungen. Minecraft dann nicht starten: `backup` nennt den Sicherungsordner.
Für jeden `files`-Eintrag mit Wert true die Datei aus original/<relativer Pfad>
zurückkopieren, bei false die neu angelegte Datei entfernen. previous-state.json
nach .nyce-updater/state.json zurückkopieren oder state.json entfernen, falls es
vorher keinen Stand gab. Erst danach recovery.json entfernen.

## Selbstaktualisierung

Feed: https://nyce-network.com/downloads/minecraft/patcher.json. Nur höhere
Versionsnummern, die festgelegte HTTPS-Adresse, passende Dateigröße und SHA-256
werden akzeptiert. Ein separater Helfer wartet auf das Ende des alten Patchers,
ersetzt die EXE atomar und startet sie neu. Die vorherige EXE bleibt als
<Dateiname>.nyce-backup erhalten. Einstellungen bleiben in LOCALAPPDATA.
Fehlerprotokoll: dort self-update-error.txt. Der EXE-Ordner muss beschreibbar sein;
es wird keine Rechteerhöhung angefordert. Die EXE ist nicht codesigniert.
Versionen 1.0.x benötigen einmalig den manuellen Download von 1.1.0 oder neuer.

## Entwicklung

build.ps1: WPF-Oberfläche + bestehende Mod-Engine + NYCE-ICO/Ressourcen.
test.ps1: isolierte Konflikt-, Rollback-, Pfad-, Startaktions- und Feed-Tests.
SelfUpdateTests.cs: echte Testprozesse für Warten, atomaren Austausch, Backup und
Neustart. LiveTest.cs: separater Testordner für die echte Downloadquelle.
Keine Testprogramme, Fixtures, Einstellungen oder Sicherungen veröffentlichen.
Beim Release Versionskonstante, Assembly-Versionen, Build-Ziel und
network-site/build.py gemeinsam ändern; patcher.json wird mit Hash/Größe gebaut.

CLI-Referenz: https://prismlauncher.org/wiki/getting-started/command-line-interface/
Lunar-Modordner: https://www.lunarclient.com/news/how-to-add-your-own-mods-to-lunar-client