Los addons de Workshop de Garry's Mod se instalan correctamente mediante una Steam Workshop Collection, una Steam Web API Key y, opcionalmente, resource.AddWorkshop() para la descarga del cliente. Así la configuración del servidor sigue siendo comprensible, los addons se pueden sustituir de forma centralizada y, si hay problemas, puedes comprobar de forma precisa si la Collection, la API Key o alguna Workshop-ID concreta son incorrectas.
Requisitos
Necesitas acceso a los parámetros de inicio de tu servidor de Garry's Mod, una Steam Workshop Collection y una Steam Web API Key. La fuente oficial para contenido de Workshop de Garry's Mod es el Steam Workshop para Garry's Mod. La API Key la generas desde la página oficial de Steam steamcommunity.com/dev/apikey.
Planifica bien la selección de addons. Una Collection grande puede alargar el arranque del servidor, obligar a los clientes a descargas más largas y hacer que los errores sean más difíciles de localizar. Para servidores en producción tiene sentido probar primero los addons de uno en uno o en grupos pequeños antes de incorporarlos de forma permanente a la Collection principal. En game-serverhosting, este proceso encaja bien con un modelo de operación controlado: los cambios se documentan, se revisan y solo después se habilitan para los jugadores.
Crear una Workshop Collection
- Ve al Steam Workshop
- Crea una nueva Collection
- Añade todos los addons que quieras
- Copia la Collection-ID
La Collection-ID aparece en la URL de la Collection de Steam. Copia solo la ID numérica, no la URL completa. Asegúrate además de que la Collection sea pública o accesible para el servidor. Si un addon se elimina, se pone privado o el autor lo actualiza, eso puede afectar al arranque de tu servidor o a las descargas del cliente. Por eso, después de cambios importantes, revisa siempre la consola del servidor.
Cargar la Collection en el servidor
En la línea de inicio del servidor:
+host_workshop_collection <collection_id>
-authkey <steam_web_api_key>
Sustituye <collection_id> por la ID de tu Workshop Collection y <steam_web_api_key> por tu Steam Web API Key. El parámetro +host_workshop_collection indica al servidor que cargue la Collection especificada. El parámetro -authkey proporciona acceso a los servicios web de Steam necesarios para las descargas de Workshop.
Después de introducir los parámetros de inicio, reinicia el servidor. Durante el primer arranque, observa la consola o el log. Si el contenido de Workshop no se carga, la causa suele estar en una Collection-ID incorrecta, una API Key ausente o no válida, o un addon que ya no está disponible.
Clave de la API web de Steam
Necesaria para descargas de Workshop:
- Ve a steamcommunity.com/dev/apikey
- Genera una key
- Introdúcela como
-authkeyen la línea de inicio
Trata la API Key como un token de acceso. No la compartas públicamente ni la escribas en foros, capturas de pantalla o repositorios accesibles. Si sospechas que la key se ha expuesto, deberías regenerarla en Steam y dejar de usar la anterior.
Los jugadores descargan addons automáticamente
Para que los jugadores descarguen addons automáticamente, añade esto en lua/autorun/server/workshop.lua:
resource.AddWorkshop("workshop_id_1")
resource.AddWorkshop("workshop_id_2")
resource.AddWorkshop("workshop_id_3")
resource.AddWorkshop() usa Workshop-IDs individuales. Introduce aquí los addons que los clientes deben obtener automáticamente al conectarse. Esto es especialmente importante para mapas, modelos, materiales, sonidos u otros contenidos que los jugadores necesitan localmente. Los addons solo de servidor no tienen por qué distribuirse necesariamente a los clientes.
Mantén este archivo claramente estructurado. Puedes agrupar los addons por finalidad, por ejemplo mapas, armas, playermodels o HUDs. Si un addon causa problemas, comenta temporalmente la entrada correspondiente y reinicia el servidor. Así encuentras conflictos más rápido sin desmontar toda la Collection.
Categorías de addons populares
| Categoría | Ejemplos |
|---|---|
| Mapas | ttt_minecraft, ph_office |
| Armas | M9K Weapons, TFA Base |
| Playermodels | PM + Playermodel Selector |
| Herramientas | Wiremod, Precision Tool |
| HUDs | DarkRP HUD, TTT HUD |
Estas categorías son ejemplos típicos, no una recomendación para cada setup. Los servidores DarkRP, TTT, Prop Hunt y Sandbox tienen requisitos distintos. Lo importante es que los addons encajen con el modo de juego, se mantengan activos y no traigan funciones duplicadas. Dos bases de armas, varios HUDs o varias herramientas de administración pueden interferir entre sí.
Si también gestionas otros juegos con workflows de mods, te ayudan los principios de la guía de Workshop de Project Zomboid y la guía para instalar mods de ARK: primero aclarar dependencias, luego introducir IDs correctamente y después verificar con logs y una prueba de cliente.
Comprobar el resultado
Reinicia el servidor después de cada cambio importante y controla tres puntos. Primero: la consola no debería mostrar errores de Workshop relacionados con la Collection o la API Key. Segundo: los addons deseados deberían estar disponibles del lado del servidor, por ejemplo mapas en la lista de mapas o herramientas en el modo de juego correspondiente. Tercero: un cliente de prueba debería descargar automáticamente el contenido necesario al conectarse o no mostrar problemas de Missing Texture.
Prueba, si es posible, con un cliente que no tenga los addons ya suscritos localmente. De lo contrario, puedes pasar por alto fácilmente que la descarga automática para nuevos jugadores no funciona. En servidores públicos también merece la pena añadir una breve nota en la descripción del servidor si hay que descargar contenido muy grande.
Solución de problemas
- El addon no carga: comprobar la Steam Web API Key
- Missing Textures: instalar el CSS Content Pack
- Descarga lenta: reducir la Collection a lo imprescindible
Si no se carga toda la Collection, comprueba primero errores de escritura en +host_workshop_collection y -authkey. Si solo falta un addon concreto, abre su página de Workshop y comprueba si sigue disponible. En caso de texturas ausentes, distingue entre contenido de Workshop y contenido externo necesario. Los servidores de Garry's Mod usan a menudo contenido que no se sustituye automáticamente mediante un único addon.
Si los tiempos de carga son largos, elimina mapas no usados, modelos duplicados, paquetes de armas antiguos y colecciones grandes de sonidos o materiales. Una Collection más pequeña es más fácil de mantener y reduce la probabilidad de que los jugadores abandonen en el primer join.
Comprobación, límites y vuelta atrás segura
La guía «Instalar addons de Workshop de Garry's Mod» se aplica al tipo de servidor descrito en el artículo y al estado de versiones visible en el momento de la revisión. Los nombres de menús, versiones disponibles, compatibilidad de mods o plugins y recursos necesarios pueden variar después de actualizaciones. Por eso, no transfieras valores sin comprobarlos a otra versión de juego, loader o servidor.
Antes de cambiar el mundo, la partida guardada, la configuración o las extensiones, crea una copia de seguridad de los archivos afectados. Después cambia solo un paso relacionado y compruébalo con la misma versión de cliente y servidor con la que quieras jugar más tarde.
| Punto de prueba | Resultado esperado | Cancelación y vuelta atrás |
|---|---|---|
| Arranque del servidor | El servidor alcanza el estado operativo sin nuevos mensajes de error. | Si hay errores de arranque, deshacer el cambio y restaurar la última copia de seguridad. |
| Prueba de conexión | Una cuenta de prueba puede conectarse mediante la dirección mostrada en el panel. | Si hay errores de versión o conexión, revisar de nuevo versión, puerto y permisos. |
| Prueba de función | La función modificada en concreto funciona sin dañar datos existentes del mundo o del juego. | Si aparecen efectos secundarios, detener el servidor y restaurar los archivos guardados. |
Una prueba individual correcta no garantiza rendimiento ni disponibilidad. El tamaño del mundo, mods, plugins, número de jugadores, ruta de red y carga simultánea pueden cambiar el resultado. Documenta versión, cambio y resultado de la prueba para poder entender desviaciones posteriores.
FAQ
¿Necesito siempre una Workshop Collection?
Para un servidor con varios addons, una Collection es la forma más limpia, porque gestionas la selección de forma centralizada en Steam. Aun así, las Workshop-IDs individuales en resource.AddWorkshop() siguen siendo importantes para que los clientes descarguen automáticamente el contenido necesario.
¿Cuál es la diferencia entre Collection-ID y Workshop-ID?
La Collection-ID apunta a una colección de varios addons. Una Workshop-ID apunta a un addon individual. En la línea de inicio usas la Collection-ID; en resource.AddWorkshop() introduces Workshop-IDs individuales.
¿Por qué los jugadores ven texturas ausentes?
Las texturas ausentes suelen aparecer cuando no se cargó contenido del cliente o se necesita contenido adicional. Comprueba resource.AddWorkshop(), las IDs de los addons y si el addon afectado apunta a más contenido.
¿Tengo que reiniciar el servidor después de cada cambio de addon?
Para cambios en parámetros de inicio, Workshop Collection o archivos Lua del servidor deberías reiniciar. Solo así compruebas de forma fiable si el servidor carga correctamente la Collection y registra los recursos del cliente.
¿Qué tamaño debería tener una Collection?
Tan pequeña como sea posible y tan grande como sea necesario. Elimina addons que tu modo de juego no use activamente. Eso facilita la búsqueda de errores, mantiene las descargas manejables y hace que los cambios durante la operación sean más controlables.