Difference between revisions of "Pre-publication evaluation"

From Valve Developer Community
Jump to: navigation, search
(Excess files)
(External links)
 
(11 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 +
{{otherlang2
 +
| ru = Pre-publication_evaluation:ru}}
 
= Mods =
 
= Mods =
 
{{note|The following items are numbered to help you keep track of where you are in this process, not as an order for a specific procedure.}}
 
{{note|The following items are numbered to help you keep track of where you are in this process, not as an order for a specific procedure.}}
Line 10: Line 12:
 
# Confirm that the files required for each map are in their places.
 
# Confirm that the files required for each map are in their places.
 
# Implementation for all functionalities desired to be in ''this'' release is completed.
 
# Implementation for all functionalities desired to be in ''this'' release is completed.
# Do not distribute source folders and their containing files(mapsrc, materialsrc, modelsrc).
+
# Do not distribute source folders and their containing files (mapsrc, materialsrc, modelsrc) if your map is closed-source.
  
 
=== Multiplayer essentials ===
 
=== Multiplayer essentials ===
Line 18: Line 20:
 
=== Excess files ===
 
=== Excess files ===
 
If one of the following files or directories exist, deletion would make the mod's installation tidier.
 
If one of the following files or directories exist, deletion would make the mod's installation tidier.
 +
# <code>albedo.tga</code>
 
# <code>demoheader.tmp</code>
 
# <code>demoheader.tmp</code>
 
# <code>stats.txt</code>
 
# <code>stats.txt</code>
Line 44: Line 47:
 
# <code>maps/soundcache/*.cache</code>{{warning|Do not delete the <code>.manifest</code>s}}
 
# <code>maps/soundcache/*.cache</code>{{warning|Do not delete the <code>.manifest</code>s}}
 
# <code>DownloadLists</code> directory
 
# <code>DownloadLists</code> directory
 +
 +
==== Cleaning the mod folder with XBLAH's Modding Tool ====
 +
Before shipping the mod, the [[XBLAH's Modding Tool]] provides the modder with a list of unnecessary files, which can be removed with the push of a button.
 +
 +
This can be accessed within the tool through '''Modding > Clean'''.
 +
 +
[[File:XBLAH's Modding Tool - Modding - Clean.png|500px|frameless]]
  
 
== Refining ==
 
== Refining ==
Line 61: Line 71:
 
* When you load the map into the game, check the console to ensure there are no errors or warnings.
 
* When you load the map into the game, check the console to ensure there are no errors or warnings.
 
* Make sure you have compiled the map with Normal VIS and <code>-final</code> RAD (switch to expert compile mode and use the 'Final' preset if you don't know how to use parameters). ''Do not release a map compiled with Fast VIS or RAD!''
 
* Make sure you have compiled the map with Normal VIS and <code>-final</code> RAD (switch to expert compile mode and use the 'Final' preset if you don't know how to use parameters). ''Do not release a map compiled with Fast VIS or RAD!''
* Remember to run the [[Cubemaps|buildcubemaps]] command in the console twice before releasing your finished product, once with HDR enabled and once without, or specular reflections will not work properly.
+
* Remember to run the [[Cubemaps|buildcubemaps]] command in the console twice before releasing your finished product, once with HDR enabled and once without, or specular reflections will not work properly. {{todo|State or link to how you would do this.}}
  
 
== Distributing custom content ==
 
== Distributing custom content ==
 
If you have custom models, sounds, textures, or materials, you must either:
 
If you have custom models, sounds, textures, or materials, you must either:
  
* Bundle them into the map BSP file (using [[Using Bspzip to Embed Custom Content|Bspzip]], [[Map Analyst]], [[Pakrat]], etc.). See
+
* Bundle them into the map BSP file (using [[Using Bspzip to Embed Custom Content|Bspzip]], [[PackBSP]], [[Map Analyst]], [[Pakrat]], [[Compile Pal]], etc.). See
 
[[Using Bspzip to Embed Custom Content]], or
 
[[Using Bspzip to Embed Custom Content]], or
 
* Add a ".res" [[Map Resource File]] to your map release to let the server know there's files that should accompany the BSP when it's downloaded.
 
* Add a ".res" [[Map Resource File]] to your map release to let the server know there's files that should accompany the BSP when it's downloaded.
Line 91: Line 101:
 
=== [[Team Fortress 2]] ===
 
=== [[Team Fortress 2]] ===
 
* You should consider creating map pictures/mission briefing for the mission briefing. See [[TF2/Modifying the Mission Briefing]]
 
* You should consider creating map pictures/mission briefing for the mission briefing. See [[TF2/Modifying the Mission Briefing]]
 +
* Create a [[Maplist Thumbnails]] image.
 +
 +
= External links =
 +
 +
*[https://modding-assets.net/source/tools/modding/xblah-modding-tool/ XBLAH's Modding Tool Homepage]
  
 
[[Category:Modding]]
 
[[Category:Modding]]
 
[[category:Level Design]]
 
[[category:Level Design]]
 
[[Category:Publicity & Publication]]
 
[[Category:Publicity & Publication]]

Latest revision as of 18:33, 29 September 2021

Русский

Mods

Note.png Note: The following items are numbered to help you keep track of where you are in this process, not as an order for a specific procedure.

Essentials

  1. Confirm that the mod has been built under Release rather than Debug.
  2. Read Steam 3rd Party Mod Support.
  3. Read Customizing Options: Keyboard.
  4. Confirm that a maplist.txt file to base the shared soundcache is made and that a shared soundcache manifest is built.
  5. Delete excess files.
  6. Confirm that the files required for each map are in their places.
  7. Implementation for all functionalities desired to be in this release is completed.
  8. Do not distribute source folders and their containing files (mapsrc, materialsrc, modelsrc) if your map is closed-source.

Multiplayer essentials

  1. Create a mapcycle.txt, referenced by the default value of the mapcyclefile ConVar.
  2. Design a default MOTD, or Message of the Day, for the mod in motd.txt.

Excess files

If one of the following files or directories exist, deletion would make the mod's installation tidier.

  1. albedo.tga
  2. demoheader.tmp
  3. stats.txt
  4. textwindow_temp.html
  5. cfg\banned_user.cfg
  6. cfg\banned_ip.cfg
  7. cfg\config.cfg
    Note.png Note: You should be shipping config_default.cfg.
  8. cfg\pet.txt
  9. scripts\kb_def.lst (See Customizing Options: Keyboard)
  10. scripts\settings.scr
    Note.png Note: This should be placed in the cfg folder.
  11. bin\client.pdb
  12. bin\server.pdb
  13. Any *.db files that may have collected from image preview resources
  14. models/.../*.xbox.vtx
  15. models/.../*.xbox.vtx
  16. SAVE directory
  17. expressions directory
  18. screenshots directory
  19. reslists directory
  20. materials/maps directory
  21. materials/temp directory

Rebuildable files

These files should not be distributed in the release but will need to be rebuilt by the client.

  1. scene.cache and modelsounds.cache
  2. maps/soundcache/*.cache
    Warning.png Warning: Do not delete the .manifests
  3. DownloadLists directory

Cleaning the mod folder with XBLAH's Modding Tool

Before shipping the mod, the XBLAH's Modding Tool provides the modder with a list of unnecessary files, which can be removed with the push of a button.

This can be accessed within the tool through Modding > Clean.

XBLAH's Modding Tool - Modding - Clean.png

Refining

  1. Read VGUI2 Programming Best Practices.
  2. Encrypt weapon scripts using vice.
  3. Add documentation on mod-specific console commands and console variables.
  4. Include an icon for the mod if desired in resource\game.ico.
  5. Include the FGD for third-party mod mappers.
  6. Compile your DLL's in Release Mode, also don't forget to start Optimizing DLLs for that extra speed.
  7. Encrypt bin\client.dll with UPX

Maps

See also: Releasing a Map

Final compile

  • Examine the compile log to ensure there are no compile errors, you could also use the Interlopers Compile Checker.
  • When you load the map into the game, check the console to ensure there are no errors or warnings.
  • Make sure you have compiled the map with Normal VIS and -final RAD (switch to expert compile mode and use the 'Final' preset if you don't know how to use parameters). Do not release a map compiled with Fast VIS or RAD!
  • Remember to run the buildcubemaps command in the console twice before releasing your finished product, once with HDR enabled and once without, or specular reflections will not work properly. To do: State or link to how you would do this.

Distributing custom content

If you have custom models, sounds, textures, or materials, you must either:

Using Bspzip to Embed Custom Content, or

  • Add a ".res" Map Resource File to your map release to let the server know there's files that should accompany the BSP when it's downloaded.

If you don't do this, then anyone downloading the map through a server whilst playing will not get your custom content.

Game specific considerations

Counter-Strike: Source

  • Create a ".txt" file with the same name as the map. This text will be displayed to players when the map starts. Lines are wrapped.
  • Edit the bot Navigation Mesh so bots will behave more intelligently in your map.
  • Create a level overview material.
  • Run the map with only bots playing, 10 a side, and see whether either side has an outright advantage. There is no substitute for human players, but bots will typically show up the obvious design flaws in a map (poorly positioned meeting points, not enough entrances/exits in critical areas, and so on)

Day of Defeat: Source

  • Create a ".txt" file with the same name as the map. This text will be displayed to players when the map starts. Lines are wrapped.
  • Create a level overview material.

The Ship

  • Create a 1024x1024 material (resized from 1280x1024) vgui/map_backgrounds/map_background_<map>
  • Create a 256x128 material vgui/map_previews/map_preview_<map>
  • See The Ship: Creating a Deckplan

Team Fortress 2

External links