Sunteți pe pagina 1din 23

Page 1


Thanks for trying Army Builder! This document includes some basic information about the product,
including system requirements, technical support details, and more. For further details about using
Army Builder, please see the User Manual.

Whats new in this version of Army Builder? ................................................................................................ 2
Product Installation ....................................................................................................................................... 3
Minimum System Requirements .................................................................................................................. 4
Technical Support ......................................................................................................................................... 4
Removing Army Builder ................................................................................................................................ 5
Authoring Kit ................................................................................................................................................. 5
Changes in Previous Versions ....................................................................................................................... 6
Legal Information ........................................................................................................................................ 23

Page 2

Whats new in this version of Army Builder?
Program Enhancements & Changes:
1. The Army Builder Roster Viewer app will soon be available for the iPhone and iPad! Instead of
printing out a roster for each game, the Army Builder Roster Viewer puts all your rosters at your
fingertips. No more forgetting a printout, or saving a PDF to your iPad to view during the game -
the Roster Viewer does it all for you! See the Army Builder manual for full details.
2. Army Builder rosters are now saved in a new format which includes much more information,
allowing third-party tools to read saved rosters! See the Reading Army Builder Saved Rosters
section of the Army Builder manual for full details. Files saved by Army Builder 3.4c and above
will no longer load in previous versions of the product. If your friends have trouble reading your
Army Builder rosters, make sure theyve updated Army Builder.
3. If you copy an HTML roster summary to the clipboard, other programs that understand HTML
(such as word processors) will now be able to paste it with formatting intact.
4. Files in the temporary folder will no longer be added to the recent files list, as theyre
temporary and thus likely to disappear before you can re-use them.

Bugs Fixed:
1. If you clicked within a scroll bar to scroll a window up or down, then moved the mouse out of
the scroll bar without releasing the button, moving the mouse back into the scroll bar could
cause scrolling to resume incorrectly.
2. Testing squad tags in an option live test would cause Army Builder to crash.
3. On Windows, tweaked our internet code to hopefully fix some annoying problems some users
experience with bad cached downloads. We also no longer ignore invalid HTTP certificates.
4. Users with a + or other non-alphanumeric characters in their email address would sometimes
get error messages when retrieving updates.
5. If no email client is installed, trying to email someone (by choosing the Contact Technical
Support menu item, for example) now displays a more helpful message.
6. When rounding numbers towards zero, numbers like -0.1 would be unhelpfully rounded to -0
(negative zero, which is not really a thing) instead of 0.
7. In some circumstances, the Print dialog could end up behind the main Hero Lab window.

Authoring Enhancements & Changes:
1. You now get a warning if a single unit has more than 500 links, rather than 200 as before.

Page 3

Other Recent Changes
The Army Builder saved roster format has undergone major changes, allowing third party tools to read
saved rosters created by Army Builder! See the Reading Army Builder Saved Rosters section of the
Army Builder manual for full details. Files saved by Army Builder 3.4c and above will no longer load in
previous versions of the product. If your friends have trouble reading your Army Builder rosters, make
sure theyre using the latest version.
Windows 8.1 (except Windows RT) and OS X 10.9 Mavericks are now officially supported by Army
Army Builder is now available for the Mac! You can run Army Builder on any Intel Mac running OS X
10.5 to 10.9. Both Windows and Mac versions can be downloaded from our downloads page. If you have
questions about transferring your license to a Mac, see the Running Army Builder on Windows and
Mac section of our licensing info page.

Product Installation
On Windows, double-click the downloaded file to launch the installer, and follow it through to complete
the installation. After installation, you can launch the product via the Start menu, in "Start -> Programs -
> Army Builder".
On the Mac, double-click the downloaded file. Once you accept the license agreement, drag the Army
Builder icon to your Applications folder to install it. After installation, you can launch the product from
your Applications folder.
If you purchased the CD version of Army Builder, follow the instructions on your Army Builder license
NOTE! If you intend to install BOTH Army Builder V2.x AND Army Builder V3.x, they MUST be installed
into separate folders on your computer. If you install them both to the same location, both installations
will become corrupted.

Page 4

Minimum System Requirements
To run Army Builder, your computer must meet all of the following requirements:
1. PC running Windows 8.1, 8, 7, Vista, or XP (with Service Pack 3)
or Intel Mac running OS X 10.5 to 10.9 (Leopard to Mavericks)
Note that Army Builder will not run on Windows RT devices like the Surface RT and Surface 2.
2. Internet access (for licensing and to obtain data files)
3. Modern web browser (for example Internet Explorer, Chrome, Firefox, or Safari)
4. 500MHz Pentium III class processor
5. 64MB RAM memory
6. 16-bit color video with minimum 800x600 display resolution
7. 50MB free hard disk space (plus additional space for data files)
8. Mouse or other pointing device

User Manual
Once you install Army Builder, you can launch the general User Manual by going to the Help menu and
choosing Army Builder Manual.

Technical Support
Questions? You can often get quick answers from the Army Builder web site:
Otherwise, technical support for Army Builder is provided only via email. You can contact our support
staff at the email address below:
Please do NOT attempt to phone us for support, as we most likely will not be available to help you when
you call, and no support calls will be returned. We do our best to ensure that all email support questions
are answered in a timely manner, so please contact us via email.
Finally, our staff and many of our users are also present on our support forums, where you can post
questions and share information with other users:
Page 5

