Portal Reloaded

Portal Reloaded

Not enough ratings
Uploading your custom map to the Portal Reloaded workshop
By Lime Reversed
Uploading your custom Portal Reloaded maps to the Portal Reloaded workshop is the most convenient way for other people to find and play them. There's no intended way to upload, but here's how to do it anyway.
   
Award
Favorite
Favorited
Unfavorite
Intro
This guide will take you through a process of uploading your custom Portal Reloaded maps so that they actually show up on the Portal Reloaded workshop. Since there seems to be tight file size limit on the uploads, I also wrote suggestions for ways to get your .bsp down in size without compromising your puzzle here: https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=3482144025 Both guides focus on Windows.

Some caveats
  • This is not an intended way to get it done, but it works.
  • You will not be able to update the .bsp file once it's uploaded. If you need to make changes on your map you will have to upload it as a new workshop item.
  • I haven't investigated how to add tags, so this guide won't work with filtering your map by tags.
Uploading your map and adding metadata
AppID for Portal Reloaded = 1255980

You will need
SteamCMD
This is an official Vale app for issuing Steam command lines.

SteamChangePreview[github.com]
This is a custom solution by TechnologicNick to change the preview image for your workshop item.

How to upload your map
TLDR;
Upload by using the following command in SteamCMD:
workshop_create_legacy_item 1255980 localPathToYourBsp

Here's how to get there step by step
  1. Dowload StreamCMD
  2. Unzip the content to a convenient location.
  3. Run steamcmd.exe (It will create some files at first start)
  4. Login by entering this:
    login yourSteamUsername yourSteamPassword
  5. Enter your 2FA code, if it asks you for one.
  6. Upload by entering this:
    workshop_create_legacy_item 1255980 localPathToYourBsp
    Like this:
    1255980 is the appID for Portal Reloaded

  7. On success it should give you a publishedFileID, which will be useful later.

You should now find the map on Steam under Your profile -> Workshop Items. You will notice that it's categorized under Portal Reloaded. However, you will also notice that 1. There are no images, no description, and the title is just the name of the file. 2. The item is automatically set to public.

Changing the metadata
This guide assumes that you are already familiar with changing title, description, visibility, adding images and anything else available through the workshop item page here:


What we can't change on the workshop item page is the preview image, and the tags. I have not figured out how to add tags, but there is a way to change the preview image.

Changing the preview image
!Important SteamChangePreview expects you to be logged in on your Steam app, on the same machine. When you ran SteamCMD you were most likely logged out of the Steam app even if it doesn't look like it. Exit both SteamCMD and Steam, then start Steam again. Steam might ask you to re-login. Now we are ready to run SteamChangePreview!

Download SteamChangePreview[github.com], unzip, then follow the instructions when running SteamChangePreview.exe. It will ask you for path to your preview image, publishedFileID and appID. The publishedFileID was given when you uploaded the .bsp, you can also find it in the URL of the workshop item. For example: "https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=3481671189" tells us that the publishedFileID for this item is 3481671189. Read more about how SteamChangePreview.exe works here[github.com]

Now your .bsp should be uploaded to the Portal Reloaded workshop complete with title, description, images and preview image.

Troubleshooting
Preview image doesn't upload
Most likely it's the file format or file size. I used a .jpg that is 132kb and 480px x 270px. I think a preview is recommended to be 512 x 512, and I think it can be a .png.

If that doesn't work then make sure that you are logged in to Steam via the Steam app on the same computer, not via a browser or SteamCMD.

It says "Limit exceeded" when I try uploading the map
There seems to be a 10mb limit. Sometimes it even refuses a .bsp that is below 10mb, and I cannot explain why. My best guess is that it has to do with Steam not calculating the size correctly.

Since the limit is low I also wrote a guide about tips on how to get your .bsp down in file size without compromising your puzzle. I got mine down from 25mb to 9mb without changing anything about the puzzle. Find the guide here: https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=3482144025
My public map shows up under workshop items via my profile, but still is not visible alongside the other maps on the workshop
Sometimes it take a little while for it to actually show. If that's not it then it could be the filtering. Since we never added any tags the map will get filtered out just by checking "Singleplayer", which is not ideal but better than nothing.