Recommended settings¶
1.13 is famous for being configurable, but with well over a thousand INI settings spread across multiple files it can be hard to know where to begin. This page lists a handful of tweaks that many players — especially first-time players — find worth changing before starting a campaign. Everything here is optional: the defaults give you the "standard" 1.13 experience.
All settings below were verified against the current game data on GitHub
(1dot13/gamedir, the data used by the "Latest" releases). Where a setting moved or
disappeared compared to older builds, the table says so.
Playing a mod instead of plain 1.13?
The paths below use Data-1.13. If you play a mod built on 1.13, edit the files in
that mod's data folder instead — for example Data-AIM\Ja2_Options.INI for AIMNAS.
See Mods built on 1.13 and
how the data folders layer.
Use a plain text editor
Edit INI and XML files with a text editor such as Notepad++. The older documentation warned against the bundled INI editor because it caused problems; a text editor always works. Back up any file before you change it. See INI editing basics for general advice.
INI tweaks¶
These settings live in Data-1.13\Ja2_Options.INI. Each row lists the [Section] the
key sits under, so you can jump to it quickly. For a broader tour of the file, see
Ja2_Options.INI.
| Setting | Section | Why you might change it |
|---|---|---|
TRIGGER_MASSIVE_ENEMY_COUNTERATTACK_AT_DRASSEN |
[Strategic Event Settings] |
Set to FALSE for a first campaign. The Drassen counterattack is infamous for hitting very hard, very early — the INI itself warns it makes the beginning of the game "MUCH HARDER". If you keep it on, read the survival tips. |
REDUCED_INSTANT_DEATH |
[Tactical Gameplay Settings] |
TRUE converts damage that would kill one of your mercs outright (from a gun or knife, when no death animation triggered) into damage that leaves them in a coma instead. Makes merc deaths less likely. Not available in the old r7609 build. |
MINE_INCOME_PERCENTAGE |
[Financial Settings] |
Scales mine income. 100 is normal JA2 profit; valid values run from 1 up to 65535 (a value of 0 is treated as 1). Raise it if you find money too tight. |
WHICH_MINE_SHUTS_DOWN |
[Strategic Event Settings] |
One mine runs out of ore during the campaign. -1 = random (default), 0 = no mine shuts down, or pick one: 2 Drassen, 3 Alma, 4 Cambria, 5 Chitzena, 6 Grumm. |
STEALING_FROM_SHIPMENTS_DISABLED |
[Bobby Ray Settings] |
TRUE stops NPCs stealing from your item shipments (in Drassen that is Pablo). |
CHANCE_OF_SHIPMENT_LOSS |
[Bobby Ray Settings] |
Percentage chance that an entire Bobby Ray's shipment is lost. Default 10; set 0 if you never want to lose one. |
CHANCE_TONY_AVAILABLE |
[Shopkeeper Inventory Settings] |
Chance that Tony, the weapon dealer in San Mona, is at his shop. 80 is the vanilla value; 100 means he is always home. |
ENABLE_ALL_WEAPON_CACHES |
[Strategic Gameplay Settings] |
TRUE enables every sector with a "secret" weapon cache — chests holding mediocre-to-good equipment. |
DROP_ALL |
[Tactical Difficulty Settings] |
Controls enemy item drops. 0 = normal drop chances, 1 = enemies drop everything, 2 = enemies drop everything but items that would normally not drop are severely damaged. On the old r7609 build this was a New Game screen option instead (see New Game options). |
SELL_ITEMS_WITH_ALT_LMB |
[Financial Settings] |
TRUE (the default) lets you sell items straight from the sector inventory screen by holding Alt and left-clicking the item. The companion key SELL_ITEMS_PRICE_MODIFIER controls the price you get (default 10, meaning 10% of the item's value). |
MERCS_CAN_BE_ON_ASSIGNMENT |
[Recruitment Settings] |
0 = default behavior (some mercs are on assignment at game start and go on assignments during the campaign), 1 = everyone is available at the start but may leave on assignments later, 2 = every merc is always at your disposal. |
MERCS_CAN_DIE_ON_ASSIGNMENT |
[Recruitment Settings] |
FALSE prevents A.I.M./M.E.R.C. mercs you have not hired from dying while away on other missions. (The per-difficulty cap on such deaths, MaxMercDeaths, lives in DifficultySettings.xml.) |
SLAY_STAYS_FOREVER |
[Recruitment Settings] |
TRUE lets the character Slay stay with your team indefinitely; with FALSE he can only be recruited for a limited time. |
Newer optional systems¶
Recent releases added several large optional systems, all switched in
Ja2_Options.INI as well. Each row links to the page that explains the system in
full — read it before you flip the switch.
| Setting | Section | Why you might change it |
|---|---|---|
MINI_EVENTS_ENABLED |
[Mini Events Settings] |
Off by default. TRUE turns on Mini Events: random campaign events that pop up on the strategic screen with two choices, each with positive and/or negative effects. A low-risk way to add flavor to any campaign. |
REBEL_COMMAND_ENABLED |
[Rebel Command Settings] |
Off by default. TRUE enables Rebel Command: you direct the rebels at the strategic level through the A.R.C. laptop site. The INI recommends starting a new campaign ("unless you're up for a challenge"); if you enable it mid-campaign, the game grants a starting stock of Supplies based on the current day and progress. |
AGGRESSIVE_STRATEGIC_AI |
[Strategic Event Settings] |
Default 2: the Queen can launch Drassen-style counterattacks on every city, plus major offensives late in the campaign. 1 keeps the city counterattacks but drops the offensives; 0 downgrades the non-Drassen counterattacks (the Drassen one has its own toggle, above). Worth lowering for a gentler first campaign — see the strategic war. |
MERC_WEBSITE_IMMEDIATELY_AVAILABLE |
[Recruitment Settings] |
TRUE sends Speck's introductory e-mail at the start of the game, so the budget M.E.R.C. hiring site is open from day 1. See Hiring & contracts. |
FAST_BOBBY_RAY_SHIPMENTS |
[Shopkeeper Inventory Settings] |
TRUE makes Bobby Ray's shipments arrive faster. See Bobby Ray's for the shop's other quality-of-life settings. |
FOOD |
[Tactical Food Settings] |
Off by default, and fine to leave off for a first campaign. TRUE opts in to the food & water system: mercs must eat and drink or suffer morale, energy and eventually stat penalties. |
DISEASE |
[Disease Settings] |
Off by default. TRUE opts in to the disease system: mercs can catch diseases from swamp insects, corpses, contaminated items and more. Like food, an extra survival layer for players who want more to manage. |
Settings that moved or were removed¶
Two entries from older versions of this list no longer work the way they used to:
ALLOW_REINFORCEMENTS— on the old r7609 build this was aJa2_Options.INIsetting. In current releases, battlefield reinforcements are enabled per difficulty level inTableData\DifficultySettings.xmlinstead (see Reinforcements below). The only related INI key left isALLOW_REINFORCEMENTS_ONLY_IN_CITIESunder[Strategic Gameplay Settings], which restricts reinforcements to movement between city sectors and affects militia only.SHOW_SKILLS_IN_HIRING_PAGE— this setting (a tooltip with skills and traits on merc portraits on the A.I.M. and M.E.R.C. hiring pages) existed in r7609/r8741-era builds but is no longer present in the currentJa2_Options.INI. If you still play an old build, it remains available there.
XML tweaks¶
These files live in Data-1.13\TableData. XML is fussier than INI — a malformed file
can prevent the game from starting — so read
editing XML safely first and keep backups.
Starting money¶
Open TableData\DifficultySettings.xml and edit the <StartingCash> value inside the
block for the difficulty you want to play. The current defaults are:
| Difficulty | <StartingCash> |
|---|---|
| Novice | 45000 |
| Experienced | 35000 |
| Expert | 30000 |
| Insane | 15000 |
Edit the existing blocks — do not add new ones
The file itself warns: do not create new difficulty entries; modify the level you want to play. Parts of the game still assume the original difficulty levels.
Vehicle seating capacity¶
By default the Hummer, the ice cream truck and the helicopter each hold six mercs. If you field bigger squads, raising the capacity makes strategic movement much easier.
In TableData\Vehicles.xml, find the vehicle by its <uiIndex>:
<uiIndex> |
Vehicle |
|---|---|
| 160 | Hummer |
| 162 | Ice cream truck |
| 163 | Helicopter |
Change the <SeatingCapacities> value from 6 to what you want. The ground vehicles
define ten seat positions (SeatIndex 0–9), which is the upper limit for them.
Possible crash
The game may crash if your squad size is smaller than the vehicle capacity and you enter combat while in a vehicle. If you raise vehicle capacity, consider raising your squad size to match.
Reinforcements¶
When this feature is on, enemies (and your militia) can reinforce an adjacent sector during a battle: they arrive at the edge of the map a few turns after the fight starts, which can swing the outcome dramatically.
In current releases this is controlled per difficulty in
TableData\DifficultySettings.xml:
<AllowReinforcements>1</AllowReinforcements>
<AllowReinforcementsOmerta>0</AllowReinforcementsOmerta>
<AllowReinforcements>—0off,1on. On by default on every difficulty; set it to0in your difficulty's block to turn the feature off.<AllowReinforcementsOmerta>— whether the enemy may reinforce Omerta specifically. Off by default on Novice, on for Experienced and above.
On the old r7609 build this was the single ALLOW_REINFORCEMENTS key in
Ja2_Options.INI instead.
Advanced: display and scaling¶
Third-party software
Apart from cnc-ddraw, the tools below are third-party software that is not part of 1.13. Use them at your own risk.
cnc-ddraw (included — try this first)¶
Current 1.13 releases ship with cnc-ddraw (by FunkyFr3sh), a DirectDraw replacement
that solves most performance and graphics problems on modern Windows. Run
cnc-ddraw config.exe in your game folder (next to ja2.exe) to configure
fullscreen or borderless-window mode, scaling shaders, the renderer, FPS limits and
more. There is no need to download anything — it is already installed. The project
lives at github.com/FunkyFr3sh/cnc-ddraw.
For startup problems and other display fixes (including legacy advice for old builds), see Troubleshooting.
Alternatives¶
If cnc-ddraw does not give you the result you want — for example a borderless window or integer scaling for a sharper image — these tools have been used with JA2:
- dgVoodoo 2 — a wrapper for old DirectX (and Glide) graphics APIs.
- DxWnd — runs old games in a window and intercepts their graphics calls.
- IntegerScaler — scales the game image by whole multiples for a pixel-sharp result.
Setting these up for JA2 1.13 is not covered by the official documentation — if you get stuck, ask on the Bear's Pit forum or the 1.13 Discord. As a rule of thumb, avoid running two DirectDraw wrappers (such as cnc-ddraw and dgVoodoo 2) at the same time.
Linux and macOS¶
JA2 1.13 is a Windows program, but it runs under Wine. See the Troubleshooting page for notes on running 1.13 outside Windows.
Sources¶
Data-1.13/Ja2_Options.INIfrom the 1dot13/gamedir repository (current setting names, sections, values and in-file documentation)Data-1.13/TableData/DifficultySettings.xmlfrom the 1dot13/gamedir repository (starting cash, reinforcements, MaxMercDeaths)Data-1.13/TableData/Vehicles.xmlfrom the 1dot13/gamedir repository (vehicle indices and seating)- "Jagged Alliance 2 v1.13 - Recommended Settings" from the previous (r8741-era) 1.13 starter documentation
- "Technical Issues with JA2 1.13 – Problems and Solutions" from the gamedir
Docsfolder (cnc-ddraw note, August 2023)