Removing Army Builder
On Windows, go to the Control Panel and choose Programs and Features (or Add / Remove
Programs in older versions of Windows). Find Army Builder in the list of applications and double-click to
uninstall it. Your saved files and images will not be deleted by the uninstall.
On the Mac, drag the Army Builder icon from your Applications folder to the trash. Your data files, saved
files and images will not be deleted by the uninstall.

Authoring Kit
The Authoring Kit, including the ABCreator and ABExport tools, is installed automatically when you
install Army Builder. You can find out more about the Authoring Kit by checking the Authoring Kit
documentation, by going to the Help menu within Army Builder and chosing Authoring Kit Manual.

Page 6

Changes in Previous Versions
A list of changes made in previous product releases can be found below. To see what was changed in
this version of Army Builder, see the Whats new in this version of Army Builder? section at the top of
this document.

Changes in v3.4b
Program Enhancements & Changes:
1. The options under the License menu for reactivating your license have been clarified.

Bugs Fixed:
1. Deleting certain units, particularly units that used links to add new child units, would sometimes
cause a crash.
2. Very occasionally, extracting files from an import file could fail and cause a 0-size file to be
created, but with no actual error being reported.
3. On the Mac, fixed some crashes that would very rarely occur after holding the mouse down over
a control and closing a form.
4. Army Builder no longer requires a mouse to start, as many tablets are starting to appear with a
touch screen and no mouse connected.
5. Army Builder no longer refuses to start if the minimum resolution of your screen is too low, but
still displays a warning message the first time you run it on a screen that doesnt meet the

Changes in v3.4a
Program Enhancements & Changes:
1. Windows 8 (except Windows RT) and OS X 10.8 Mountain Lion are now officially supported by
Army Builder.
2. Army Builder and its associated tools are now signed with digital certificates, which should make
the messages when you try to install the product for the first time slightly less distressing.
3. Running Army Builder on Windows 2000 is no longer supported. All Windows 2000 users should
be aware that future versions of Army Builder may not run on that operating system.
4. Accessing Manage License and related functions from the License menu now automatically
sends you to the secure version of our web site.
Page 7

5. You can now specify a local file (or a file on a network drive) as an additional updates source, by
using the syntax file://c:/path/to/file.xml.

Bugs Fixed:
1. On the Mac, if you did certain things like use the trackpad to switch desktops or open Mission
Control, Army Builder could freeze.
2. On the Mac, certain users could not run Army Builder in demo mode, as it incorrectly detected
other copies of itself running.
3. On the Mac, if one user installed Army Builder and another user tried to run it, Army Builder
would not run.
4. On the Mac (and potentially also on the PC), ABCreator would crash when you tried to edit or
delete links or tags.
5. On the Mac, clicks on disabled controls were not always being ignored properly, resulting in
some odd behavior.
6. On the Mac, using Army Builder in high-dpi mode (for example, on a Retina Macbook Pro)
would cause it to run very slowly.
7. On the Mac, using certain custom output types could cause Army Builder to crash.
8. On the Mac, watermarks were not being printed properly.
9. On Windows, made some changes that will hopefully resolve internet access problems for a
number of users.
10. Fixed a nasty bug that would cause inexplicable crashes at random times, making their cause
very hard to identify.
11. Selecting a watermark on the Print Setup was not possible, due to a bug.
12. Importing skins could fail if the skin directory wasnt already present.
13. When a file failed to save properly (for example, trying to save in a folder that Army Builder
couldnt write to), an error was not being properly reported.

Changes in v3.4
Program Enhancements & Changes:
1. Army Builder is now available for the Mac! You can run Army Builder on any Intel Mac running
OS X 10.5 to 10.7. Both Windows and Mac versions can be downloaded from our downloads
page. If you have questions about transferring your license to a Mac, see the Running Army
Builder on Windows and Mac section of our licensing info page.
2. Redesigned the Help menu, to make it easier to find more common commands. In addition, you
can now access the Hero Lab readme through the menu.
3. Army Builder and its associated tools now have improved icons.
Page 8

