Quake Live

Quake Live

106 ratings
Uploading & Using Steam Workshop for QuakeLive
By Yakumo
How to upload Steam Workshop content for QuakeLive
2
   
Award
Favorite
Favorited
Unfavorite
Uploading your content
First of all, you shouldn't use the Steam Workshop to upload content that you did not create yourself! Do not upload other people's maps/models/textures etc please.
Prepare SteamCMD
  • Download SteamCMD from https://steamcdn-a.akamaihd.net/client/installer/steamcmd.zip , unzip it to it's own folder, I'm using c:steamCMD
  • Run (using your Steam username and password):
    c:steamCMDsteamcmd.exe +login myLoginName myPassword
  • SteamCMD will set up and you will probably have to authorise it through SteamGuard.
Prepare Content
Create a folder to hold your workshop item, I'm going to do that within another folder in case I work on multiple projects. And add workshop project folder for uploading a map pk3 (it doesn't have to be a map, it could be other things, or multiple maps).

C:WorkShopItemsmyMap

You should place your preview image and the VDF file (described later) that will manage uploading here, eg C:WorkShopItemsmyMapmyPreview.jpg

One more folder is needed to hold the actual content, everything within this folder gets uploaded to Steam, and subsequently downloaded by anyone that subscribes to your workshop, this is why you do not put your preview image into this folder.
The root of the content folder will be considered as the QuakeLive baseq3 folder, but steam actually stores installed workshop items within C:SteamSteamAppsworkshopcontent<ItemID>

C:WorkShopItemsmyMapcontent

If your map or other content is in .pk3 form (just .zip renamed) your map pk3 file will go into that folder.
If you are working with .pk3 files, there should NOT be a 'baseq3' folder within the .pk3.

If your map/content is NOT in pk3 form for uploading then within your 'content' folder create 'baseq3' and put all the files you wish to upload in there.

C:WorkShopItemsmyMapcontentmyMap.pk3


NB. if you are attempting to include 'autoexec.cfg' it appears they will not be run at all from within workshop content. You can work arround this with javascript files in a "js" folder.
eg.
nohmg.js containing -
qz_instance.SetCvar("g_startingAmmo_hmg", "0");
Prepare VDF file
Create a plain text file with the extension vdf in your project folder, NOT the 'content' folder.
eg mynewmap.vdf

