Solucionar errores

Solucionar texturas faltantes y modelos ERROR en GMod

Texturas rosas y negras y modelos ERROR rojos en GMod: causas y soluciones para mappers, jugadores y servidores, desde empaquetar contenido hasta montar juegos.

Un patrón de cuadros rosas y negros significa que el motor no encuentra un material o su textura. Un ERROR rojo y grande indica que falta un modelo. Normalmente el contenido solo existe en el PC del mapper: no se empaquetó en el BSP, procede de un juego que no está montado, como Team Fortress 2, o se busca en una ruta equivocada. Los mappers lo arreglan empaquetando y revisando las rutas; los jugadores y los servidores, montando o descargando el contenido.

Qué significan los síntomas

SíntomaSignificado
Cuadros rosas y negros en paredes, suelos o decalsNo se ha encontrado el material (.vmt) o su textura (.vtf)
Un modelo se ve, pero en rosa y negroEl archivo del modelo está, faltan sus materiales
ERROR rojo y grandeNo se ha encontrado el archivo del modelo (.mdl)
Reflejos morados y negros en superficies que por lo demás están bienUn problema de cubemaps, no un material que falte

El último caso tiene su propio artículo: arreglar los reflejos de los cubemaps.

Las causas más frecuentes

  1. Contenido sin empaquetar: Los materiales, modelos y sonidos custom están en tu carpeta local del juego. Hammer y tu juego los encuentran ahí, nadie más.
  2. Contenido de otro juego: Muchos mapas usan assets de otros juegos de Source. Desde la actualización de julio de 2025, GMod incluye la mayor parte de las texturas, los modelos y los sonidos de Counter-Strike: Source y de los episodios de Half-Life 2, pero no sus mapas, su música ni sus voces. Con otros juegos, como Team Fortress 2 o Portal, quien no tiene el juego instalado y montado en GMod ve cuadros y ERROR.
  3. Ruta equivocada: En un VMT, $basetexture se indica de forma relativa a la carpeta materials y sin extensión de archivo. Un modelo busca sus materiales en las carpetas que se fijaron al compilarlo. Si después mueves archivos a otra carpeta, esas referencias no apuntan a ninguna parte.
  4. Archivos incompletos: Un VMT sin su VTF correspondiente también acaba en cuadros rosas y negros. Un modelo se compone de varios archivos, entre ellos .vvd, .vtx y a menudo .phy junto al .mdl. Si falta uno, el modelo no funciona.
  5. Mayúsculas y minúsculas: Los servidores Linux distinguen entre mayúsculas y minúsculas. Escribe siempre en minúsculas los nombres de archivos y carpetas.

La solución para mappers

Que en Hammer todo se vea bien no demuestra nada. El editor carga contenido de tus carpetas locales y de todos los juegos que tienes montados.

  1. Hazte una idea clara de qué materiales, modelos y sonidos custom usa el mapa.
  2. Empaqueta esos archivos en el BSP. Las herramientas de empaquetado encuentran por sí solas la mayoría de las dependencias. Aun así, comprueba que estén incluidos los materiales de los modelos y las texturas adicionales, como los normal maps. Los detalles están en el artículo sobre empaquetar contenido custom en un BSP.
  3. Revisa las rutas dentro del pakfile. Cada archivo tiene que estar guardado ahí igual que en la carpeta del juego, empezando por materials/, models/ o sound/. Desde diciembre de 2023, GMod comprueba además los archivos incrustados contra una whitelist y no carga un archivo que no la pase. La consola muestra entonces BSP embedded file failed whitelist check. El Map Scanner lista los archivos Lua y los assets incrustados en el pakfile.
  4. Prueba como lo haría un desconocido. Carga el BSP en una instalación de GMod que no tenga ni tus addons ni tus archivos sueltos, o pide que lo pruebe alguien que no tenga tu proyecto en su PC.
  5. Indica con claridad en la descripción qué juegos hacen falta. Si puedes empaquetar contenido de terceros en tu mapa es una cuestión de licencias, no técnica.

Esta prueba es parte fija de revisar un mapa antes de publicarlo. El contenido que falta es de los primeros fallos que notan los jugadores y los compradores.

La solución para jugadores

  • Monta el juego: Si tienes el juego necesario, instálalo desde Steam. Después abre el icono del mando en la parte inferior derecha del menú principal de GMod, marca el juego y, si el contenido sigue sin aparecer, reinicia GMod.
  • Suscríbete a las dependencias de Workshop: Muchos mapas de Workshop indican en su página el contenido que necesitan. Suscríbete también a eso.
  • Consigue el contenido del servidor: Si el problema solo aparece en un servidor concreto, te falta el contenido de ese servidor. Muchos servidores enlazan una colección de Workshop.

Los packs de contenido de fuentes no oficiales son dudosos tanto en lo legal como en lo que respecta a la seguridad. El camino limpio es el juego original montado.

La solución para propietarios de servidor

En un servidor hay dos tareas distintas.

El propio servidor necesita el contenido. Si le falta un modelo, también le faltan los datos de colisión de ese modelo. En un servidor dedicado, el contenido de otros juegos se monta con el archivo garrysmod/cfg/mount.cfg.

Los jugadores necesitan el contenido. Hay tres formas de hacérselo llegar:

  • El contenido empaquetado en el BSP llega automáticamente con el mapa, siempre que pase la whitelist de GMod para archivos incrustados.
  • El contenido de Workshop se carga en el servidor mediante una colección y se entrega a los jugadores con resource.AddWorkshop.
  • Los archivos sueltos se distribuyen por FastDL con sv_downloadurl.

Cómo se configura todo esto lo explica el artículo sobre instalar un mapa en un servidor de GMod con FastDL y Workshop. Si tu mapa requiere un juego montado, dilo claramente en la información del servidor.

Preguntas frecuentes

¿Por qué solo veo texturas rosas en algunos servidores?

Porque cada servidor usa su propio contenido. Te faltan los archivos de ese servidor, o su mapa usa un juego que no tienes montado. En los servidores que solo usan contenido estándar el problema no aparece.

¿Necesito Counter-Strike: Source para GMod?

En la mayoría de los casos, ya no. Desde la actualización de julio de 2025, GMod incluye la mayor parte de las texturas, los modelos y los sonidos de Counter-Strike: Source. Sigues necesitando el juego, instalado y montado, para sus mapas originales y para los mapas que usan su música o sus voces.

¿Por qué en Hammer todo se ve bien y en el juego no?

Hammer y tu propio juego encuentran los archivos en tus carpetas locales. Los demás jugadores no tienen esas carpetas. Solo una prueba sin tu contenido local muestra lo que hay de verdad dentro del BSP.

¿Qué diferencia hay entre los cuadros rosas y negros y un modelo ERROR?

Los cuadros sustituyen a un material o una textura que falta. El ERROR rojo sustituye a un modelo que falta. Si un modelo se ve, pero en rosa y negro, el archivo del modelo se ha encontrado y solo faltan sus materiales.