4. When you run Army Builder for the first time, if you choose to check updates automatically, an
immediate check is performed instead of asking you if you want to do it.
5. You can now specify a filename without a game system on the command line, and Army Builder
will ask the user which game system they want the file created for.
6. When configuring fonts for output, you can now double-click the font color to change the color
7. Added a new "Explore Folders -> Game System Data Folder" menu item under the Tools menu,
allowing easier access to the folder for the current game system.
8. When generating export files containing saved rosters, subfolders of the folder you select are
now included by default, for consistency with how folders under the game system folder are
included by default. Previously, folders under the saved roster folder were omitted from the list
and could not be selected.
9. In Windows, the Windows "Choose Folder" form is now used in a number of places, instead of
our own custom form. This fixes a number of issues where certain folders like the Dropbox
folder could not be selected as the alternate save folder for a game system.
10. Custom output types can now generate XML files by specifying the "outputextension" attribute
on the output type. See the manual for details.
11. The message indicating one or more entities or options has too many links now specifies the id
and type of one of them, making it easier to track the issue down.
12. Improved how errors occurring during custom output are reported to the user.
Bugs Fixed:
1. Army Builder could crash when generating mobile rosters which included certain units or
2. In custom roster output, the number of times an option was taken was not being displayed.
3. If extremely long (> 1 page) roster notes, design info or validation results were present, they
would not be printed.
4. Resetting the current ally race using the X ally button would cause incorrect behavior, such as
points costs not being updated.
5. Army Builder would crash during compilation if no default output view was defined.
6. Made some changes which will hopefully resolve internet access problems for some users on
7. Fixed a crash bug that occurred when Army Builder tried to import a file with a bad file
modified date. This affected user import files that were downloaded from some web sites.
8. Trying to assign a tag with a wildcard in it would cause Army Builder to crash, and now reports
an error when compiling.
9. ABExport would stop exporting files if it encountered an empty folder.
10. Army Builder now launches correctly under Windows 8. However, please note that Windows 8 is
not yet a supported operating system to run it on.
11. Army Builder no longer gives an error when starting in 256-color mode. Please note that 256-
color mode is not supported, and we don't recommend you use it.
Page 9

12. Army Builder could crash when outputting a long debug string.
13. When saving HTML files, Army Builder now removes all characters which might be problematic
in web site addresses (anything but letters, numbers, dashes and the underscore) and replaces
spaces with underscores in the default name for a file.

Changes in v3.3c
Program Enhancements & Changes:
1. -
Bugs Fixed:
1. Corrected the text that describes where to find your license number in the CD version of the

Changes in v3.3b
Program Enhancements & Changes:
1. If an internet connection error is encountered, Army Builder now directs you to a web page with
information on how to fix the error.
2. The Army Builder installer now automatically adds an exception for Army Builder to your
firewall, which should hopefully alleviate internet access problems for a number of users.
Authoring Enhancements & Changes:
2. In custom output XML, tags now have name and abbreviation attributes.
3. In custom output XML, added the "topindex" attribute to top-level entities, to make it simple to
track the order of top-level entities in the roster.
4. In custom output XML, notes for the roster now appear in a "rosternotes" element, instead of
reusing the same element that's used for unit notes.
Bugs Fixed:
1. Description text for units and items should now parse text formatting commands like {b}, {i}, \n
etc correctly.
2. For users who had changed their system's "code page", Army Builder could sometimes crash on
3. Sometimes, crashes would occur when selecting a tag group on the Filter form.
Page 10

4. When loading saved files for certain game systems, "Illegal Selection" validation errors would be
incorrectly shown until the current rule sets were changed.
5. When generating custom output, certain stat values were not being set correctly.
6. When generating custom output, certain characters could sometimes be omitted from blocks of
7. In certain unusual circumstances, child forms that opened on top of Army Builder (and also
ABCreator) could appear on the wrong monitor.
8. The updates mechanism would fail to download files from certain unusual URLs.
9. Changes to the list of update sources would not always be saved out properly.
10. The Manual License Activation Wizard was providing the wrong location for the downloaded
11. Army Builder would crash if you tried to restart after installing a new license from the "Get Your
Copy of Army Builder Now!" Screen.
12. When relaunching Army Builder, the same command-line parameters are now re-used, so any
changes to the user root / data root folder you set as a command-line parameter will be
13. Users whose "My Documents" folders were not present (for example, set to a network drive
that was disconnected) should now be able to install and use Army Builder properly, although
they'll have to pick a folder to use instead.
14. If a non-default data root was in use, the installer now installs new files into that folder instead
of the default folder.
15. If non-default data / user roots were in use, the installer now creates shortcuts that specify to
use those when installing Army Builder. (This will not happen if you're upgrading from v3.3 or
v3.3a, but it will happen if you update or reinstall in the future.)
16. If non-default data / user roots were in use, ABCreator and ABExport were not using them
properly when invoked from the Tools menu.
Authoring Bugs Fixed:
1. In ABCreator, when double-clicking a tag to edit it, the tag would sometimes not be selected in
the form that appeared.
2. In ABCreator, cost values are no longer automatically truncated to the number of decimal places
used by the game system.

Changes in v3.3a
Bugs Fixed:
1. Army Builder no longer crashes on game load for users with certain unusual characters in their
login names. Instead, a web page is loaded explaining how to fix the issue.
2. When generating a text summary, the composition group name is now displayed correctly.
Page 11

3. Army Builder now displays an appropriate error message if you try to load a file from a game
system that was not installed.
4. Army Builder now properly checks for a new version before allowing you to activate your
Authoring Bugs Fixed:
1. Editing certain items in ABCreator would cause ABCreator to crash.

