De/Source 2/Docs/Level Design/Import Tool Documentation

= Import Tool Documentation =
Als Teil der Workshop Tools von Counter-Strike 2, bieten wir ein Python-Skript an, das es Inhaltserstellern ermöglicht, ihre Karten und Assets zu Source 2 zu portieren. Bevor es losgeht, müssen jedoch ein paar Vorbereitungen durchgeführt werden. 
=== Vorbereitungen ===
==== Vorkompilierte Inhalte ====
Vorkompilierte Inhalte (wie benutzerdefinierte vmt, vtf, mdl, etc.) müssen sich im Ordner befinden. Zum Beispiel:
* 
* 
==== Source Kartendateien ====
Ihre Kartendateien (.vmf) können sich überall außerhalb von befinden, solange sie in einem -Ordner sind. Jegliche Prefab- oder Instance-VMFs, auf die Ihre Karte verweist, müssen sich in einer von der Karte erwarteten Unterordnerstruktur befinden. Zum Beispiel:
* 
* 
* 
==== Source Textur-Dateien ====
Falls Sie unkomprimierte Quelldateien für Texturen (tga, psd, etc.) haben, wird das Import-Tool versuchen, diese zu beim Importieren von Materialien zu verwenden. Andernfalls werden die VTF-Dateien konvertiert und neu komprimiert (was die Qualität beeinträchtigen kann). Damit dies klappt, stellen Sie bitte sicher, dass sich Ihre Quelldateien im gleichen Ordner wie die VTF-Dateien und im Ordner befinden. Zum Beispiel: 
* 
* 
== Vorbereitungen ==
=== 1. Python 2.7.14 installieren ===
Sie müssen 2.7.14 installieren, um das Import-Skript auszuführen. Link zum Herunterladen: https://www.python.org/downloads/release/python-2714
=== 2. Umgebungsvariablen setzen ===
Als nächsten müssen Sie zwei Umgebungspfadvariablen setzen, sodass Windows weiß, wo sich Ihre -Installation und andere importierte Bibliotheken im Ordner befinden:
Drücken Sie , um das Power User Task Menü zu öffnen.
* Wählen Sie „System“ im Power User Task Menü.
* Scrollen Sie im System-Fenster bis zum Ende und wählen „Systeminfo“.
* Im Fenster „System“, klicken Sie auf „Erweiterte Systemeinstellungen“ weiter unten.
* Im Systemeeigenschaftsfenster, wählen Sie den Reiter „Eweitert“ und dann „Umgebungsvariablen“ nahe dem Ende des Fensters.
* Wählen Sie schließlich im Fenster „Umgebungsvariablen“ (siehe Bild weiter unten) die Variable „Path“ im Abschnitt „Systemvariablen“ und klicken auf Neu….
* Fügen Sie eine Umgebungsvariable mit dem Installationspfad von und dem Pfad des Ordners hinzu. Bitte achten Sie darauf, dass Sie die Pfade mit einem Semikolon trennen. 
Zum Beispiel: ; 
* Wiederholen Sie diesen Schritt für den Abschnitt „Benutzervariablen“.
=== 3. Die Colorama-Erweiterung installieren ===
Als nächstes benötigen Sie eine -Erweiterung namens colorama. Um diese zu installieren, öffnen Sie die Eingabeaufforderung (mit der Suche nach „cmd“ im Windows Start Menü) und geben folgendes ein:
=== 4. Ein neues Addon mit den Workshop-Tools erstellen ===
Bevor Sie mit dem Import beginnen, müssen Sie ein Workshop-Tools-Addon erstellen, damit der importierte Inhalt einen gültigen Ort (Pfad) hat. Um ein neues Addon zu erstellen, öffnen Sie das Spiel mit den Workshop-Tools und klicken auf „Create New Addon“. 
Merken Sie sich den Namen des Addons für später.
=== 5. Das Import-Skript finden ===
Als erstes sollten Sie das -Import-Skript suchen, welches sich in folgendem Ordner befindet:
Sobald Sie den Ordner gefunden haben, öffnen Sie dort eine Eingabeaufforderung. Geben Sie dazu einfach „cmd“ in die Andressleiste des Windows Explorers ein und drücken die Eingabetaste: 
=== 6. Skript + Parameter ausführen ===
Nun können Sie das Skript nach folgendem Befehlsgerüst ausführen:
==== Skript Befehlszeilenparameter ====
: <s1gameinfopath> Pfad zum Ordner mit der Datei gameinfo.txt von CS:GO. Dies MUSS dem Pfad entsprechen, in dem sich die kompilierten Modelle und Materialien für CS:GO befinden, die Sie importieren möchten (z. B. .mdl oder .vmt).
 
