Differences

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

--- falcon4:tools:nsis_installer [2007-07-12 06:56]
snakeman created nsis_installer initial page
+++ falcon4:tools:nsis_installer [2017-10-13 19:54] (current)
snakeman http to https switch.
@@ Line 1: / Line 1: @@
 ====== NSIS Installer ======
-**NSIS Installer**
+**NSIS Installer for theaters** by PMC
+The NSIS installer is quite nice as its free to download and very light weight, its script based so you can tweak the installer to do pretty much anything you want. Sure the script at first looks pretty intimidating, but dont let that scare you, we have the wiki to help you out.
 Here in PMC Tactical we use NSIS installer to build our theater installers, also FreeFalcon/RedViper is using this method for their installation. Its very nice freeware open source program.
 The scripting is relatively easy for a non-coder to figure out, but is still powerful and flexible. It has a strong user community and good open-source support. It also is "portable" in that there is a version which can run from almost any PC on USB memory stick.
+====== Theater Subdirs ======
+First you should setup your theater directories in preparations for the NSIS to build the installer. It doesn't really matter what you call the source directory as you can configure it on the script, but we call it here **Theater_src_THEATERNAME** where the theatername of course is like Europe, DesertStorm or Vietnam in our case.
+In the "root" theater source dir you got two directories called, Theaters and Utilities. We chose to use the Utilities dir which is included in the default RedViper installation to store its utils/tools. And naturally the Theaters dir is the one which we use to suit [[falcon4:dirstruct|PMC Theater Directory Structure]] which so far everyone (except Naldo) has agreed to use.
+In the utilities dir you place the utils, these are lstupdate.exe, LxNormalFix.exe, SeasonSwitcher.exe and Htti.exe filenames.
+So in short, you have directory of
+<code>
+Theater_src_DesertStorm\Theaters\DesertStorm\
+</code>
+Which would be your root directory for the ODS theater (later in this doc as we refer to root, this is the dir), in this root directory you have the art, campaign, objects and terrdata directories. Also there is theater selection TDF, TGA files and any readme files you wish the users to see (in our case, its the EULA.txt and version.txt).
+====== Art dir ======
+Art directory is for the user interface files. Our base system includes the art\resource\ directory which contains two UI files, these are campmap and select which in our experience are universal for all F4 versions. As you need to include the individual UI files for different F4 versions in the art-AF, art-OF and art-RV directories, the main art\ dir is where you place the resource dir.
+As seen here
+<code>
+art\resource\
+art\art-AF\
+art\art-OF\
+art\art-RV\
+</code>
+When we examine the individual directories more we'll find these following subdirs.
+**art-AF\**
+<code>
+art\art-AF\campaign\
+art\art-AF\main\
+art\art-AF\resource\
+</code>
+Notice how art-OF\ requires yet another "art" subdir to work.
+**art-OF\**
+<code>
+art\art-OF\art\main\
+art\art-OF\art\resource\
+</code>
+**art-RV\**
+<code>
+art\art-RV\main\
+art\art-RV\resource\
+</code>
+You should refer to our [[falcon4:ui|user interface]] namespace for details how to edit Falcon 4 UI.
+====== Campaign dir ======
+Campaign dir includes the common files used for all campaigns, as well the individual campaign directory files required for all possible campaigns. The sub directories in main campaign dir are as follows.
+Campaign subdirs for our DesertStorm theater
+<code>
+campaign\common\
+campaign\common-AF\
+campaign\common-OF\
+campaign\common-RV\
+campaign\desertstorm1\
+campaign\desertstorm2\
+</code>
+When we look closer, we find that the common\ directory contains these following files: instant.cam, kneemap.gif, te_new.tac, desertstorm.idx/.wch, desertstorm.pak and desertstorm.thr. These are the files that are common/same for all the campaign directories we are creating.
+In the common-AF\, common-OF\ and common-RV\ dirs we have files for each specific F4 version, in this case strings.idx/.wch files.
+Finally in the desertstorm1\ and desertstorm2\ dirs we have the specific files required for each campaign, these are usually save0.cam, save0.tri and save1/2 also.
+You should refer to our [[falcon4:campaign|campaign]] namespace for details how to edit Falcon 4 campaigns.
+====== Objects dir ======
+To install new objects, objects and including new skins to your theater, you need to create **objects* subdir into the root. In the objects dir create AF, OF and RV sub directories. In these subdirs you place the edited database files.
+As seen here
+<code>
+objects\AF\FALCON4.WLD
+objects\OF\FALCON4.WLD
+objects\RV\FALCON4.WLD
+</code>
+In this case the falcon4.wld file is the edited loadouts for aircrafts.
+You should refer to our [[falcon4:database|database]] namespace for details how to edit Falcon 4 database.
+====== Terrdata dir ======
+Terrdata directory is where the terrain\ and texture\ sub directories are located.
+As you can see
+<code>
+terrdata\terrain\
+terrdata\texture\
+</code>
+Of course if your theater uses only default korean tiles, you dont need texture\ subdir.
+In the terrain\ sub dir you find theater.L2/.O2, theater.map and theater.mea files, rest of the theater files are created with the [[falcon4:tools:sptinstall|terrain rebuilder]] util.
+In the texture\ sub dir (if you need it) you find fartiles.pal, texture.bin and texture.zip files.
 ====== Example Script ======
@@ Line 41: / Line 153: @@
 SetCompressor lzma
 ; branding text is just something that's displayed at the bottom of the installer
-BrandingText "http://tactical.nekromantix.com"
+BrandingText "https://www.pmctactical.org"
 ;=== Includes - this will include the necessary dlls and functions that I use in the installer
@@ Line 272: / Line 384: @@
 Sorry for the long code, but thats the whole script we used to build Vietnam theater installer.
-Check out our offical [[http://tactical.nekromantix.com/forum/viewtopic.php?t=20958|NSIS installer]] topic.
+Check out our offical [[https://www.pmctactical.org/forum/viewtopic.php?t=20958|PMC Tactical Forum NSIS installer]] topic.
 ====== Notes ======
 Homepage of [[http://nsis.sourceforge.net|NSIS]].

PMC Editing Wiki

User Tools

Site Tools

Differences

Page Tools