Differences

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

--- ofp:howtorelease [2009/04/16 09:36] – tweaked some parts. snakeman
+++ ofp:howtorelease [2024/08/01 07:07] (current) – links added. snakeman
@@ Line 1: / Line 1: @@
-====== How To Release ======
+====== OFP How To Release ======
-//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).//
+[[https://www.pmctactical.org/forum/viewforum.php?f=43|OFP Forum]], [[:ofp|OFP Home]], [[ofp:file_formats|OFP File Formats]], [[ofp:tools|OFP Tools]], [[ofp:missions|OFP Missions]], [[ofp:modeling|OFP 3D Modeling]], [[ofp:terrain|OFP Terrain]]
+**Operation Flashpoint (OFP)** aka ArmA: Cold War Assault (CWA)
+**OFP HOWTO Release Addons / Mods**
+//Note: this insert is from [[ofp:tools:wrptool|WrpTool]]'s manual and is focused on terrains, but you can learn and adapt this to your Addon instead (if it happens not to be terrain 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?
@@ Line 8: / Line 14: @@
 ====== 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 terrains. These make quite nice additions to the default bis objects and saves tons of time for terrain maker compared to him starting to do his own models and textures for such buildings.
-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 terrain pbo or just be required for the terrain to work. Well its WrpTool Development Team's opinion that none of the addons should **NOT BE ADDED** into the terrain 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 terrain already has these addons installed normally, so it is not a good solution to "hardcode" them into your terrain pbo. Just let the users know that the terrain requires these addons and they need to be installed.
 ====== 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 terrain uses objects and textures from other terrains 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 terrain 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.
-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 terrain 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.
-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 sub dirs etc. Be careful with this one.
@@ Line 31: / Line 37: @@
 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.
 Basic readme should clearly state these following things;
   * Common release name
@@ Line 56: / Line 62: @@
-====== RAR, ZIP or EXE ======
+====== RAR, ZIP, EXE or 7-Zip ======
-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.
+-08-01T07:00:00Z This was updated for latest software updates, ie 7-zip usage.
-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.
+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 [[https://www.winzip.com/|winzip]] web page.
-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.
+There is also the bis suggested AAE system, **Addons At Ease**. Well we are so blunt and call it stupid. Yep, we bash 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 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.
+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.
-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.
+Then there is the RAR utility. There are some older versions but everyone should first go to [[https://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 ZIP's 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 terrain release. Do a comparison if you don't believe us. RAR is great.
+In 2024 and actually several years already, pretty much post 2010s you need to use 7-zip, get it from [[https://www.7-zip.org|7-zip.org homepage]], it is by far the best archive compression packing software today, it does the smallest archives and can open zips, rars and various other packed file formats. Do not use ZIP or RAR anymore, those are outdated.
@@ Line 83: / Line 91: @@
 It is very embarrassing to submit a news and forum posts and then few hours/days later discover that users start to report something very obvious bugs which should have been discovered. Trust beta testing, it helps.