ArmADump

Arma 3 config export and rebalance tool. Exports ammo/armor/weapons/magazines to CSV, then generates a CfgPatches mod to normalize non-RHS values to RHS baseline.

What this repo is

Extraction scripts (run in Arma 3)

ammo.sqf — CfgAmmo export with vanilla + ACE3 ballistics properties. Uses BFS with sleep 0 batching.
armor.sqf — Vest + HeadGear export with per-body-part armor/passthrough values.
weapons.sqf — Weapon export with ACE barrel properties (ACE_barrelLength, ACE_barrelTwist).
magazines.sqf — Magazine export linking to ammo classes with initSpeed.

Processing pipeline (Python)

scripts/extract_csvs.py — Parses Arma .rpt log, extracts CSVs between --- START/END --- markers.
scripts/split_by_mod.py — Splits raw CSVs into per-mod folders under data/.
scripts/generate_patches.py — Compares all mods to RHS baseline, generates per-mod output/<mod>/config.cpp + debug/<mod>/ before/after CSVs.
scripts/package_mod.py — Packages output into @mod folder with PBOs via armake2. Reads settings from package_mod.ini.

Reference

REFERENCE.md — Quick reference for all config values (vanilla + ACE3).

Pipeline (exact commands)

Step 1: Run extraction scripts in Arma 3

Run each script in debug console (or execVM). Each outputs CSV via diag_log to .rpt:

execVM "ammo.sqf"
execVM "armor.sqf"
execVM "weapons.sqf"
execVM "magazines.sqf"

Step 2: Extract CSVs from .rpt

python scripts/extract_csvs.py "path/to/arma3.rpt"

Produces ammo_raw.csv, armor_raw.csv, weapons_raw.csv, magazines_raw.csv in repo root.

Step 3: Split by mod

python scripts/split_by_mod.py

Creates data/[mod_name]/ folders with per-mod CSVs. Baseline folders are prefixed _ (_rhs, _vanilla, _ace).

Step 4: Generate rebalance mod

python scripts/generate_patches.py

Produces:

output/<mod>/config.cpp — Per-mod CfgPatches config with overrides
output/unmatched.csv — Items with no RHS equivalent
debug/<mod>/ammo.csv — Before/after debug tables for ammo overrides
debug/<mod>/armor.csv — Before/after debug tables for armor overrides

Step 5: Package and install mod

python scripts/package_mod.py

Reads package_mod.ini for mod name, author, version, output path. Produces @<mod_name>/addons/<mod>_<folder>.pbo in your Arma mods directory.

Key gotchas

SQF scripts output to .rpt log, not directly to a file. Must extract from log.
CSV delimiter is ; (semicolon), no quoting.
ammo.sqf uses sleep — requires scheduled environment (execVM or spawn).
CfgAmmo BFS depth limit of 8 levels prevents exponential blowup.
configSourceAddonList returns CfgPatches class names (e.g. rhs_c_troops), not display names. These are used as folder names in data/.
caliber is a penetration coefficient, not actual bullet caliber. Classification uses class name patterns, not caliber value ranges.
RHS baseline: folders prefixed _ are baseline. Matching uses (caliber_tier, subtype) for ammo, (item_type, tier) for armor.
Arma config uses {} for arrays, not []. The generator handles this conversion.
requiredAddons[] must use original CfgPatches class names, not sanitized folder names. unknown source_mod entries are skipped.
PBO names use mod name from package_mod.ini (e.g. a3rebalancer_jca.pbo).
Debug CSVs go to debug/, not output/ — they must not be packed into PBOs.
armake2 must be installed (cargo install armake2) and available in PATH or tools/.
Arma locks PBO files when running. Close Arma before repacking.

Conventions

SQF files use 8-space indentation (tabs).
CSVs use ; delimiter.
Python scripts use UTF-8 encoding.
Per-mod folders use the CfgPatches class name as folder name.
continue keyword avoided in SQF for pre-2.14 Arma compatibility.

3.9 KiB Raw Blame History