[GUIDE] How to Release Your Map

Discussion in 'Tutorials & Resources' started by tyler, Aug 22, 2015.

  1. tyler

    aa tyler snail prince, master of a ruined tower

    Messages:
    5,035
    Positive Ratings:
    4,499
    1. Preparing Your Map For Compiling
    • Make sure your map's filename is all lowercase and has a meaningful version number before you prepare to compile, like pl_mymap_a1. Numbers like _v1, _v5, or _v20 aren't meaningful because players don't know what stage the map is at from the filename. Use _a1, _a2, etc for alphas (no detailing, just dev brushes, for versions where the layout will change), _b1, _b2, etc for betas (detailed, mostly complete, fine tuning stage) and _rc1, _rc2, etc for release candidates (maps so polished they would fit in among Valve maps). Crash has a good video about this if it's unclear. You shouldn't change this after compiling!

    • Do you have at least one cubemap entity for an alpha, and at least a few more for beta?

    • Make sure all the visgroups you need to compile your map are enabled. Check for tool textures, brush textures, lights, etc.

    • Press Alt+P in Hammer and check for errors. You can ignore the "No player start" error and the ones about overlays having unused keyvalues (the latter can be fixed automatically if you want).

    • Compile a BSP only version and don't run the game so you can double check for leaks or other errors. Remember that it is OK to ignore the error regarding cubemaps in the compile log!

    • If everything looks good, compile a fast VVIS/VRAD version and check to make sure all your logic works and your lighting is functional. You can use the cheat thirdperson to run around and make sure you can tell team colors in all areas.

    • Compile a release version with regular settings! For alphas and even some betas, you can skip HDR entirely. Make sure if you do compile with HDR, you go back in game and play with the tonemap controller and the bloom settings. Don't blind anyone, please!

    2. Preparing Your Map For Release
    • Now that you have a working map in game, it's time to build cubemaps. If you're doing HDR cubemaps, remember to do them first. Only build cubemaps once!

    • If you used any custom content in your map--like models or textures you created yourself, or downloaded from TF2maps.net or elsewhere--you need to pack that content into the map or other players won't see it. VIDE is the standard. If you generated a nav_mesh at any point, do not pack it as it can cause crashes.

    • Make sure you packed your content right! Open TF2 and in the console type sv_pure 2, then load your map with map pl_mymap_a1. If you see any missing textures or models, you have not packed correctly.

    • Repack your BSP for distribution. After this is complete, you do not need to zip it in any way.

    3. Releasing Your Map on TF2maps.net
    • Take screenshots so people can see your work and get excited! Disable your FPS config and crank up the settings as far as your computer can take them. I like to use spectator, but you can also run around in game to take your screenshots. Remember to remove the HUD and weapon model first (cl_drawhud 0 and r_drawviewmodel 0 respectively and remember to turn viewmodels back on unless you use spec!).

    • Upload your map to the Downloads section.
      • Click the "Add Download" button in the top right and choose a category for your map.

      • The title should be your map's name, not the filename. So if your map is cp_gorge, your title is simply Gorge. The tag line can be used for whatever you want. You can edit this stuff later!

      • You can upload your bsp file directly, or link to an offsite download.

      • Fill in the description and pick some nice images to upload! Generally, you want to show off the major areas or control points and maybe an overview shot.

      • Make sure "Upload Download Icon" box is checked and hit "Save" when everything looks good. It will prompt you to add a thumbnail image. A good fit for this would be an interesting control point, or an overview shot, for example.

      • Done! You now have a functioning map resource page, and a thread in the Map Workshop forum! Any time you need to update your map, simply click "Update Download" on your download page.

    4. What's Next?
    • Watch the Events subforum for Game Day announcement threads. They get posted usually the day before, and typically the host of the Game Day has a weekly schedule, so it shouldn't be hard to figure out. The threads are usually announced via the TF2M Steam Group too.

    • Hang out in our Steam Chat (linked from the TF2M home page or from the Steam group page) and wait for impromptu tests, or "imps" as we typically call them. There're usually 1 or 2 a day, spread across the US and EU servers. There are also announcements via the Steam Group, so you can sometimes join a test and get your map thrown on the end even when you weren't in chat.

    • There is a feedback plugin on the servers that we use to collect feedback and deliver gameplay recordings (demos). You can view the hub for that here. Recently tested maps are at the top, so you should have no issue finding the feedback for your map. Think on it, iterate, and repeat!

    That's pretty much it. Let me know if I missed anything/etc!
     
    • Thanks Thanks x 32
    Last edited: Sep 1, 2016
  2. KubeKing

    Server Staff KubeKing Soon it will be different

    Messages:
    1,272
    Positive Ratings:
    1,601
    Great all-inclusive guide, tyler!
     
  3. Yellow

    Yellow L1: Registered

    Messages:
    25
    Positive Ratings:
    16
    Impressive guide, will help alot to release things later on. Really appreciate it :3
     
  4. Anreol

    Anreol L6: Sharp Member

    Messages:
    262
    Positive Ratings:
    273
    I never know what to do when I "finish" a map (For A1 and ready to test)
    For example, I never set cubemaps in alpha
    Thanks
     
  5. Pocket

    aa Pocket func_croc

    Messages:
    4,489
    Positive Ratings:
    2,377
    Now that the Map Workshop is a thing, isn't the proper procedure now to just dispense with suffixes once you get out of beta, or even into it? Or is that still being ironed out?
     
  6. MaccyF

    aa MaccyF Notoriously Unreliable

    Messages:
    918
    Positive Ratings:
    1,479
    whats stopping you keeping the suffixes in the maps name? The workshop doesn't display them does it, and when you update a submission i don't think the bsp has to have the exact same name.
     
  7. Pocket

    aa Pocket func_croc

    Messages:
    4,489
    Positive Ratings:
    2,377
    I thought it did. I thought that was the whole point; when you update a map that's on the workshop, it replaces the copy people have with the new one so why wouldn't it be the same name?
     
  8. Crash

    aa Crash func_nerd

    Messages:
    3,192
    Positive Ratings:
    5,021
    So few servers are running maps through the Workshop (as it's still in beta) not iterating your map names at this point is just going to limit your audience. Give it some time and maybe it'll be worth it, but as of now, I'm iterating.
     
    • Thanks Thanks x 1
  9. MaccyF

    aa MaccyF Notoriously Unreliable

    Messages:
    918
    Positive Ratings:
    1,479
    As far as i know the workshop uses an ID number to determine which map is being played - not the bsp's name
     
  10. tyler

    aa tyler snail prince, master of a ruined tower

    Messages:
    5,035
    Positive Ratings:
    4,499
    Yeah, the workshop uses an ID number anyway and it's really unintuitive to use, plus then you'd be compiling two versions and that's just a huge waste of time. I don't really agree with people putting alphas on the Workshop anyway because you can't alert people when it's been updated. You can either delete and reupload your submission every time and hope it gets more popular with each new upload, or just wait until it's finished. It's not like the Workshop is a great place for feedback or something anyway--it's for RC level maps.
     
  11. takabuschik

    aa takabuschik

    Messages:
    663
    Positive Ratings:
    332
    So in order to release a map for both tf2maps and the steam workshop, the proper procedure is to compile the full version of your alpha/beta map, pack, cubemaps etc, add that version to tf2maps, then copy the .vmf, rename it w/o the suffixes, full compile, pack, cubemaps, then upload to the workshop? that's a lot of work, and might take more than a day on beta maps.
     
  12. tyler

    aa tyler snail prince, master of a ruined tower

    Messages:
    5,035
    Positive Ratings:
    4,499
    I would say if you're uploading for the workshop, compile your map as cp_mymap_rc2 or whatever and put it on the Workshop first, then download that copy and use it to replace yours for uploading to TF2M and other sites. That way the bsp is repacked once and you avoid potential mismatched file errors.

    I see lots of users just saying "Go to this folder and copy the bsp to tf/maps" so they don't have to mess with the file ID number, so I think that's the best way. When the forums switch over I suppose I'll add something about this too.
     
  13. takabuschik

    aa takabuschik

    Messages:
    663
    Positive Ratings:
    332
    So I should not use the id system (which IDK how it works anyway) and stick with the standard naming (a4, b5 etc) for the workshop as well?
    How would that work with releasing new versions of the map? would it be possible to pass on the ratings?
     
  14. Crash

    aa Crash func_nerd

    Messages:
    3,192
    Positive Ratings:
    5,021
    You can update your map via the in game workshop tools regardless of the file name.
     
  15. tyler

    aa tyler snail prince, master of a ruined tower

    Messages:
    5,035
    Positive Ratings:
    4,499
    Crash is correct. The workshop removes your rc1 from subscribers' computers and puts your rc2 in its place. The ID system means server owners don't need to update a map list if they run workshop maps. So you should be versioning and releasing maps the same way as always.
     
  16. takabuschik

    aa takabuschik

    Messages:
    663
    Positive Ratings:
    332
    Oh that's nice. Thanks for the information!
     
  17. tyler

    aa tyler snail prince, master of a ruined tower

    Messages:
    5,035
    Positive Ratings:
    4,499
    Just updated this to reflect the new system. Let me know if anything needs to be adjusted.
     
  18. Mikroscopic

    aa Mikroscopic

    Messages:
    617
    Positive Ratings:
    633
    Whenever I try to load my map with sv_pure 2, the game crashes and says "failed to lock vetex buffer in CMeshDX8::LockVertexBuffer: nVertexCount=2204, nFirstVertex=0"

    Did I pack content incorrectly?
     
  19. tyler

    aa tyler snail prince, master of a ruined tower

    Messages:
    5,035
    Positive Ratings:
    4,499
    Try verifying your game files. That error is usually related to a corrupted model mesh of some kind or another and can happen to all Source engine games for various reasons. Hopefully it isn't more complicated than that.
     
  20. Mikroscopic

    aa Mikroscopic

    Messages:
    617
    Positive Ratings:
    633
    Verified my files, tried repacking all of the content as well. Still crashes.