Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
help:how_to_package_and_release_a_file [2020/02/20 17:51] – [Text file] human[rus]help:how_to_package_and_release_a_file [2023/02/14 16:47] (current) – [Hosting] Spirit
Line 1: Line 1:
 ===== How to package and release a file ===== ===== How to package and release a file =====
 +
 +dumptruck_ds made a [[https://www.youtube.com/watch?v=C-NGjpa8iYM|video]] explaining a lot of what is written down here. If you prefer video formats to written text, consider giving it a view. This page will probably be more up-to-date and "canonical" though.
  
 ==== Naming ==== ==== Naming ====
-Early autumn 
-=== Map === 
- autumn_sp.bsp - Early autumn Single Player 
  
-http://wdfiles.ru/j30U+=== Maps === 
 +Pick a good filename for your .bsp file. People commonly use their nicknames and a counter or try to find a good short word describing the map. Adding a "sp" or "dm" or "ctf" bit to the name helps indicating the intended gamemode. If you decide for a "boring" numbering scheme and you also release maps for other games, you might want to stick a "q1" in there as well.
  
-{{:help:2020-02-19-23-18-49.png?400|}} +Alternatively just name it after the map's actual name.
-==== Text file ==== +
-my nick name in quake: human[rus]+
  
-You must add a text file to your release, documenting at least the title of the work and your (nick)namecreate date: 20-20-2020+Don't forget to set the title field in the .bsp file to something useful.
  
-================================================================ +=== Mods === 
-BASE FILE FOR CUSTOM LEVELS+For mods the standard seems to be a more descriptive filename. Usually it is a short form of the mod's title. If it is a mod just supporting one map (so it's more of a map than a mod) the map naming suggestions above apply though.
  
-Title                       : Early autumn +=== Examples of good naming schemes === 
-Filename                : autumn_sp.bsp +  * efdatsp1.bsp - The Place of Dismay by efdat, full nickname since it is short & sp & number 
-Author(s)                : human[rus] aka lotric +  * chessp1.bsp - Shrine of Skank by cheshire, abbreviated nickname & sp & number 
-Email Address          : qwxprc@mail.ru  +  * ikspq1.bsp - Before Nightfall by Iikka "Fingers" Keränen, abbreviated/acronym nickname & q & sp & number 
-Description                : singleplayer map+  * ac.bsp - Adamantine Cruelty by Vondur, acronym of the level title 
 +  * ant.bsp - Antediluvian by metlslime, abbreviated title 
 +  * cogs.bsp - Cogs Of Conflict by spd, a single prominent word from the title
  
 +=== General considerations ===
 +Be aware that filenames longer than 8 characters will be a pain to use on DOS. So if you are a nice person, find a short one. It will also be nicer to type (if the user's engine does not support tab completion).
  
-==============================================================+Avoid any characters that are not a-z or 0-9. A single dash - might be ok. Quake engines do not handle international keyboard layouts well. Do not use uppercase characters for any files.
  
-Single Player           : yes +Before you settle, search the web for the name and make sure it is not already used.
-Cooperative 1-32 Player :  yes +
-Deathmatch 2-32 Player  :  no +
-.map   Included         : yes+
  
-Software needed to play : quake +==== Text file ==== 
-Comments                : the first map on this editorjust freestyle mapping+You should add a text file to your release, documenting at least the title of the work and your (nick)name. You should also include a release name, the intended purpose, contact details, release date and the like. Without this, your file(s) might be lost in "who on earth made this and when and why?!" limbo.
  
-* Construction *+Best practice would be using the good old base.txt template: [[/files/idgames2/levels/base.txt]]
  
 +Name the text file exactly like your zip file and/or your bsp file and/or your mod directory! For example the readme file for abc123.bsp would be abc123.txt. For the mod qwe456/ the readme file would be named qwe456.txt and placed into qwe456/ : qwe456/qwe456.txt!
  
-Build Time   :  one month +If you name your text file readme.txt, it will conflict with everyone else's same-named file and no one wants to overwrite other people'files.
-Times & stats   :System Used      :   ericw-tools-v0.18.1-Linux             +
-Editor(s) used  : trenchbroom 2019v6 Valve mode +
  
 +If you have creativity oozing out your pores, well, some mappers include short background stories too.
  
 ==== Packaging ==== ==== Packaging ====
Line 53: Line 51:
  
 ==== Hosting ==== ==== Hosting ====
-If it is a finished workyou can contact [[quaddicted.com:Spirit]] to get it hosted at Quaddicted. Feel free to mail it straightaway.+Upload the final archive to https://archive.org/ or http://www.quaketastic.com/ . The password for uploading at QuakeTastic is "ZigguratVertigoBlewTronynsSocksOff"the username "quaketastic". Then paste it in [[https://www.quaddicted.com/forum/viewtopic.php?id=636|the forum thread]], following the description in the first post. The file will be uploaded to Quaddicted then and at some point also appear in the [[/reviews/index.php|database]]. 
 + 
 +Do not use services that do not support direct download links. And please do not use volatile hosts like Dropbox, Google Drive or any ad-ridden free hosting providers. We would not be here if people had done that in the pastThanks!
  
-If that is not an option, if it is a work-in-progress, you do not want to wait a week before Spirit replies (though he is quick if you packaged everything well and send a direct HTTP link to the fileor otherwise you want to host elsewhere, http://www.quaketastic.com/ is there for youThe password for uploading is "ZigguratVertigoBlewTronynsSocksOff", the username "quaketastic".+==== Quaddicted's database ==== 
 +The database of singleplayer Quake maps (and some modsat https://www.quaddicted.com/reviews/ was designed on a per-file level. Each entry or page available there is describing a specific fileThere is no process for replacing a file with a different version or to link different versions with more than a plain hyperlink.
  
-For permanent hosting you can also freely use https://archive.org/.+This means that e.g. three different versions of a thing become three separate entries in the database. This allows external tools like the [[tools:quake_injector|Quake Injector]] to work without errors and to make sure that ratings, comments, tags, demos, etc are linked to the specific version they describe. But this also means that releases which only add minor bugfixes are separate from the community interaction which might have previously happened on the initially released version. Testing your releases well before publicly releasing them is highly recommended so you can avoid having to publish updatesYou can always find people interested in testing your works by asking in [[/forum/|our]] or other forums.
  
-Do not use services that do not support direct download linksAnd please do not use volatile hosts like DropboxGoogle Drive or any ad-financed free hosting providers.+[[/forum/viewtopic.php?id=622|Help on building a better system is highly welcome]]as always.