Changes in v3.3
Enhancements & Changes:
1. Replaced the "Save HTML Roster" option on the File menu with a new "Save Custom Output"
option, which brings up a list of custom output types for you to use. Two sample output types,
"Roster Output" (which looks like the old HTML output) and "Unit Cards" (a 3x3 grid of unit
cards) are included. Users can also define their own custom output types, and distribute them
using ABExport. See the manual for more details.
2. You can now specify your own custom images for units, and print a small thumbnail image of
your choice beside each unit in printed output.
3. Merged Model List output and Text Summary output onto the same form, and added a new
option - "Tournament Format" output. This prints the points breakdown for your army, but
nothing else, and is intended for submission to tournament co-ordinators.
4. Added "Widescreen Mode", allowing you to display up to 6 extra info windows on the right hand
side of the main form. Widescreen Mode is automatically activated if your Army Builder form is
over 1000 pixels wide, but can be turned on and off manually.
5. You can now print text summary output directly from the "Text Summary" form, as well as
copying and saving it as text. Also, the "wikitext" format is now an option.
6. You can now add "unit card" images to your units, which can be viewed within Army Builder and
will automatically print in a 3x3 grid after your roster. (You can change the number of cards in
the grid from the Print Setup form.)
7. Army Builder has a new installer, and now installs by default into the "Program Files" directory.
The first time you install AB3.3, your old files and settings will be migrated to new locations, and
your old pre-AB3.3 install will be removed. This means that Army Builder is now better-behaved
than before, and you no longer have to run it in administrator mode when installed under
Program Files.
8. Files opened in Army Builder and ABCreator now display in the windows 7 "Jump List" (when
you right-click on AB's icon) and "Recent Documents" lists.
9. You can now open recently-used files from the 'Select Game' form when you open Army Builder.
10. Redesigned the info windows on the main form. You can now resize them by clicking and
dragging a splitter between the info windows. You can manage the contents of the info windows
Page 12

by clicking the button above them, or by choosing "Manage Main Info Windows" from the View
menu. Also, up to 4 info windows can now be shown if you have space, up from 2 previously.
11. Added four new types of info windows that can hold a unit image, a summary of the current
roster, the model list, and the tournament list of the current roster.
12. Army Builder can now use multiple "secondary updates" sources, instead of just one. You can
choose other addresses to download updates from at the bottom of the Settings menu.
13. When saving HTML files, Army Builder now removes all characters which might be problematic
in web site addresses (anything but letters, numbers, dashes and the underscore) and replaces
spaces with underscores in the default name for a file.
14. Added a new "Greyscale" skin, which displays Army Builder in black and white.
15. You can now tell Army Builder to use an alternate preferences file, so that two people on the
same computer can have different configuration settings. To do this, run Army Builder with the -
prefs=XXX parameter (where XXX is the new preferences filename, such as -prefs=james). See
the manual for more details.
16. Added "Manage Info Windows" menu items under the View menu. These let you manage the
info windows shown on the main form, floating windows, and in widescreen mode. You can
close, repurpose, and open new info windows from the "Manage Info Windows" form.
17. You're no longer asked if you're sure you want to save an invalid roster.
18. If retrieving updates fails, a more descriptive error message is now shown.
19. You can now click and drag the column edges at the top of debug info windows to resize them.
20. The "Locate File" button on the "Choose Game System" form is now labelled "Get Updates"
instead, since that's a better description of what it does.
21. Added a validation button to the print preview form to better show that the roster is invalid.
22. Before activating a new license, Army Builder now ensures that the latest version is running.
23. You can now specify a game system and a filename on the command line, and Army Builder will
offer to create a file with that filename. Passing the -autocreate flag automatically creates the
file. E.g.: armybuilder.exe examples "c:\myrosters\filename.rst" -autocreate
24. When downloading updates, the progress bar length should be slightly more accurate.
25. "Info Only" links are now displayed in a better way on the Options Summary form.
Authoring Enhancements & Changes:
1. Trailing zeroes after the decimal point are now trimmed automatically by Army Builder. You can
modify this behaviour with the new "trimdecimals" attribute on the definition, unit stats and
stat calcs.
2. You can now specify equipment="yes" or "no" on a link, overriding the default "equipment"
setting on the option.
3. You can now launch a data file in ABCreator by double-clicking it in Windows Explorer.
4. ABCreator now remembers the last group you added a tag from on the "Add Tag" form.
5. The tags grid in ABCreator is now sorted by group first, grouping all tags from the same group
Page 13

6. When adding an existing tag to a unit or item in ABCreator, you can now type the group and id
of a tag to add it without having to find it in the droplists.
Bugs Fixed:
1. Fixed a bug in the internet functions that meant they would sometimes not inform Army Builder
when an HTTP request failed, resulting in inconsistent error reporting.
2. You now get an error message if you try to print to a PDF that's currently open in another
3. Closing an info window will no longer result in it being re-opened the next time you launch the
game system.
4. Saving a mobile roster now prompts you appropriately for an empty / invalid roster.
5. Some tag ids would not be properly initialized in demo mode.
6. Under certain conditions, the print preview form would display large areas of black (although
the roster would print correctly).
7. The "New Update!" icon was not being properly replaced for the Faded Earthtones skin.
8. The "Move Left" / "Move Right" buttons for the Faded Earthtones skin were not being displayed
9. Army Builder would occasionally crash if you tried to install a new version from the updates
mechanism, but only if you summoned it from the "Select Game System" form.
Authoring Bugs Fixed:
1. Editing live tests for links in ABCreator would often cause a crash.
2. Editing the unique ids of "Extgroup" elements in ABCreator would often cause a crash.
3. ABExport will no longer include the "importbackup" folder in the list of folders it considers for
export. This should greatly reduce the size of exported data files.
4. The "tagcountstr" target would return the wrong value when used to count accrued tags.

Changes in v3.2d
Enhancements & Changes:
1. Added a new option to disable the expanded unit/item tips, under the "Basic Settings" section
of the "Settings" menu.
Bugs Fixed:
1. Some tooltips would appear over controls even when normal tooltips were disabled.
2. The unit/item tips no longer obscure the unit you mouse over when they appear.
Page 14

Changes in v3.2c
Enhancements & Changes:
1. The Check Internet Connection diagnostic now uses https to verify communication with one of
our servers, just in case normal http works but secure http does not.
Authoring Enhancements & Changes:
1. If you include a 0-byte file in a Army Builder import file, Army Builder will delete the file after
import. This allows you to delete pre-existing files in the game system's folder by replacing them
with 0-byte files, which will be deleted after import.
2. Army Builder now detects whether it needs to be run as an Administrator on Windows Vista /
Windows 7, and warns you if you need to run it as such.
3. When ABCreator is launched from within Army Builder, it automatically enables data file
debugging. Also, ABCreator warns you if data file debugging is not enabled when it runs.
4. If the PDFCanvas component is not present in the registry, Army Builder now tries to load the
appropriate DLL from the standard windows locations before giving up. This allows you to simply
place the DLL in the product folder if you are not permitted to make changes to the registry.
5. The announcement display on the updates form now changes to the "hand" cursor if the mouse
is over a clickable hot zone.
Bugs Fixed:
1. Fixed a bug that meant certain runtime tags would not be found just after adding a new unit to
the roster, meaning that the unit would display incorrectly for its first evaluation cycle.
2. Tooltips should no longer interfere with dragging and dropping units.
3. In squad validation rules, testing tags will now test both the accrued tags AND the squad tags,
instead of just the squad tags (an erroneous change made in 3.2b).
4. The - (dash) character is no longer being incorrectly accepted in game folder names.

Changes in v3.2b
Enhancements & Changes:
1. Army Builder now respects the Windows "Set custom text size" feature in many of its controls
(some, like buttons and droplists, are exceptions). This means that if you tell Windows to show
text larger than normal on the screen, text within Army Builder will now be larger too. (Note
that you may have to increase the size of the Army Builder window to display the same amount
of information as you used to see.) The maximum scaling factor obeyed is 150% of normal.
Page 15

2. Mousing over a unit or item in the Available Units list or Roster tree will now display a tooltip
containing information about that unit or item, instead of the general tooltip for the control.
3. The "nag" screen that displays on unlicensed copies of Army Builder now has an additional
option to launch the "Activate License" wizard, so that it's easier for users to find.
4. A new "Check Internet Connection" diagnostic can be found under the Tools menu, to help
diagnose problems that are occurring with an internet connection.
5. If you try to reassign your license before the waiting period is up, a large prompt message now
invites you to visit our web site and fill in a simple form to request a reassignment.
6. The minimum resolution checked for is now 800x550, to allow netbooks with very small
resolutions to run Army Builder. The "Disable Resolution Check" menu item has been removed.
7. The data file FAQ is now displayed in slightly nicer colors.
Authoring Enhancements & Changes:
1. In ABCreator, when you duplicate a link, it now brings up the editing form for the new link
2. ABCreator now acts in "strict mode", reporting more potential errors when editing data files.
3. In ABCreator, when you create or duplicate a record, the focus is set to the first control in that
record, to get you started editing.
4. In ABCreator, when you create a new definition file, ABCreator auto-creates the "Nature" tag
group, since one is required for all game systems.
5. In ABCreator, option categories are now sorted in the order they appear within Army Builder.
6. The unique ids of the "new_roster" and "edt_roster" skin resources have been changed to
"newrsthdr" and "edtrsthdr" respectively, due to conflicts with skins written for previous
versions of Army Builder.
7. You can now launch ABCreator and ABExport from the Tools menu within Army Builder.
Bugs Fixed:
1. Installing a new version of Army Builder from the updates mechanism should now prompt for
UAC elevation (if required) in Windows Vista and later versions.
2. A scroll bar is no longer displayed on the "Access Code" page of the License wizard.
3. The filter contents and live filter text are now cleared when you create a new roster.
4. Fixed a bug which meant that Army Builder might crash if you launched with a skin written for
Army Builder 3.0 or 3.1.
5. Under obscure conditions, saving out units with links selected in a specific order would cause
Army Builder to fail to load the unit back in. (This occurred when child entities, chained links and
contingent links were used in combination.)
6. Certain errors (such as errors caused by changes in the data files) that caused parts of the roster
to become invalid were not being reported when a roster was loaded.
7. Fixed an error which would sometimes cause Army Builder and its tools to crash on exit.
8. The "Specify Model Count" dialog now obeys the correct minimum / maximum limits for the
Page 16

Authoring Bugs Fixed:
1. Units with global tags were not being handled properly when added to the roster, which meant
that their global tags would not cause appropriate changes.
2. When loading a saved roster, the list of rules to apply for the new army would not always be
rebuilt, even if the roster race or points total had changed. This meant that innappropriate rules
for the old roster would be applied to the new roster.
3. Unit stat values are now verified to be within their bounds during compilation, so that they are
correct at the start of evaluation. (Previously they could be incorrect until the first time they
were set in a script, at which point they were bounded - if the stat was never set, it would
remain unbounded.) Non-default stat values defined in definition and augmentation files are
also verified. If a stat value has a minimum and maximum but no default, the default will now be
bounded automatically.
4. The "Target Id" was not being obeyed for rules in the merge context, resulting in the rule being
applied globally instead of just to the specified entities.
5. Squad tags can now be tested in the validation context of squad rules.
6. Squad tag groups can no longer be marked as accrued.
7. The "tagnames", "tagabbrevs" etc target references now work correctly in unit stat finalize
scripts, and no longer crash when used on certain tag groups.
8. Extraneous "<live/>" elements are no longer created for elements (links, linksets, etc) without
live tests in ABCreator.
9. ABCreator no longer incorrectly shows that you can access the "entity" context from unit stat
finalize scripts. Instead, it correctly shows the details for the "unit" context.
10. When you save a record in ABCreator, the edit overlay (for editing unit stats) automatically
accepts your changes and is dismissed. This prevents you from saving a record with pending
changes to a unit stat.
11. Costs in ABCreator are now limited to a maximum of 20 characters, because seriously.
12. ABCreator now requires you to specify description text for a ruleset.
13. In ABCreator, trying to enter a large number of unit stat values or exclusion counts quickly by
pressing the down key would sometimes yield inconsistent results.
14. In ABCreator, resummoning the "Find" form when it is already showing now just activates it,
instead of activating and resetting it.

Changes in v3.2a
Enhancements & Changes:
1. Added the "Faded Earthtones" skin to Army Builder. This is a dark on light skin, which some
users prefer.
2. You can now change the skin on the "Select a Game" screen when you start Army Builder.
Whichever skin you choose from the droplist is immediately applied.
Page 17

3. Changed the "Open" button on the "Select a Game" form to say "Load", and made it a lot bigger.
This should make it more obvious what to click on the form during normal use.
4. Costs for non-top-level entities are now displayed in a dimmer text color. This allows you to
more easily distinguish costs that are being charged to the total points cost, and costs that are
being charged to their parent units.
5. Added a magnifying glass icon beside the 'live filter' text box, and moved the text box to the left
of the Filter button. When text is entered into the live filter text box, the icon becomes a button
which clears the text when clicked. You can also press "Escape" to clear the live filter, and Ctrl+Q
to switch to the live filter text box.
6. Moved the "Open Floating Info Window" button upwards, to more efficiently use the space
beside the roster grid.
7. Combined the 'filter' button and 'clear filter' button into a single oval-shaped button, to make it
clearer that they are related to one another.
8. Expanded the 'allies' button into an oval-shaped button that includes a second button to clear
the current ally selection.
9. Floating info windows are now larger by default.
10. Removed two options from the Settings menu to disable bitmaps and colors on the screen.
These options were intended for supporting old hardware that Army Builder no longer runs on.
11. Pictures are now saved to the "My Pictures" folder by default, instead of "My Documents".
12. Removed the "Quick Search" menu item from the View menu. The new Live Filter mechanism
can be accessed more easily, and provides the same search functionality.
13. The sample skin is no longer included in the list of skins displayed, because it's not meant to be
used as a "real" skin. If you make a copy of it, the copy will still show up in the list, and can be
modified and used as a base for a new skin.
14. The "Select Skin" form now shows a screenshot for the default skin.
Authoring Enhancements & Changes:
1. Added the "checkpoint[tags]" and "checkpoint[stats]" target references. These list all tags and
unit stats available in the current context, which can be useful for debugging.
2. Rule contexts can now specify a display priority, allowing you to re-order them without relying
on alphabetical sorting.
3. Added the "overall.tallyid" target reference, allowing you to count the total number of units,
items, models or instances with a specific unique id in the entire roster.
4. Added the "initcost" target reference to links, to retrieve the initial cost of the link.
5. Linksets can now be added to units, items and options in extension files.
6. Entity notes now support encoded text. They now appear after the description in the entity info
window, as well as in printed output.
7. Leader units are now assigned the "runtime.isleading" tag once for each unit they lead.
8. Added a "@cost" special symbol for the "squad done" script, allowing you to change the cost of
squads based on arbitrary criteria.
Page 18

9. The "Link Summary" debug info window now shows the visibility and enablement counts for
links, giving you a better view of what's happening within the engine.
10. Added the "default" attribute to unit stats, allowing you to set the value of a unit stat for all
units that didn't specify it.
11. 10 standard colors are now available in encoded text. These colors can be changed by the active
skin, and used instead of literal color values (e.g. "{text bright}" instead of "{text ff8080}"). This
allows your data files to look great, regardless of the skin that's being used.
Bugs Fixed:
1. After returning from a 'choose entity' form summoned from the Options panel, can now scroll
the options panel with the mouse wheel.
2. Info windows on the main form now increase and decrease in size by more consistent amounts.
3. When dragging and dropping units into the roster, all tooltips are now disabled, to stop them
interfering with the drag-and-drop operation.
4. The Roster Keywords form was not displaying properly.
5. AB would crash when you tried to save a unit image to your hard disk.
6. Saving a PDF from the Print Preview form now properly launches it.
Authoring Bugs Fixed:
1. Fixed an issue where using square brackets [] in certain places (such as tag names) could make
ABCreator crash.
2. Tallying an instance count now works properly.

Changes in v3.2
Enhancements & Changes:
1. Select Game System form now includes built-in notification of updates to Army Builder and the
data files, keeping you informed about new releases.
2. New Roster form includes pre-set lists of points and rules, allowing you to create and configure
armies with fewer clicks.
3. PDF Output allows you to save your roster to a PDF for distribution to friends, tournament
organisers, and internet sites.
4. Mobile Output lets you view saved rosters on your mobile device wherever you go.
5. Model Lists display a list of all the models in your army, ideal for use as a "what to pack" list or
shopping list.
6. Summary Output can now copy to the clipboard in text, HTML or BBCode format.
7. Printed Output now includes a validation flag at the top of the page, allowing you to instantly
see whether a roster is legal or not.
Page 19

8. The "Change Rules" and "Change Roster Size" options on the Roster menu have been updated
with the same functionality as the "New Roster" form.
9. The composition group breakdown info window now displays the minimum and maximum limits
for each group underneath the totals.
10. The "Live Filter" text box above the available units list allows you to quickly search for text
within unit names and descriptions.
11. The "Clear Filter" button has been moved to beside the Filter button.
12. The first entry in the Favorites list is now "All Units", which resets the filter to show all units in
the roster.
13. The first 10 entries in the Favorites bar can now be triggered with F1-F10.
14. The main form now uses space more efficiently at higher screen resolutions.
15. The options list now uses a tree structure, allowing you to see more options on screen at once.
Option categories can be collapsed or expanded by double-clicking them.
16. The list of options now scrolls normally, instead of using up/down buttons at the bottom of the
list. The "Summary" button has been moved to the top-right of the list to save space.
17. Right-clicking an invalid option will (under some circumstances) show you the reason why the
option is invalid.
18. Updated look and feel - Many buttons and other areas of the interface have been redesigned for
a more modern, cleaner look and feel.
19. Allied Units are now displayed in green, making them easier to distinguish from other units in
the roster.
20. Extra Data allows game systems to append damage tracks or stat cards to printed output.
21. HTML Output now generates smaller, more efficient files.
22. New Print Setup form allows you to choose a default watermark, paper size and orientation for
your printed rosters. Many options from the Settings menu now live on the Print Setup form,
which can be accessed from the Print form.
23. The size of the Launch Notes window is now determined automatically by Army Builder.
24. Print Preview now generates more accurate results, but uses more memory and CPU time. This
change can be reverted by choosing "Fast Print Preview" on the Settings menu.
25. Army Builder no longer supports Windows 95/98/Me.
26. When the focus is on a button, pressing the <Enter> key will now activate the default control on
the form instead of doing nothing.
27. The "Delete Game System" option no longer selects the current game in the list, since you can't
delete that game.
28. The "Edit Value" form now uses an incrementer instead of a simple edit control.
29. All preference settings are now stored in a separate file within the product installation directory
as "herolab.prefs" instead of using the Windows Registry. This eliminates problems with
multiple users on the same computer having separate settings, such as activated license
numbers. All users on the same computer that share the same installation of Hero Lab now
share the same settings. To have different settings, install Hero Lab into different locations.
30. Army Builder now defaults to larger starting dimensions for the main window (i.e. 950 x 700),
but it will automatically shrink on smaller display sizes.
Page 20

31. There is now a "Reactivate License" wizard option on the License menu to streamline re-
activating a license that has already been initially activated.
32. The mouse wheel now scrolls multiline edit controls.
33. Tooltips now appear after hovering the mouse over the control for about a quarter of a second.
34. Attempts to runs multiple instances of Army Builder while in demo mode will now report an
error. Only a single instance of the product can be run at a time when in demo mode.
35. Individual errors that occur during loading of a saved portfolio are now reported to the user and
saved to a log file. If something goes wrong, the user can send us the portfolio and the error log
file to investigate.
36. On multiple monitor systems, Army Builder will now reposition a window if it was last opened
on a monitor that is no longer present.
Authoring Enhancements & Changes:
1. The new "Develop" Menu consolidates authoring options into a single, easy to find location for
data file authors.
2. Quick Reload allows rapid iteration while authoring data files, by reloading the current game
system, army, and saved roster in one easy command.
3. Tag groups can now be designated as "squad" tag groups. Squad tags work like global tags, but
are only visible within the squad to which they were added.
4. Rulesets can now specify an "entityhide" child, containing a tag expression. Any entities which
match the entityhide tag expression are hidden as long as the ruleset is active. This is a quick
and easy way to hide certain entities based on the presence of a ruleset.
5. "Extra Data" can now be specified for an entity. This data will be game system specific, and can
be manipulated by the "entityextra" global script. The intent of this element is to allow damage
tracks and stat cards to be generated by running scripts on the extra data.
6. The "perform" statement was added to the scripting language, simplifying many common
7. The "debug" statement was added to the scripting language, along with a new debug info
window. This allows data file authors to view debug information generated by the execution of
scripts, allowing them to easily identify and fix problems.
8. Link sets can now specify a live expression. If the tag expression fails, no links in the linkset are
9. Live tests on options, links and link sets can now specify a message. This message is displayed to
the user if he tries to select a link that is non-live.
10. Many new capabilities have been added to encoded text.
11. Many new intrinsic functions were added to the scripting language.
12. Added the "EntityExtra" global script, to set or modify the "extra data" for an entity. This allows
the printing of limited stat cards and similar items after the roster.
13. Added the "@message" and "@summary" special symbols to the validation script, allowing you
to customize the validation message displayed by the script.
Page 21

14. Added the following new script targets: username, assignstr, deletestr, tagcountstr, tagvaluestr,
tagminstr, tagmaxstr, taguniquestr, tagnames, tagabbrevs, tagids, tagsearch, idstring,
assignident, bonuspoints. You can read more about them in the authoring kit documentation.
15. The size of the launch notes window is now determined automatically, so the "nature" attribute
of the notes has been removed.
16. Added the "points" element as a child of the "structure" element, allowing you to specify pre-
defined points costs for the game system.
17. Added the "extracolumns" attribute to the "structure" element, allowing you to choose how
many columns extra data is displayed in at the end of the roster.
18. Added the "terminate" attribute to macros, allowing you to revert to the pre-AB3.2 behavior of
using them as shorthand for font color / style changes in the text following them.
19. The "width" attribute of tag groups is now optional.
20. Rulesets can now specify an "abbrev" attribute, containing an abbreviated version of the name
to use in situations where the full-length name might not fit.
21. Rule contexts can now specify an "abbrev" attribute, containing an abbreviated version of the
name to use in situations where the full-length name might not fit.
22. Sort sets can now specify a seventh tag group to sort on.
23. The "equipmodels" attribute on options counts how many models a piece of "equipment" is
represented by. For example, if a missile launcher requires 2 crew to operate, this attribute
would be set to 2.
24. The "equipname" attribute on options sets the name of the models carrying this equipment. For
example, the "Musician" equipment might change the name of its bearer to "Musician" to
distinguish him within the unit.
25. The "equipment" attribute on items allows the item is treated like an option with the equipment
flag set.
26. The "equipcollapse" attribute for units controls whether this unit is collapsed into its parent for
model list output. For example, a Sergeant model might set this attribute to "yes", so that he
was included with his parent unit in model list output, and not as an independent model.
27. The maximum squad name size is now 100 characters, up from 25.
28. Option category names now support encoded text.
29. Added the "doneif" and "validif" script constructs to simplify data file authoring.
30. The scripting language now supports +=, -=, *=, /= and &= in assignment statements. "x += 1"
works exactly the same as "x = x + 1", but it's a lot shorter to type.
31. Scripts now support the "notify" statement that reports an event to the user.
Bugs Fixed:
1. Fixed a problem that would cause Army Builder to arbitrarily crash on start-up for some users.
This is caused by a bug in Windows which was only documented on obscure programming blogs.
2. The "Duplicate Unit" command now duplicates units more accurately. Previously, certain things
were not being correctly initialized, which meant that certain complex units would not duplicate
Page 22

3. Unit / Item names longer than 50 characters would be improperly truncated.
4. After trying to load a file for a different game system and failing, the wrong filename would be
preserved by Hero Lab.
5. Changing to Landscape mode on the print preview form would have no effect on the actual
printed output.
6. The logic used for determining where word breaks should occur in multi-line text was behaving
poorly when various punctuation characters were involved.
7. The MRU list now uses the standard Windows logic for truncating filenames and inserting "...",
instead of the previous non-standard logic.
8. Trying to close Army Builder while minimized would sometimes result in the product hanging.
Authoring Bugs Fixed:
1. Changing certain unit stats in scripts would have no effect under certain conditions.

Page 23

Legal Information
This software product is the property of Lone Wolf Development Inc. and is protected by copyright laws
and international copyright treaties. The software is NOT sold, it is licensed. This license grants the
licensee to use the software on a single computer workstation and to make a single copy of the software
for archival purposes only.
This software is provided "as is" without warranty of any kind, express or implied, including, but not
limited to, the implied warranties of merchantability and of fitness for any purpose. The user assumes
the full risk of using the software.
While reasonable efforts have been made to ensure the correct operation of this software, Lone Wolf
Development does not warrant the accuracy, performance, or results you may encounter by using this
software. In no event will Lone Wolf Development be liable for direct, indirect, special, incidental, or
consequential damages resulting from the use of this software or any defect within the software, even if
Lone Wolf Development has been advised of the possibility of such damages. Any liability of Lone Wolf
Development will be limited to the refund of the purchase price.
For complete license details, please refer to the license agreements installed with the product. The
complete license agreement for use of the product in Demonstration mode will be found on the
contents page of the User Manual. A separate license agreement for use of the product in conjunction
with a Army Builder license number will be found within the product by going to the "License" menu and
initiating the license activation wizard.
Army Builder is Copyright 1997-2012 by Lone Wolf Development, Inc. All rights reserved. Army
Builder is a registered trademark of Lone Wolf Development, Inc. Lone Wolf Development and
ABCreator are trademarks of Lone Wolf Development, Inc.
Mac and the Mac logo are trademarks of Apple Inc., registered in the U.S. and other countries.
Windows is a registered trademark of Microsoft Corporation in the United States and other countries.
Other brand or product names are trademarks or registered trademarks of their respective holders.