GMod Map auf Server installieren: FastDL oder Workshop

Eine Map installierst du, indem du die .bsp auf dem Server nach garrysmod/maps legst und sie als Startmap setzt oder mit changelevel lädst. Damit Spieler beitreten können, brauchen sie dieselbe Datei. Die bekommen sie am besten über FastDL oder den Steam Workshop, weil der direkte Download vom Gameserver sehr langsam ist.

Schritt 1: Map auf den Server legen

1. Lade die .bsp per FTP oder SFTP nach garrysmod/maps/. Verwende durchgehend Kleinbuchstaben im Dateinamen. Auf Linux-Servern wird zwischen Groß- und Kleinschreibung unterschieden.
2. Gehören weitere Dateien zur Map, kommen sie in die passenden Ordner. Eine .nav liegt ebenfalls in garrysmod/maps/, loser Content in materials, models oder sound. Ist der Content in der BSP gepackt, entfällt dieser Schritt.
3. Setze die Map als Startmap. In der Startzeile des Servers geschieht das mit +map rp_beispiel, der Spielmodus mit +gamemode darkrp. Viele Hoster bieten dafür ein Feld im Webinterface.
4. Auf einem laufenden Server wechselst du mit changelevel rp_beispiel in der Serverkonsole oder per RCON. Der Befehl maps * listet alle Maps auf, die der Server findet.

Startet der Server mit einer anderen Map oder gar nicht, liegt es fast immer am Namen oder am Ablageort: Tippfehler, Großbuchstaben oder der falsche Ordner. Im Startparameter steht der Map-Name ohne die Endung .bsp.

Schritt 2: Wie Spieler die Map bekommen

Jeder Client braucht die BSP lokal. Dafür gibt es drei Wege.

Direkter Download vom Gameserver

Mit sv_allowdownload 1 schickt der Gameserver die Datei selbst an den Client. Das funktioniert ohne weitere Einrichtung, ist aber stark gedrosselt. Außerdem begrenzt net_maxfilesize die Dateigröße, in der Voreinstellung auf 16 MB. Ein höherer Wert macht die Übertragung nicht schneller. Für heutige RP-Maps ist dieser Weg nur eine Notlösung.

FastDL über einen Webserver

Bei FastDL laden Clients die Dateien per HTTP von einem Webspace. Du trägst die Adresse in der server.cfg ein:

sv_downloadurl "http://fastdl.example.com/garrysmod/"

Diese eine Variable schaltet FastDL ein. sv_allowdownload steuert nur den direkten Download vom Gameserver. Der Webspace spiegelt die Ordnerstruktur des Servers. Die Map muss also unter .../garrysmod/maps/rp_beispiel.bsp erreichbar sein. Optional legst du daneben eine mit bzip2 komprimierte Fassung als rp_beispiel.bsp.bz2 ab. Der Client fragt zuerst nach der komprimierten Datei und entpackt sie selbst, was den Download deutlich verkürzt, sofern die BSP nicht schon selbst komprimiert ist.

Teste die Adresse im Browser. Wenn die Datei dort nicht lädt, lädt sie auch im Spiel nicht.

Steam Workshop

Liegt die Map als Workshop-Addon vor, übernimmt Steam die Verteilung. Der Server lädt seine Addons über eine Collection, die du in der Startzeile angibst:

+host_workshop_collection 1234567890

Stammt die laufende Map aus dieser Collection, markiert der Server sie von selbst für den Download durch die Clients. Für andere Workshop-Addons mit Content, etwa ein Texturpaket, trägst du die ID des Addons in einer serverseitigen Lua-Datei ein, zum Beispiel in garrysmod/lua/autorun/server/workshop.lua:

resource.AddWorkshop("9876543210")

Die Zahl ist die ID aus der Adresse des einzelnen Workshop-Eintrags, nicht die ID der Collection.

Vor- und Nachteile im Vergleich

Viele Server kombinieren beides: Workshop für frei verfügbare Addons, FastDL für Dateien, die nicht im Workshop stehen sollen.

Typische Fehler und ihre Ursachen

„Missing map 'maps/rp_beispiel.bsp', disconnecting“: Der Client hat die Map nicht und konnte sie nicht laden. Prüfe der Reihe nach:

• Ohne FastDL und Workshop: Steht sv_allowdownload auf 1?
• Stimmt die sv_downloadurl, und liegt die Datei dort im Unterordner maps?
• Ist die .bz2 aktuell und nicht beschädigt?
• Hat der Spieler Downloads abgeschaltet? Die Einstellung dazu heißt cl_downloadfilter.

„Your map [maps/rp_beispiel.bsp] differs from the server's“: Client und Server haben unter gleichem Namen unterschiedliche Dateien. Der Spieler löscht seine alte Kopie aus garrysmod/maps oder garrysmod/download/maps und verbindet sich neu. Als Betreiber vermeidest du das, indem jede Map-Version einen eigenen Dateinamen bekommt und du FastDL und Server immer gemeinsam aktualisierst. Die .bz2 wird dabei gern vergessen.

Map lädt, aber Texturen fehlen: Dann fehlt Content, der nicht in der BSP steckt, oder ein vorausgesetztes Spiel. Hilfe dazu steht in Fehlende Texturen und Error-Models beheben. Mappern hilft Custom Content in die BSP packen.

Gekaufte und geschützte Maps: Lizenz beachten

Wer eine Map kauft, erwirbt in der Regel ein Nutzungsrecht für den eigenen Server, nicht das Recht, die Datei öffentlich weiterzugeben. Ein öffentlicher Workshop-Upload macht die Map für alle frei verfügbar und ist deshalb meist nicht erlaubt. Lies die Lizenzbedingungen, bevor du dich für einen Verteilweg entscheidest, und frage im Zweifel den Mapper. FastDL für die Spieler des eigenen Servers ist der übliche Weg. Grundlagen dazu stehen in GMod-Maps sicher kaufen.

Bei Maps mit Server-Exclusive ist die Aufteilung vorgegeben. Verteilt wird nur die geschützte BSP aus dem Paket, alle übrigen Dateien bleiben privat auf dem lizenzierten Server. Wie das Prinzip funktioniert und wo seine Grenzen liegen, erklärt der Artikel Server-Exclusive Maps.

Häufige Fragen

Muss ich die Map zusätzlich mit resource.AddFile eintragen?

Nein. Die aktuell laufende Map bietet der Server den Clients von selbst zum Download an. resource.AddFile brauchst du nur für losen Content, der nicht in der BSP gepackt ist.

FastDL oder Workshop: Was ist besser?

Für frei verfügbare Maps ist der Workshop am bequemsten, weil Steam Verteilung und Updates übernimmt. Für Maps, die nicht öffentlich stehen sollen oder dürfen, ist FastDL die richtige Wahl. Beide Wege sind für Spieler ähnlich schnell.

Wo speichert GMod heruntergeladene Maps?

Maps, die vom Server oder per FastDL kommen, liegen beim Spieler in garrysmod/download/maps. Workshop-Inhalte verwaltet Steam getrennt davon.

Warum laden Spieler trotz FastDL langsam?

Meist findet der Client die Datei unter der angegebenen Adresse nicht. Je nach Einstellung des Servers bekommt er sie dann über den langsamen direkten Download oder gar nicht. Prüfe Schreibweise, abschließenden Schrägstrich und Ordnerstruktur der sv_downloadurl und rufe die Datei testweise im Browser auf.