: <s1contentpath>
: Pfad zum Ordner mit Quellinhalt (.vmf, .psd, .tga, etc.). Damit der der Import erfolgreich funktioniert und die Quelltexturdateien verwendet werden können, stellen Sie bitte sicher, dass die Dateien sich am gleichen Ort (Pfad) wie die VTF-Dateien befinden (siehe Beispiele oben). 
: <s2gameinfopath>
: Pfad zum Ordner mit der Datei gameinfo.gi von .
: <s2addon>
: Der Name des -Workshop-Addons, welches Sie vorhin in Schritt 4 erstellt haben. Dorthin werden Ihre Assets importiert.
: <mapname>
: Der Kartenname (.vmf) ohne Dateinamenerweiterung, z. B. de_examplemap. Falls sich Ihre Karte in einem Unterordner des Ordners, den Sie bei angegeben haben befindet, hängen Sie diesen Pfad bitte an den Kartennamen an. Zum Beispiel: .
: -usebsp
: This runs the map through a special vbsp process to generate clean map geometry from brushes, removing hidden faces and stitching up edges, making the version easier to work with in . It preserves world (vis) brushes and brushes for compatibility with . This parameter will also merge all in your map. Note that the final geometry will be triangulated, but cleaning it up is a fairly simple process, which will be explained in another guide.
: -usebsp_nomergeinstances
: Verwenden Sie diesen Parameter anstelle von , falls sie sowohl sauebere Geo als auch generieren möchten. Dies dauer etwas länger, da der Import-Prozess zwei Mal durchlaufen werden muss. The final geometry will also be triangulated.
: -skipdeps
: Optional: überspringt alle Abhängigkeiten/Inhalte und generiert nur die VMAP-Datei(en). Dies ermöglicht einen „schnellen“ Import, zum Beispiel beim durchlaufen (Iterieren) von Entitäten. Verwenden Sie diesen Parameter nicht, wenn Sie zum ersten Mal importieren.
Beispiel:
=== 7. Post Import Fixup ===
Nachdem Ihr Level importiert wurde, können Sie sich die Seite Post Import Fixup steps ansehen.
=== Experimentelle GUI ===
Wir haben ein benutzerfreundlicheres Import-Tool mit Benutzeroberfläche im Ordner hinzugefügt, um den Import-Prozess etwas zu vereinfachen. Die Datei heißt .
Es verfügt über nützliche Tooltips, einfach verwendbare Importoptionen und speichert Ihre Einstellungen zwischen verschiedenen Sitzungen. Sie müssen allerdings weiterhin die Vorbereitungen der Schritte 1–4 durchführen. Wir haben ebenfalls das offene -Skript zur Verfügung gestellt, um der Community die Möglichkeit zu geben, es je nach Anwendungsfall entsprechend anzupassen.
= Fehlerbehebung =
Wenn Sie eine nicht standardmäßige Skybox verwenden, wird beim Import möglicherweise die folgende Fehlermeldung angezeigt. Ändern Sie Ihre Skybox zu und versuchen Sie es erneut.
Der folgende Fehler weißt darauf hin, dass der Parameter Leerzeichen enthält. 
 Die Texte bei Skript Befehlszeilenparameter > -usebsp und -usebsp_nomergeinstances sollten noch übersetzt werden.