SCS-Profil-Klartext-Teilmenge

Zweck

Phase 2 kann lokale profile.sii-Dateien lesen, wenn sie als unterstützbarer UTF-8-Klartext vorliegen oder durch einen konfigurierten Decoder in diese Klartextform überführt werden.

Nativ nicht dekodiert werden aktuell:

• binäre Profildateien
• verschlüsselte Profildateien
• unbekannte oder nicht textbasierte Varianten

Diese Dateien werden ohne Decoder nicht geraten, sondern mit Diagnose gemeldet. Mit einem IScsProfileDecoder oder dem prozessbasierten ExternalScsProfileDecoderAdapter kann ein vom Benutzer bereitgestellter Dekodierpfad angebunden werden. Das Projekt liefert kein fremdes Dekodierwerkzeug mit.

Profilpfad

Der Katalog sucht unter einem Profilwurzelverzeichnis rekursiv nach:

profile.sii

Unterstützte Teilmenge

Der Reader erwartet eine SII-Klartextstruktur mit SiiNunit und liest:

SiiNunit
{
profile : _nameless.123 {
  profile_name: "Profilname"
  active_mods[0]: "connector"
  active_mods[1]: "map_expansion"
}
}

Ausgewertet werden:

• profile_name
• name als Fallback
• active_mods[]
• active_mods[index]

Unbekannte Felder werden ignoriert.

Modableitung

Aktive Modreferenzen aus active_mods werden als belegbare Modkennungen übernommen.

Da die Profildatei in dieser Teilmenge keine vollständigen Modmetadaten bereitstellt, werden Name und ID zunächst identisch gesetzt. ScsProfileModResolver kann diese Referenzen über lokale Modverzeichnisse oder ZIP-basierte .scs-Pakete mit manifest.sii auflösen.

Die Reihenfolge der active_mods wird als Profilreihenfolge übernommen. Indizierte Einträge werden nach Index sortiert.

ScsProfileCatalog kann optionale Modquellpfade erhalten. In diesem Fall gibt der Katalog bereits angereicherte Profile mit Modname, Version, Karten-Mod-Kennzeichnung, Paketpfad und Abhängigkeiten zurück.

Diagnosen

Der Reader meldet:

• SCS_PROFILE_EMPTY
• SCS_PROFILE_BINARY
• SCS_PROFILE_NOT_UTF8
• SCS_PROFILE_NOT_SII_TEXT
• SCS_PROFILE_UNSUPPORTED_STRUCTURE
• SCS_PROFILE_DECODED
• SCS_PROFILE_DECODER_OUTPUT_NOT_SII_TEXT
• SCS_PROFILE_MOD_PACKAGE_NOT_FOUND
• SCS_PROFILE_MOD_PACKAGE_UNREADABLE

Diese Diagnosen sind nicht-fatal für den Katalog: nicht lesbare Profile werden übersprungen.

Grenzen

Dies ist die vollständige Phase-2-Spezifikation der aktuell benötigten Profil- und Modmanager-Teilmenge. Sie ist keine vollständige globale SCS-SII-Spezifikation für alle Objektarten.