ofp:howtorelease
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
ofp:howtorelease [2007-07-14 00:33] snakeman added screenshots info |
ofp:howtorelease [2009-04-16 09:36] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== How To Release ====== | ====== How To Release ====== | ||
| - | //Note: this insert is from WrpTool's manual and is focused on islands, but you can learn and adapt this to your Addon instead (if it happens not to be addon).// | + | //Note: this insert is from [[ofp:tools:wrptool|WrpTool]]'s manual and is focused on islands, but you can learn and adapt this to your Addon instead (if it happens not to be island what you're releasing).// |
| Okay so now you're at that point where all those sleepless hours are behind, the addon has been built to that point that it looks nice, your config.cpp has been all setup along with at least one nice background menu cutscene. So now you are looking for the release of this addon... how to do it? | Okay so now you're at that point where all those sleepless hours are behind, the addon has been built to that point that it looks nice, your config.cpp has been all setup along with at least one nice background menu cutscene. So now you are looking for the release of this addon... how to do it? | ||
| - | **Included Addons** | + | |
| + | ====== Included Addons ====== | ||
| Many people these days use the Agent Smith Industrial, Harbor kit or MapFact Baracken addon buildings in their islands. These make quite nice additions to the default BIS objects and saves tons of time for island maker compared to him starting to do his own models and textures for such buildings. | Many people these days use the Agent Smith Industrial, Harbor kit or MapFact Baracken addon buildings in their islands. These make quite nice additions to the default BIS objects and saves tons of time for island maker compared to him starting to do his own models and textures for such buildings. | ||
| Line 11: | Line 12: | ||
| But then comes the question, should these addons be added into the island pbo or just be required for the island to work. Well its WrpTool Development Team's opinion that none of the addons should **NOT BE ADDED** into the island pbo/release itself since these addons are already released and available from internet. If they are added they just increase the download size and its good possibility that the user who downloads the island already has these addons installed normally, so it is not a good solution to "hardcode" them into your island pbo. Just let the users know that the island requires these addons and they need to be installed. | But then comes the question, should these addons be added into the island pbo or just be required for the island to work. Well its WrpTool Development Team's opinion that none of the addons should **NOT BE ADDED** into the island pbo/release itself since these addons are already released and available from internet. If they are added they just increase the download size and its good possibility that the user who downloads the island already has these addons installed normally, so it is not a good solution to "hardcode" them into your island pbo. Just let the users know that the island requires these addons and they need to be installed. | ||
| - | **Objects and Textures** | + | |
| + | ====== Objects and Textures ====== | ||
| If your island uses objects and textures from other islands like the very common usage of SEB NAM Pack 2 stuff, then it is essential that you DO NOT ADD the sebnam_obj.pbo into your island release. We cannot address this enough as it is so obvious, do not do it, it makes you and your mod/team look like fools if a mistake like this is done for your release. SEB NAM Pack 2 has been released and it's available on most sites so there is no reason why anybody could not get their hands on it. By leaving it out you not only decrease the download size, you also avoid the conflict which comes from your sebnam_obj and the official one, unless yours is just going to overwrite it. | If your island uses objects and textures from other islands like the very common usage of SEB NAM Pack 2 stuff, then it is essential that you DO NOT ADD the sebnam_obj.pbo into your island release. We cannot address this enough as it is so obvious, do not do it, it makes you and your mod/team look like fools if a mistake like this is done for your release. SEB NAM Pack 2 has been released and it's available on most sites so there is no reason why anybody could not get their hands on it. By leaving it out you not only decrease the download size, you also avoid the conflict which comes from your sebnam_obj and the official one, unless yours is just going to overwrite it. | ||
| Line 17: | Line 19: | ||
| Same applies for the quiet release of Ebud’s iloilo_obj.pbo which has some type of jungle objects and textures; this original pbo (we think) has a big TARGA (tga) file inside it, its 1mb in size which increases the download size for absolutely no reason. If you want your island to be jungle/NAM theme, please stick with the official objects and textures of SEB NAM Pack 2, you can do wonders with them and this way you do not need to use iloilo with the tga inside it. | Same applies for the quiet release of Ebud’s iloilo_obj.pbo which has some type of jungle objects and textures; this original pbo (we think) has a big TARGA (tga) file inside it, its 1mb in size which increases the download size for absolutely no reason. If you want your island to be jungle/NAM theme, please stick with the official objects and textures of SEB NAM Pack 2, you can do wonders with them and this way you do not need to use iloilo with the tga inside it. | ||
| - | **Clean out temporary files** | + | |
| + | ====== Clean out temporary files ====== | ||
| When you are developing an addon there can be all kinds of temporary files laying around in your work dir. It is very important that you make sure that none of these unusable temporary or shall we call them leftover files gets into the release pbo package because they only increase the download size, but look bad for anyone willing to take a look inside your pbo. | When you are developing an addon there can be all kinds of temporary files laying around in your work dir. It is very important that you make sure that none of these unusable temporary or shall we call them leftover files gets into the release pbo package because they only increase the download size, but look bad for anyone willing to take a look inside your pbo. | ||
| Line 23: | Line 26: | ||
| Good rule of thumb is that the addon pbo should not contain anything not used in the addon in one way or the other. Of course you might have objects and textures in different pbo's but you'll get our point here, when you release; only put out the files used in the item you are releasing. Make sure no leftover TGA or Thumbs.db files for example are laying around in some subdirs etc. Be careful with this one. | Good rule of thumb is that the addon pbo should not contain anything not used in the addon in one way or the other. Of course you might have objects and textures in different pbo's but you'll get our point here, when you release; only put out the files used in the item you are releasing. Make sure no leftover TGA or Thumbs.db files for example are laying around in some subdirs etc. Be careful with this one. | ||
| - | **RAR, ZIP or EXE** | ||
| - | The final release package format is very important. The most common would be a pkzip archive format, it's been used for ages and everyone knows it these days. You can leech latest winzip from [[http://www.winzip.com/|winzip]] web page. | + | ====== Readme Text ====== |
| - | + | ||
| - | There is also the BIS suggested AAE system, **Addons At Ease**. Well we are so blunt and call it stupid. Yep, we bas BIS, eek shame on us! No seriously, the AAE is stupid because it uses the microsoft MSI install system, you need to leech some lame installer to even make the AAE .msi packets to be opened. Stay away from it, even if its BIS endorsed stuff. This is of course only our opinion, but you can judge from yourself by looking at the OFP scene and count how many releases there are with and without AAE system. | + | |
| - | + | ||
| - | Then there is the worst choice you can do and that is installshield installer or some other installer which asks the user to place where to install and adds the “software” into the windows programs menu etc. Stay away from this kind of crap as it’s definitely not suitable for OFP addon installing by any means. Not only it strays possible users away from your release but it’s a pain to use for those who choose to install it as most likely they remove/etc the addon files that makes the installshield not capable of uninstalling it anymore. | + | |
| - | + | ||
| - | Then there is the RAR utility. There are some older versions but everyone should first go to [[http://www.rarlabs.com/|rar homepage]] and download latest winrar to get his rar up to date. Now somebody goes, eeww, rar what is that I never heard of it before? Well here the newsflash for you buddy, RAR is capable of opening zips and lot of other archives and more importantly it compresses the files much better than WinZip. You'll save tons of download size by choosing RAR for the packaging method for your island release. Do a comparison if you don't believe us. RAR is great. | + | |
| - | + | ||
| - | **Readme Text** | + | |
| It is very very important that you include decent readme.txt into your addon release. This text file should be written with notepad or similar text editor that any kind of editor can open and read. | It is very very important that you include decent readme.txt into your addon release. This text file should be written with notepad or similar text editor that any kind of editor can open and read. | ||
| Line 46: | Line 40: | ||
| With that stuff you should have covered all the basic information what possible addon looking users are interested to know. Add the readme inside the rar packet but also if possible make it available on forum post or a web page. | With that stuff you should have covered all the basic information what possible addon looking users are interested to know. Add the readme inside the rar packet but also if possible make it available on forum post or a web page. | ||
| - | You know… a good release is half of the addon quality and word spreads quickly over the internet if certain release has been goofed up. Make the effort to give your addon a good quality all around, not just the addon itself. It's worth it on the long run. | + | You know... a good release is half of the addon quality and word spreads quickly over the internet if certain release has been goofed up. Make the effort to give your addon a good quality all around, not just the addon itself. It's worth it on the long run. |
| - | **Screenshots** | + | |
| + | ====== File Name ====== | ||
| + | |||
| + | First of all, **//do not never ever use spaces in file names//**. | ||
| + | |||
| + | Please give the release a file name which itself describes the released product. Do not release "Iraq.rar" as that is so lame you lose all credibility when someone starting to download sees the file name. If you have a tag, start with that, then add the release name, then version number. For example. | ||
| + | |||
| + | <tag>_<release>_<version>.rar | ||
| + | |||
| + | PMC_IraqTerrain_v0.1.rar | ||
| + | |||
| + | When you name it like this, anyone seeing that file months from now in some directory, immediately knows that ah-ha, its PMC's Iraqi Terrain the first version. | ||
| + | |||
| + | |||
| + | ====== RAR, ZIP or EXE ====== | ||
| + | |||
| + | The final release package format is very important. The most common would be a pkzip archive format, it's been used for ages and everyone knows it these days. You can leech latest winzip from [[http://www.winzip.com/|winzip]] web page. | ||
| + | |||
| + | There is also the BIS suggested AAE system, **Addons At Ease**. Well we are so blunt and call it stupid. Yep, we bas BIS, eek shame on us! No seriously, the AAE is stupid because it uses the microsoft MSI install system, you need to leech some lame installer to even make the AAE .msi packets to be opened. Stay away from it, even if its BIS endorsed stuff. This is of course only our opinion, but you can judge from yourself by looking at the OFP scene and count how many releases there are with and without AAE system. | ||
| + | |||
| + | Then there is the worst choice you can do and that is installshield installer or some other installer which asks the user to place where to install and adds the “software” into the windows programs menu etc. Stay away from this kind of crap as it’s definitely not suitable for OFP addon installing by any means. Not only it strays possible users away from your release but it’s a pain to use for those who choose to install it as most likely they remove/etc the addon files that makes the installshield not capable of uninstalling it anymore. | ||
| + | |||
| + | Then there is the RAR utility. There are some older versions but everyone should first go to [[http://www.rarlabs.com/|rar homepage]] and download latest winrar to get his rar up to date. Now somebody goes, eeww, rar what is that I never heard of it before? Well here the newsflash for you buddy, RAR is capable of opening zips and lot of other archives and more importantly it compresses the files much better than WinZip. You'll save tons of download size by choosing RAR for the packaging method for your island release. Do a comparison if you don't believe us. RAR is great. | ||
| + | |||
| + | Latest on the archive business is 7Zip, this handles the most compact compression, however it is not not (yet) widely accepted in the scene, so we still prefer RAR to be the archiver for addons. | ||
| + | |||
| + | |||
| + | ====== Screenshots ====== | ||
| Sometimes you see people putting a screenshot or two into a release packet, sometimes you see 4 megabytes worth of screenshots in the packet. Now ask yourself, if a user already downloaded 50mb worth of your addon to play with it... //why// do he need to see screenshots 10 seconds before he fires the addon up ingame? **DO NOT include screenshots** in the release packet, its just stupid, screenshots belong to news sites or forum release announcement posts. | Sometimes you see people putting a screenshot or two into a release packet, sometimes you see 4 megabytes worth of screenshots in the packet. Now ask yourself, if a user already downloaded 50mb worth of your addon to play with it... //why// do he need to see screenshots 10 seconds before he fires the addon up ingame? **DO NOT include screenshots** in the release packet, its just stupid, screenshots belong to news sites or forum release announcement posts. | ||
| - | **Beta Testing** | + | |
| + | ====== Beta Testing ====== | ||
| It is very common to loose the track of what's wrong when working on an addon release for a long time. You get inpatient when doing a testing after testing and just concentrate on the editing, this is very common situation. Therefore you need an outsider beta tester who isn't involved in the editing. You should have at least one person who is willing to open your release archive, look at the readme, install the addon, play it with in OFP, check the menu cutscenes, check the textures (mission editor texture button), check the map view-lag etc to really give it a run for its money. | It is very common to loose the track of what's wrong when working on an addon release for a long time. You get inpatient when doing a testing after testing and just concentrate on the editing, this is very common situation. Therefore you need an outsider beta tester who isn't involved in the editing. You should have at least one person who is willing to open your release archive, look at the readme, install the addon, play it with in OFP, check the menu cutscenes, check the textures (mission editor texture button), check the map view-lag etc to really give it a run for its money. | ||
ofp/howtorelease.1184373226.txt.gz · Last modified: 2007-07-14 00:33 by snakeman
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
