[GH-ISSUE #3514] [FEATURE]Steam Workshop Support #2372

Open
opened 2026-02-27 03:02:31 +03:00 by kerem · 0 comments
Owner

Originally created by @Claiyc on GitHub (Jul 20, 2021).
Original GitHub issue: https://github.com/GameServerManagers/LinuxGSM/issues/3514

User Story

As a LGSM-User, I want a general steam workshop support to be added so that it becomes much easier to install mods on steam gameservers.

Basic info

  • Command: [mods]

Further Information

Many games, such as ARK or ARMA utilize the steam workshop as a platform for independent developers to upload their mods, that can be installed on the games server- (and perhaps client-) software.
My idea would be to add a variable "steammodids" to the linuxgsm config, a comma seperated list of modids to be installed.

The procedure of installing mods from the steamworkshop is always the same.

Example:
Download the Mod "Structures Plus"(731604991) for the game "ARK: Survival Evolved"(346110) to /home/gameserver :
steamcmd +login anonymous + force_install_dir "/home/gameserver" +workshop_download_item 346110 731604991
The downloaded mod items then only have to be placed in the right folder (for arkserver that would be serverfiles/ShooterGame/Mods/).

Checking for mod-updates via the steam web api
To check wether a mod has been updated, you can retreive additional information as a json string via the steam web api (see link below).

Example:
To retreive additional information for the Mod "Structures Plus"(731604991) for the game "ARK: Survival Evolved"(346110), send a POST-Request to https://api.steampowered.com/ISteamRemoteStorage/GetPublishedFileDetails/v1/ containing the variables itemcount = 1 and publishedfileids[0] = 731604991

Result:

SPOILER {"response":{"result":1,"resultcount":1,"publishedfiledetails":[{"publishedfileid":"787023321","result":1,"creator":"76561198207216944","creator_app_id":346110,"consumer_app_id":346110,"filename":"","file_size":1391503,"file_url":"http://depotcontent.akamai.steamusercontent.com/staticcontent/346110/614094907/depot_346110_9170410184033285252.zip","hcontent_file":"9170410184033285252","preview_url":"https://steamuserimages-a.akamaihd.net/ugc/241333401165577293/96F98D936613B98B7703973567EB31CDB250BE16/","hcontent_preview":"241333401165577293","title":"Potions X","description":"[h1]Potions X[/h1]\r\n\r\n[b]CONTENT[/b]\r\n[list]\r\n [*]12 Special Potions\r\n[/list]\r\n\r\n[b]FEATURES[/b]\r\n\r\nInstant Potions for Players or Dinos to eighter\r\n[list]\r\n [*]Gain XP (Small/Medium/Large)\r\n [*]Recover Full Health\r\n [*]Wake Up\r\n [*]Repair Inventory Items\r\n [*]Make Hungry\r\n [*]Give Full Stamina\r\n [*]Add/Remove Speed (temporary removed)\r\n [*]High temporary Craft Speed/Skill\r\n [*]Instant Grow Hair (unlocks all hair styles)\r\n [*]More Speed (may need server restart to display value)\r\n [*]More Weight (may need server restart to display value)\r\n [*]Give Creative Mode Potion\r\n[/list]\r\n\r\nBe aware that this MOD is NOT for PVP servers, as all items cost only 1 fiber.\r\n\r\n[b]INI OPTIONS[/b]\r\n\r\n[code]\r\n[Potions]\r\nSpeedMultiplier=1.5\r\nWeightMultiplier=2\r\n[/code]\r\n\r\n[code]\r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_Healing_Potion_X.PrimalItemConsumable_Healing_Potion_X'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_Repair_Potion_X.PrimalItemConsumable_Repair_Potion_X'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_Wakeup_Potion_X.PrimalItemConsumable_Wakeup_Potion_X'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_Hunger_Potion_X.PrimalItemConsumable_Hunger_Potion_X'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_Stamina_Potion_X.PrimalItemConsumable_Stamina_Potion_X'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_XP_Potion_X_Small.PrimalItemConsumable_XP_Potion_X_Small'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_XP_Potion_X_Medium.PrimalItemConsumable_XP_Potion_X_Medium'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_XP_Potion_X_Big.PrimalItemConsumable_XP_Potion_X_Big'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_Creative_Potion_X.PrimalItemConsumable_Creative_Potion_X'\" 1 0 0 \r\n[/code]\r\n\r\n[b]MOD ID:[/b]\r\n[table]\r\n [tr]\r\n [th]787023321[/th]\r\n [/tr]\r\n[/table]\r\n[i]Mod is clean and stackable[/i]\r\n\r\n\r\n[URL=http://steamcommunity.com/profiles/76561198207216944/myworkshopfiles/?p=1] / / / CHECK OUT MY OTHER MODS / / /[/URL]\r\n\r\n\r\n[b]Feel free to donate if you like my MOD! Or if you would like it to be improved[/b]\r\n[URL=https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=donate%40dubCUT%2ech&lc=CH&item_name=Game%20Modding¤cy_code=USD&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted] [IMG]https://steamuserimages-a.akamaihd.net/ugc/1795223008080556716/5C479BD03AD6F7FA449817D55790D94895F09515/[/IMG] [/url]\r\n[img]https://steamuserimages-a.akamaihd.net/ugc/1795223008080557185/AAF7511DA72CB0FA1222D38BE270436D39AE943F/[/img] \r\n\r\nThis mod/code/work is protected by the [URL=http://creativecommons.org/licenses/by-nc-nd/4.0/legalcode]Attribution-NonCommercial-NoDerivatives 4.0 International Creative Commons License.\r\n[IMG]https://steamuserimages-a.akamaihd.net/ugc/911288903790420619/58BD7FE9EA4C1F04EB98D28F912B63441E5D137A/[/IMG][/URL]\r\n\r\n[b]Thank you everyone![/b]","time_created":1477408824,"time_updated":1525279596,"visibility":0,"banned":0,"ban_reason":"","subscriptions":15888,"favorited":647,"lifetime_subscriptions":35695,"lifetime_favorited":799,"views":22459,"tags":[]}]}}

You can then check the time_updated variable to determine, when the mod has been updated the last time.
Of course you can also print some of the information via the details command to provide additional insights.

Further Reading

Steam workshop example (ARK): https://steamcommunity.com/workshop/browse/?appid=346110
Steam web api documentation: https://partner.steamgames.com/doc/webapi
Steam web api mod-query: https://partner.steamgames.com/doc/webapi/ISteamRemoteStorage (See GetPublishedFileDetails)

Related to #2777 #1623 #2092

Originally created by @Claiyc on GitHub (Jul 20, 2021). Original GitHub issue: https://github.com/GameServerManagers/LinuxGSM/issues/3514 ## User Story As a LGSM-User, I want a general steam workshop support to be added so that it becomes much easier to install mods on steam gameservers. ## Basic info * **Command:** [mods] ## Further Information Many games, such as ARK or ARMA utilize the steam workshop as a platform for independent developers to upload their mods, that can be installed on the games server- (and perhaps client-) software. My idea would be to add a variable "steammodids" to the linuxgsm config, a comma seperated list of modids to be installed. The procedure of installing mods from the steamworkshop is always the same. Example: Download the Mod "Structures Plus"(731604991) for the game "ARK: Survival Evolved"(346110) to /home/gameserver : `steamcmd +login anonymous + force_install_dir "/home/gameserver" +workshop_download_item 346110 731604991 ` The downloaded mod items then only have to be placed in the right folder (for arkserver that would be serverfiles/ShooterGame/Mods/). **Checking for mod-updates via the steam web api** To check wether a mod has been updated, you can retreive additional information as a json string via the steam web api (see link below). Example: To retreive additional information for the Mod "Structures Plus"(731604991) for the game "ARK: Survival Evolved"(346110), send a POST-Request to `https://api.steampowered.com/ISteamRemoteStorage/GetPublishedFileDetails/v1/` containing the variables `itemcount = 1` and `publishedfileids[0] = 731604991` Result: <details> <summary>SPOILER</summary> {"response":{"result":1,"resultcount":1,"publishedfiledetails":[{"publishedfileid":"787023321","result":1,"creator":"76561198207216944","creator_app_id":346110,"consumer_app_id":346110,"filename":"","file_size":1391503,"file_url":"http://depotcontent.akamai.steamusercontent.com/staticcontent/346110/614094907/depot_346110_9170410184033285252.zip","hcontent_file":"9170410184033285252","preview_url":"https://steamuserimages-a.akamaihd.net/ugc/241333401165577293/96F98D936613B98B7703973567EB31CDB250BE16/","hcontent_preview":"241333401165577293","title":"Potions X","description":"[h1]Potions X[/h1]\r\n\r\n[b]CONTENT[/b]\r\n[list]\r\n [*]12 Special Potions\r\n[/list]\r\n\r\n[b]FEATURES[/b]\r\n\r\nInstant Potions for Players or Dinos to eighter\r\n[list]\r\n [*]Gain XP (Small/Medium/Large)\r\n [*]Recover Full Health\r\n [*]Wake Up\r\n [*]Repair Inventory Items\r\n [*]Make Hungry\r\n [*]Give Full Stamina\r\n [*]Add/Remove Speed (temporary removed)\r\n [*]High temporary Craft Speed/Skill\r\n [*]Instant Grow Hair (unlocks all hair styles)\r\n [*]More Speed (may need server restart to display value)\r\n [*]More Weight (may need server restart to display value)\r\n [*]Give Creative Mode Potion\r\n[/list]\r\n\r\nBe aware that this MOD is NOT for PVP servers, as all items cost only 1 fiber.\r\n\r\n[b]INI OPTIONS[/b]\r\n\r\n[code]\r\n[Potions]\r\nSpeedMultiplier=1.5\r\nWeightMultiplier=2\r\n[/code]\r\n\r\n[code]\r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_Healing_Potion_X.PrimalItemConsumable_Healing_Potion_X'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_Repair_Potion_X.PrimalItemConsumable_Repair_Potion_X'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_Wakeup_Potion_X.PrimalItemConsumable_Wakeup_Potion_X'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_Hunger_Potion_X.PrimalItemConsumable_Hunger_Potion_X'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_Stamina_Potion_X.PrimalItemConsumable_Stamina_Potion_X'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_XP_Potion_X_Small.PrimalItemConsumable_XP_Potion_X_Small'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_XP_Potion_X_Medium.PrimalItemConsumable_XP_Potion_X_Medium'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_XP_Potion_X_Big.PrimalItemConsumable_XP_Potion_X_Big'\" 1 0 0 \r\nCheat GiveItem \"Blueprint'/Game/Mods/jd_DinoFood/PrimalItemConsumable_Creative_Potion_X.PrimalItemConsumable_Creative_Potion_X'\" 1 0 0 \r\n[/code]\r\n\r\n[b]MOD ID:[/b]\r\n[table]\r\n [tr]\r\n [th]787023321[/th]\r\n [/tr]\r\n[/table]\r\n[i]Mod is clean and stackable[/i]\r\n\r\n\r\n[URL=http://steamcommunity.com/profiles/76561198207216944/myworkshopfiles/?p=1] / / / CHECK OUT MY OTHER MODS / / /[/URL]\r\n\r\n\r\n[b]Feel free to donate if you like my MOD! Or if you would like it to be improved[/b]\r\n[URL=https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=donate%40dubCUT%2ech&lc=CH&item_name=Game%20Modding¤cy_code=USD&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted] [IMG]https://steamuserimages-a.akamaihd.net/ugc/1795223008080556716/5C479BD03AD6F7FA449817D55790D94895F09515/[/IMG] [/url]\r\n[img]https://steamuserimages-a.akamaihd.net/ugc/1795223008080557185/AAF7511DA72CB0FA1222D38BE270436D39AE943F/[/img] \r\n\r\nThis mod/code/work is protected by the [URL=http://creativecommons.org/licenses/by-nc-nd/4.0/legalcode]Attribution-NonCommercial-NoDerivatives 4.0 International Creative Commons License.\r\n[IMG]https://steamuserimages-a.akamaihd.net/ugc/911288903790420619/58BD7FE9EA4C1F04EB98D28F912B63441E5D137A/[/IMG][/URL]\r\n\r\n[b]Thank you everyone![/b]","time_created":1477408824,"time_updated":1525279596,"visibility":0,"banned":0,"ban_reason":"","subscriptions":15888,"favorited":647,"lifetime_subscriptions":35695,"lifetime_favorited":799,"views":22459,"tags":[]}]}} </details> You can then check the `time_updated` variable to determine, when the mod has been updated the last time. Of course you can also print some of the information via the details command to provide additional insights. ## Further Reading Steam workshop example (ARK): https://steamcommunity.com/workshop/browse/?appid=346110 Steam web api documentation: https://partner.steamgames.com/doc/webapi Steam web api mod-query: https://partner.steamgames.com/doc/webapi/ISteamRemoteStorage (See GetPublishedFileDetails) Related to #2777 #1623 #2092
Sign in to join this conversation.
No labels
Atomic
Epic
cannot reproduce
command: backup
command: console
command: debug
command: details
command: fast-dl
command: install
command: mods
command: monitor
command: post-details
command: restart
command: send
command: start
command: stop
command: update
command: update-lgsm
command: validate
command: wipe
distro: AlmaLinux
distro: Arch Linux
distro: CentOS
distro: Debian
distro: Fedora
distro: RedHat
distro: Rocky Linux
distro: Ubuntu
distro: openSUSE
engine: goldsrc
engine: source
game: 7 Days to Die
game: ARMA 3
game: Ark: Survival Evolved
game: Assetto Corsa
game: Avorion
game: BATTALION: Legacy
game: Barotrauma
game: Battalion 1944
game: Battlefield 1942
game: Black Mesa: Deathmatch
game: Blade Symphony
game: Call of Duty 2
game: Call of Duty 4
game: Call of Duty: United Offensive
game: Counter-Strike 1.6
game: Counter-Strike 2
game: Counter-Strike: Global Offensive
game: Counter-Strike: Source
game: Day of Infamy
game: Dayz
game: Death Match Classic
game: Don't Starve Together
game: ET: Legacy
game: Eco
game: Factorio
game: Factorio
game: Garry's Mod
game: Half-Life
game: Hurtword
game: Insurgecy
game: Insurgecy
game: Insurgency: Sandstorm
game: Just Cause 3
game: Killing Floor
game: Killing Floor 2
game: Left 4 Dead 2
game: Minecraft
game: Minecraft Bedrock
game: Mordhau
game: Multi Theft Auto
game: Mumble
game: Natural Selection 2
game: No More Room in Hell
game: Pavlov VR
game: Post Scriptum
game: Project Zomboid
game: Quake 3
game: QuakeWorld
game: Red Orchestra: Ostfront 41-45
game: Return to Castle Wolfenstein
game: Rising World
game: Rust
game: San Andreas Multiplayer
game: Satisfactory
game: Soldat
game: Soldier of Fortune 2
game: Squad
game: Squad 44
game: Starbound
game: Stationeers
game: Sven Co-op
game: Team Fortress 2
game: Teamspeak 3
game: Teeworlds
game: Terraria
game: The Front
game: Unreal Tournament 2004
game: Unreal Tournament 3
game: Unreal Tournament 99
game: Unturned
game: Valheim
game: Wurm Unlimited
game: Zombie Master Reborn
game: label missing
good first issue
help wanted
info: alerts
info: dependency
info: docker
info: docs
info: email
info: query
info: steamcmd
info: systemd
info: tmux
info: website
info: website
needs more info
outcome: duplicate
outcome: issue resolved
outcome: issue resolved
outcome: issue unresolved
outcome: pr accepted
outcome: pr rejected
outcome: unconfirmed
outcome: wontfix
outcome: wrong forum
potential-duplicate
priority
pull-request
type: bug
type: feature
type: feature
type: feature request
type: game server request
type: refactor
waiting response
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/LinuxGSM#2372
No description provided.