"workshopitem" { "appid" "282440" "publishedfileid" "0" "contentfolder" "C:\WorkShopItems\myMap\content\" "previewfile" "C:\WorkShopItems\myMap\preview.jpg" "visibility" "0" "title" "My Amazing Map" "description" "An amazing new map for Quake Live" "changenote" "Initial Release" }

  • The "appid" given here is the correct one for Quake Live.
  • The "publishedfileid" must be left at "0" the first time you try to upload your item, steamCMD will then fill this in for you so you can then use the same VDF file to update your workshop item later.
  • Edit the "contentfolder" and "previewfile" fields to point to the correct locations for your project.
  • Edit "title", "description", "changenote" as you wish.
  • Visibility 0 is PUBLIC, 1 is Friends Only, 2 is HIDDEN
Preview Image Note
The most likely reason for your upload to fail is the preview image, there has to be one, and it must be within their current file size limits (1mb I think, can't currently find an official note on it), and a web friendly format (JPEG or PNG)
Run steamCMD to upload
c:\steamCMD\steamcmd.exe +login myLoginName myPassword +workshop_build_item C:\WorkShopItems\myMap\myMap.vdf +quit

Run the above command (this is all one line) substituting in your Steam login name and password, and that should be all you need to do.

You can then go to Community -> Workshop in Steam, and check out the workshop items you have uploaded, from there you can edit their Title, Description and Visibility (Only you, Public, Friends only).

If you ever change the contents of your item and want to update it, just run the same command again as SteamCMD will have updated the vdf with the correct publishedfileid.
Check your content
You can check your content under

<YourUserName> steam menu -> content -> then the 'Workshop Items' tab near the top,

or under - COMMUNITY steam menu -> Workshop, then on the right hand side underneath the image block there's a section labled "Your Workshop Files" with a link underneath you can click.

If your changes aren't showing up, it's probably because steamCMD has caused your steam.exe to log out but it's not realised yet, so exit Steam completely and then run it again.
Using Workshop Items For Players
To use Workshop content just subscribe to it, and follow any extra instructions in the description on the item's home page.

[Dedicated server admins instead add the workshop id to workshop.txt following the instructions earlier in this guide.]

All Steam Workshop content will download as 'Quake Live - Workshop Content', the Steam download center won't list individual subscriptions just which game the download is for. If it's not downloaded then restarting steam usually makes that happen immediately.

For example the official 'Quake Live Extras Pack' by Sponge, containing several maps:

Subscribe to the Workshop item, check your download center to see the download complete.
If there's been no download activity, restart Steam.
Run Quake Live.

To use the maps Play -> Start a mach, and select the map under 'Current Arena' then play offline or start an internet server.

For those who wish to use the console instead:
\map bloodrunblue duel \map campgroundsblue ffa

Optionally, to run as a listen server at any time set:
\sv_serverType 2
0 offline, 1 LAN, 2 Internet
Port 27960 (or your set net_port) would need to be forwarded on your router for people on the internet to be able to connect. By default your machine will stay offline however,

Otherwise you'll have to find an online server already running the workshop for you :o)

If a server is already running Workshop content, you should download it automatically when you connect.
82 Comments
CZghost 9 Mar, 2024 @ 5:49am 
I can't use powershell, or maybe even command line, since my password contains some control characters I need to escape before continuing and the steamcmd command line doesn't like it. It also doesn't like arguments enclosed with double quotes, and I don't think this is okay. I have to run the steamcmd barebone and then use the commands inside it. Oh well.
CZghost 9 Mar, 2024 @ 5:43am 
Alright, I figured it out, I had to simply install Steam library and I found out that I need to escape any double quotes that are part of the arguments. But I can't log in from command line: https://czghost.is-a-virg.in/6uoin1nr0.png
CZghost 9 Mar, 2024 @ 5:24am 
How do I run the setup? I've added the installation path of steamcmd into my system environment path, and I'm trying to init it: https://czghost.is-a-virg.in/6uodDhT33.png
CZghost 9 Mar, 2024 @ 2:09am 
Thanks, I was looking for this and Google wasn't helpful much. I suppose this could be applied to any game, right?
ikevA 20 Oct, 2023 @ 8:37pm 
Fixed. They have modified the preview image size limit :D
ikevA 19 Oct, 2023 @ 9:15am 
Just comment that now the upload of the workshop item ends with the following error message.

Uploading content...ERROR! Failed to update workshop item (Limit exceeded).

Even reducing the pk3 size to 100KB.
(tested with several accounts)
ikevA 1 Oct, 2023 @ 3:25am 
First of all, thank you for the guide and apologize for English level.

I have managed to upload the workshop items correctly by following the instructions, but for a couple of days, when running the command, steamCMD shows the following error message.

ERROR! Failed to load build config file "C:\WorkShopItems\myMap\myMap.vdf".

The only change in the vdf file is a 0 in the publishedfileid field, to create a new worksteam item, like other times uploaded sucessfully.
I have tried to upload the pk3 which is currently working but it shows the same error message.
We have also tested with other accounts to rule out that it is a space/workshop items limit per user problem.

Can anyone confirm if this is a general Steam error when uploading workshop items for Quake Live (appid 282440)?
1v4n94 28 Nov, 2018 @ 8:29pm 
Thanks for creating this guide, buddy. Much appreciated! :D
^4ρσяи^1ѕ^4тαя 25 Nov, 2018 @ 4:54am 
BIG thanks for all help and info, yes I use the external pictureviewer. I maby prefer that so don´t dig to much into the previw thing (if you aren´t inteerested youreslf) The big "howto" s is clear to me now. Thanks. All ppl who has loved and played QuakeLive should collect some money to a big christmas present to Yakumo for all help he given all this years! <3
Yakumo  [author] 25 Nov, 2018 @ 3:42am 
I need to fnd out how to add multiple screenshots in a vdf actually, in the mean time you'd have to use the 'Add/edit images & videos' button on the workshop item afterwards instead.