Home

A3SQL — Arma 3 Database Engine

An embeddable SQL database engine for Arma 3 mods. Like SQLite for Arma.

Quick Start

["CREATE TABLE players (uid STRING PRIMARY KEY, name STRING, score INT)"] call a3sql_fnc_execute;
["INSERT INTO players VALUES ('76561198000000001', 'Scarface', 1500)"] call a3sql_fnc_execute;
_result = ["SELECT name, score FROM players WHERE score > 1000 ORDER BY score DESC"] call a3sql_fnc_execute;

Wiki Pages

• Getting Started — Full worked example
• SQL Dialect — Supported SQL syntax
• CBA Settings — Addon Configuration options
• Security — Parameterized queries, TCP authentication
• TCP Connector — External query access
• Standalone Server — Run without Arma, remote mode
• Plugins — Extend A3SQL with Rust, C, or SQF plugins
• Development Setup — Full dev environment guide
• Building — Compiling the extension and addon
• Patch Framework — Dynamic live-patching system (weapon values, textures, materials, config overrides, rule groups)
• Module Guide — Integrating mods with a3sql (analytics, loadouts, persistence, progression, multi-server sync)

Status

Component	Status
Tests
Lint
Build
CI
Coverage	SQL, JOINs, CTE, window functions, triggers, FK cascade, UPSERT, SQF_EVAL(), 55+ native SQF commands
SQF Eval	SQF_EVAL() SQL function evaluates in-line SQF expressions — math, string ops, type checks, full wiki command dispatch, returns NULL for game-engine commands
Security	Parameterized queries, TCP LOGIN
Plugins	Rust trait, C ABI dynamic, SQF registration