So richtest Du FastDL auf Deinem Garry's Mod Server ein

Damit Spieler eigene Inhalte Deines Servers wie Modelle, Texturen, Sounds oder Maps sehen, müssen sie diese herunterladen. Mit FastDL laden die Spieler diese Dateien beim Beitreten über HTTP von Deinem Webspace herunter. Du hinterlegst dafür die Adresse des Webspaces in der server.cfg und legst per Lua fest, welche Dateien heruntergeladen werden sollen.

Voraussetzungen für FastDL

Für FastDL benötigst Du einen eigenen Webserver bzw. Webspace, der über http:// oder https:// öffentlich erreichbar ist. Dein Garry's Mod Server selbst ist kein Webserver und kann die Dateien nicht über HTTP ausliefern.

Inhalte auf dem Gameserver bereitstellen

Die Dateien, die die Spieler herunterladen sollen, müssen auch auf Deinem Gameserver liegen. Fehlt eine Datei auf dem Server, wird sie nicht in die Downloadliste aufgenommen.

1. Server stoppen
   Stoppe Deinen Server über die Verwaltung.

2. Per SFTP verbinden
   Verbinde Dich per SFTP mit Deinem Server.

3. Inhalte hochladen
   Lade Deine Inhalte als Addon in einen eigenen Unterordner hoch, zum Beispiel:

   /garrysmod/addons/meinserver-inhalte/
   

   Darin liegen die Unterordner wie materials/, models/ oder sound/. Eigene Maps legst Du als .bsp-Datei unter /garrysmod/maps/ ab.

Dateien auf den Webspace hochladen

Die Spieler fordern jede Datei unter der Adresse Deines Webspaces mit demselben Pfad an, den sie relativ zum Ordner garrysmod/ hat. Die Ordnerstruktur auf dem Webspace muss deshalb genau der Struktur im Spiel entsprechen.

1. Ordnerstruktur anlegen
   Lege im Hauptverzeichnis Deines Webspaces dieselben Ordner an, die Deine Inhalte verwenden, zum Beispiel maps/, materials/, models/ und sound/.

2. Dateien hochladen
   Lade die Dateien in die passenden Ordner hoch. Den Addon-Ordner selbst lässt Du dabei weg: Aus /garrysmod/addons/meinserver-inhalte/materials/meinserver/logo.vmt auf dem Gameserver wird auf dem Webspace materials/meinserver/logo.vmt.

3. Dateien optional komprimieren
   Du kannst die Dateien zusätzlich im Format bzip2 komprimieren, um die Downloads zu verkleinern. Die komprimierte Datei bekommt dabei die Endung .bz2 an den vollständigen Dateinamen angehängt, zum Beispiel logo.vmt.bz2. Die Spieler fragen zuerst die .bz2-Datei an. Gibt es keine komprimierte Fassung, laden sie die unkomprimierte Datei herunter.

Download-URL eintragen

1. Datei öffnen
   Öffne per SFTP folgende Datei:

   /garrysmod/cfg/server.cfg
   

2. URL eintragen
   In der Datei steht bereits die Zeile sv_downloadurl "". Trage zwischen den Anführungszeichen die Adresse Deines Webspaces ein:

   sv_downloadurl "https://fastdl.example.com"
   

   Die Adresse muss auf das Verzeichnis zeigen, in dem die Ordner materials/, models/ usw. liegen.

3. Download vom Gameserver deaktivieren
   Füge unter der Zeile // Add custom lines under here folgende Zeile hinzu:

   sv_allowdownload 0
   

   Damit laden die Spieler keine Dateien direkt vom Gameserver herunter. Warum das wichtig ist, erfährst Du unter Download direkt vom Gameserver.

4. Datei speichern
   Speichere die Datei.

Dateien zum Download markieren

Damit die Spieler die Dateien herunterladen, musst Du sie in einer serverseitigen Lua-Datei für den Download markieren. Dafür gibt es zwei Funktionen:

Funktion	Beschreibung
resource.AddFile	Markiert die Datei und alle zugehörigen Dateien. Bei einer .vmt-Datei wird automatisch die gleichnamige .vtf-Datei hinzugefügt, bei einer .mdl-Datei automatisch die gleichnamigen .vvd-, .ani-, .dx80.vtx-, .dx90.vtx- und .phy-Dateien.
resource.AddSingleFile	Markiert nur genau die angegebene Datei.

1. Lua-Datei anlegen
   Lege per SFTP eine neue Datei an, zum Beispiel:

   /garrysmod/lua/autorun/server/fastdl.lua
   

2. Dateien eintragen
   Trage pro Datei eine Zeile ein. Der Pfad wird relativ zum Ordner garrysmod/ angegeben – ohne addons/<addonname>/ davor und ohne die Endung .bz2:

   resource.AddFile( "materials/meinserver/logo.vmt" )
   resource.AddFile( "models/meinserver/stuhl.mdl" )
   resource.AddFile( "sound/meinserver/musik.wav" )
   resource.AddFile( "maps/rp_beispielstadt.bsp" )
   

3. Server starten
   Speichere die Datei und starte Deinen Server. Beim nächsten Beitreten laden die Spieler die markierten Dateien von Deinem Webspace herunter.

Einschränkungen von FastDL

Download direkt vom Gameserver

Über die ConVar sv_allowdownload können Spieler Dateien auch direkt vom Gameserver herunterladen. Diese Methode solltest Du nicht verwenden: Sie ist mit rund 64 KB/s sehr langsam.