Vasilas: Feature-Anleitung (#245)

2026-10-21T05:09:08Z

Feature-Anleitung (#245)

Neue Seite

__TOC__
Die Seite '''Installation''' erklärt, wie ihr Schattenwelt mit dem '''Schattenwelt Launcher''' installiert und aktuell haltet. Der Launcher lädt den [[SW-Client]] und alle Spieldateien, hält sie aktuell und startet das Spiel. Ein vorher installiertes Ultima Online braucht ihr nicht.

''Stand der Werte: 21.10.2026. Einzelne Zahlen können vom Team noch angepasst werden.''

== Was ihr braucht ==

* Ein '''Spielaccount''' von der Website. Ihr legt ihn unter [https://schattenwelt.rip/register schattenwelt.rip/register] an (siehe [[Website und Discord]]).
* Den '''Launcher''' von der Download-Seite: [https://schattenwelt.rip/download schattenwelt.rip/download]

{| class="wikitable"
|-
! System
! Download
|-
| Windows (x64)
| Installationsprogramm (<code>.exe</code>)
|-
| macOS Intel (x64)
| Archiv (<code>.tar.gz</code>)
|-
| macOS Apple Silicon (arm64)
| Archiv (<code>.tar.gz</code>)
|-
| Linux (x64)
| Archiv (<code>.tar.gz</code>)
|}

== Installation unter Windows ==

# Ladet das Installationsprogramm herunter und startet es.
# Wählt den Ordner für den Launcher selbst.
# Auf der Seite '''Schattenwelt-Spieleordner''' wählt ihr, wohin die Spieldateien kommen (Vorschlag: <code>C:\Spiele\Schattenwelt</code>). Das Installationsprogramm trägt diesen Ordner als Ultima-Online-Verzeichnis in Windows ein, damit der Client ihn beim Start findet.
# Auf Wunsch legt es eine Desktop- und eine Startmenü-Verknüpfung an.

Legt den Launcher nicht in den Spieleordner. Dann räumt er den Ordner nicht auf (siehe unten).

== Installation unter macOS und Linux ==

Entpackt das Archiv und startet den Launcher daraus. Der Mac-Launcher ist signiert und wird von macOS nicht mehr als beschädigt abgelehnt. Im Launcher wählt ihr anschließend den Spieleordner.

== Der Launcher im Überblick ==

{| class="wikitable"
|-
! Feld oder Knopf
! Wirkung
|-
| ''Username'', ''Passwort'', ''Einloggen''
| Anmeldung mit eurem Website-Konto
|-
| ''Schattenwelt-Installationsordner'', ''Wählen''
| Spieleordner festlegen
|-
| ''Prüfen / Updaten''
| Alle Spieldateien prüfen und fehlende oder veraltete nachladen
|-
| ''Abbrechen''
| Laufenden Download abbrechen
|-
| ''Spiel starten''
| Dateien kurz prüfen, wenn nötig reparieren, dann den Client starten
|-
| ''Log öffnen''
| Ordner mit den Logdateien des Launchers öffnen
|}

=== Anmelden ===

Ihr meldet euch mit Accountname und Passwort eures Spielaccounts an. Danach zeigt der Launcher „Eingeloggt als …“ mit euren Rollen.

Der Launcher merkt sich die Anmeldung verschlüsselt auf eurem Rechner und loggt euch beim nächsten Start automatisch ein. Ist die gespeicherte Anmeldung abgelaufen oder ungültig, meldet er „Bitte erneut einloggen.“

Ein gesperrter Account kann sich nicht anmelden („Dieser Account ist gesperrt.“).

=== Spiel starten ===

''Spiel starten'' öffnet den Client mit eurem Account, eurem Passwort und den Serverdaten. Im Client müsst ihr nichts mehr eintippen.

Vor jedem Start prüft der Launcher die Client-Dateien und repariert sie bei Bedarf („Repariere … Datei(en) vor dem Start …“). Das schützt davor, dass andere Programme den Schattenwelt-Client unbemerkt überschreiben.

== Automatische Updates ==

Nach dem Login prüft der Launcher im Hintergrund, ob es neue Dateien gibt. ''Prüfen / Updaten'' vergleicht jede Datei mit der Liste des Servers und lädt nur, was fehlt oder sich geändert hat. Fortschrittsbalken und Statuszeile zeigen, welche Datei gerade lädt. Ab dem zweiten Durchlauf geht die Prüfung sehr schnell, weil der Launcher sich die Prüfsummen merkt.

Steht ein Download '''60 Sekunden''' still, bricht der Launcher ihn ab. Startet das Update dann einfach neu.

Lädt ein Server-Update eine Datei nicht vollständig, meldet der Launcher „Update unvollständig.“ und wie viele Dateien noch fehlen.

=== Eure Einstellungen bleiben ===

Die persönliche <code>settings.json</code> des Clients überschreibt der Launcher nie. Ist sie leer oder beschädigt, legt er sie als <code>.corrupt-</code>Datei mit Datum zur Seite und lädt eine frische.

== Spielordner aufräumen ==

Nach jeder erfolgreichen Prüfung, also nach ''Prüfen / Updaten'' und vor jedem Spielstart, entfernt der Launcher Dateien aus dem Spielordner, die nicht zum Spiel gehören, etwa alte Sicherungen und Absturzberichte. Die Statuszeile meldet, wie viele Dateien entfernt wurden.

'''Nie gelöscht''' werden:
* eure Profile, Makros und Client-Einstellungen (<code>Data/Profiles</code>, <code>settings.json</code>),
* Journale und Screenshots (<code>Data/Client</code>),
* eigene Plugins (<code>Data/Plugins</code>),
* die Charakter-Logs (<code>Logs</code>),
* <code>.cfg</code>- und <code>macros*.txt</code>-Dateien direkt im Spielordner.

Eigene Dateien an anderen Stellen des Spielordners entfernt der Launcher. Habt ihr dort bewusst eigene Werkzeuge liegen, legt in deren Ordner eine leere Datei namens <code>.schattenwelt-keep</code>. Dann überspringt der Launcher den Ordner samt Unterordnern.

Aufgeräumt wird nur, wenn der Client gerade nicht läuft und die Dateiliste vom Server vollständig ist. Welche Dateien entfernt wurden, steht in der <code>patch.log</code> mit „Gelöscht:“.

== Neue Launcher-Versionen ==

Beim Start prüft der Launcher, ob es eine neue Version von sich selbst gibt, und zeigt deren Hinweise an.
* Ein '''Pflichtupdate''' wird sofort installiert.
* Ein '''optionales Update''' fragt „Jetzt installieren?“.

Der Launcher lädt die neue Version, prüft sie, installiert sie und startet neu. Geht dabei etwas schief, bleibt die alte Version erhalten.

== Charakter-Logs ==

Der Launcher richtet bei jedem Start das Schattenwelt-Plugin für Charakter-Logs im Client ein. Es schreibt Chat- und Journaltexte für jeden Charakter in eine Datei pro Tag:

<code>Logs/Account/Charakter/Datum.log</code>

Grundlage ist die Client-Option ''Journal als Datei im Spielordner speichern'' (Seite ''Sprache''), die ab Werk an ist.

== Wo der Launcher seine Daten ablegt ==

{| class="wikitable"
|-
! System
! Ordner
|-
| Windows
| <code>%APPDATA%\SchattenweltLauncher</code>
|-
| macOS
| <code>~/Library/Application Support/SchattenweltLauncher</code>
|-
| Linux
| <code>~/.local/share/SchattenweltLauncher</code>
|}

Dort liegen die Einstellungen und die beiden Logdateien <code>launcher.log</code> (Ablauf, Launcher-Updates, Ausgaben eines abgestürzten Clients) und <code>patch.log</code> (geladene und gelöschte Dateien). ''Log öffnen'' bringt euch direkt hin. Bei Problemen hilft dem Team ein Blick in diese Dateien.

[[Kategorie:Spielmechaniken]]
[[Kategorie:Einstieg]]

Installation - Versionsgeschichte

Vasilas: Feature-Anleitung (#245)