Fehlende Texturen und ERROR-Models in GMod beheben

Ein pink-schwarzes Schachbrett bedeutet, dass die Engine ein Material oder dessen Textur nicht findet. Ein großes rotes ERROR steht für ein fehlendes Model. Meist liegt der Inhalt nur auf dem Rechner des Mappers: Er wurde nicht in die BSP gepackt, stammt aus einem nicht gemounteten Spiel wie Team Fortress 2 oder wird über einen falschen Pfad gesucht. Mapper lösen das durch Packen und Pfadprüfung, Spieler und Server durch Mounten oder Nachladen der Inhalte.

Was die Symptome bedeuten

Für den letzten Fall gibt es einen eigenen Artikel: Cubemaps und Reflexionen beheben.

Die häufigsten Ursachen

1. Inhalt nicht gepackt: Eigene Materialien, Models und Sounds liegen in deinem lokalen Spielordner. Hammer und dein Spiel finden sie dort, alle anderen nicht.
2. Inhalt aus einem anderen Spiel: Viele Maps nutzen Assets aus anderen Source-Spielen. Den größten Teil der Texturen, Models und Sounds aus Counter-Strike: Source und den Half-Life-2-Episoden liefert GMod seit dem Update vom Juli 2025 selbst mit, nicht aber deren Maps, Musik und Sprachaufnahmen. Bei anderen Spielen wie Team Fortress 2 oder Portal sieht Schachbrett und ERROR, wer das Spiel nicht installiert und in GMod gemountet hat.
3. Falscher Pfad: In einer VMT steht $basetexture relativ zum Ordner materials und ohne Dateiendung. Ein Model sucht seine Materialien in den Ordnern, die beim Kompilieren des Models festgelegt wurden. Verschiebst du Dateien nachträglich in einen anderen Ordner, laufen diese Verweise ins Leere.
4. Unvollständige Dateien: Eine VMT ohne passende VTF ergibt ebenfalls ein Schachbrett. Ein Model besteht aus mehreren Dateien, neben der .mdl unter anderem .vvd, .vtx und häufig .phy. Fehlt eine davon, funktioniert das Model nicht.
5. Groß- und Kleinschreibung: Linux-Server unterscheiden zwischen Groß- und Kleinbuchstaben. Schreibe Datei- und Ordnernamen durchgehend klein.

Lösung für Mapper

Dass in Hammer alles richtig aussieht, sagt nichts aus. Der Editor lädt Inhalte aus deinen lokalen Ordnern und aus allen Spielen, die bei dir eingebunden sind.

1. Verschaffe dir einen Überblick, welche eigenen Materialien, Models und Sounds die Map verwendet.
2. Packe diese Dateien in die BSP. Pack-Werkzeuge finden die meisten Abhängigkeiten selbst. Kontrolliere trotzdem, ob auch die Materialien der Models und zusätzliche Texturen wie Normalmaps dabei sind. Die Details stehen im Artikel Custom Content in die BSP packen.
3. Prüfe die Pfade im Pakfile. Jede Datei muss dort so liegen wie im Spielordner, also beginnend mit materials/, models/ oder sound/. Seit Dezember 2023 prüft GMod eingebettete Dateien außerdem gegen eine Whitelist und lädt eine Datei nicht, die durchfällt. In der Konsole steht dann BSP embedded file failed whitelist check. Der Map Scanner listet eingebettete Lua- und Asset-Dateien im Pakfile auf.
4. Teste wie ein Fremder. Lade die BSP in einer GMod-Installation, in der weder deine Addons noch deine losen Dateien liegen, oder lass sie von jemandem testen, der dein Projekt nicht auf dem Rechner hat.
5. Nenne benötigte Spiele klar in der Beschreibung. Ob du Inhalte Dritter in deine Map packen darfst, ist eine Lizenzfrage und keine technische.

Dieser Test gehört fest zur Prüfung vor dem Release. Fehlende Inhalte gehören zu den Fehlern, die Spielern und Käufern als Erstes auffallen.

Lösung für Spieler

• Spiel mounten: Besitzt du das benötigte Spiel, installiere es über Steam. Öffne dann in GMod im Hauptmenü unten rechts das Symbol mit dem Gamecontroller, setze den Haken beim Spiel und starte GMod neu, falls die Inhalte danach noch fehlen.
• Workshop-Abhängigkeiten abonnieren: Viele Workshop-Maps nennen auf ihrer Seite benötigte Inhalte. Abonniere sie ebenfalls.
• Server-Inhalte laden: Tritt das Problem nur auf einem bestimmten Server auf, fehlen dir dessen Inhalte. Viele Server verlinken eine Workshop-Collection.

Inhaltspakete aus inoffiziellen Quellen sind rechtlich und sicherheitstechnisch heikel. Der saubere Weg ist das gemountete Originalspiel.

Lösung für Server-Betreiber

Auf einem Server gibt es zwei getrennte Aufgaben.

Der Server selbst braucht die Inhalte. Fehlt ihm ein Model, fehlen auch dessen Kollisionsdaten. Inhalte anderer Spiele bindest du auf einem Dedicated Server über die Datei garrysmod/cfg/mount.cfg ein.

Die Spieler brauchen die Inhalte. Dafür gibt es drei Wege:

• Inhalte, die in die BSP gepackt sind, kommen automatisch mit der Map, sofern sie die Whitelist von GMod für eingebettete Dateien bestehen.
• Workshop-Inhalte lädst du auf den Server über eine Collection und lässt sie mit resource.AddWorkshop an die Spieler ausliefern.
• Lose Dateien verteilst du per FastDL über sv_downloadurl.

Wie du das einrichtest, steht im Artikel GMod-Map auf dem Server installieren: FastDL und Workshop. Benötigt deine Map ein gemountetes Spiel, schreibe das gut sichtbar in die Serverinfo.

Häufige Fragen

Warum sehe ich nur auf manchen Servern pinke Texturen?

Weil jeder Server eigene Inhalte verwendet. Dir fehlen die Dateien dieses Servers, oder seine Map nutzt ein Spiel, das du nicht gemountet hast. Auf Servern, die nur Standardinhalte nutzen, tritt das Problem dann nicht auf.

Brauche ich Counter-Strike: Source für GMod?

In den meisten Fällen nicht mehr. Den größten Teil der Texturen, Models und Sounds aus Counter-Strike: Source liefert GMod seit dem Update vom Juli 2025 selbst mit. Installiert und gemountet brauchst du das Spiel weiterhin für seine originalen Maps und für Maps, die seine Musik oder Sprachaufnahmen verwenden.

Warum sieht in Hammer alles richtig aus, im Spiel aber nicht?

Hammer und dein eigenes Spiel finden die Dateien in deinen lokalen Ordnern. Andere Spieler haben diese Ordner nicht. Erst ein Test ohne deine lokalen Inhalte zeigt, was wirklich in der BSP steckt.

Was ist der Unterschied zwischen Schachbrett und ERROR-Model?

Das Schachbrett ersetzt ein fehlendes Material oder eine fehlende Textur. Das rote ERROR ersetzt ein fehlendes Model. Ist ein Model sichtbar, aber pink-schwarz, wurde die Model-Datei gefunden und nur ihre Materialien fehlen.