Antistasi Ultimate

Developer Documentation

Utility Functions

Spawn Trader Mission

Spawns a trader mission on a new save

[] remoteExec ["SCRT_fnc_trader_prepareTraderQuest", 2];

Export Crate To Arms Dealer

Grabs all the weapons out of a crate, grabs mags for them, then puts it into a formatted config array for the arms dealer
(returns into your clipboard)

[_target, "modPrefix", "categoryPrefix"] call A3U_fnc_exportCrate;

You can also have multiple crates and do this to export them one at a time

//crate 1
this addAction ["copy", {[(_this select 0), "RHS", "Rifles"] call A3U_fnc_exportCrate}];
//crate 2
this addAction ["copy", {[(_this select 0), "RHS", "Sniper Rifles"] call A3U_fnc_exportCrate}];

Export Pylon Loadout For Config

(As of 10.2.2)
Grabs the current pylon loadout of an air vehicle and exports it for config (returns into your clipboard)

[_target] call A3U_fnc_exportPylons;

Draw cargo seats of vehicles, with index

(doesn't always work with modded vehicles, due to weird setups)

[cursorObject] call A3U_fnc_logisticsGrabSeats;

Logging

["Message", _fncPath] call A3U_fnc_log;

cfgPatches check

["cfgPatchesClass"] call A3U_fnc_hasAddon;

Alternate Syntax

[["cfgPatchesClass1", "cfgPatchesClass2"]] call A3U_fnc_hasAddon;

Weight Test

Logs occurence of each value over 10000 iterations

[_values, _weights] call A3U_fnc_weightTest;

Change player faction money/hr

Changes player's faction Money and HR (takes effect immediately but ui won't update untill next tick)

[0,0] remoteExec ["A3A_fnc_resourcesFIA",2]; //1 param - hq, 2 param - money

Debug Rivals

Sets up the rivals, and reveals their location on the commander menu

[] spawn {
[] remoteExecCall ["SCRT_fnc_rivals_activate", 2];
uiSleep 2;
[10000] call SCRT_fnc_rivals_addProgressToRivalsLocationReveal;
};

Python Stuff

Town Generator

Town Generator is a bundle of 2 python scripts, input.py and sort.py

sort.py does the heavy lifting and doesn't necessarily need to be used directly (input.py imports the sort.py function). input.py can be ran and will prompt you to put in an array provided by A3U_fnc_exportTowns.

After selecting an export type, it will then provide you with a list of towns/population that you can paste into a mapInfo.hpp file.

VSCode Stuff

VSCode arma-dev.json

{
"title": "Antistasi Ultimate",
"name": "A3U",
"author": "Antistasi Ultimate Dev Team",
"website": "",
"version": "0.0.1",
"buildPath": "build",
"privateKey": "",
"serverDirs": [],
"serverUse32bit": false,
"clientDirs": [
"A3A/addons/config_fixes",
"A3A/addons/core",
"A3A/addons/events",
"A3A/addons/garage",
"A3A/addons/gui",
"A3A/addons/hals",
"A3A/addons/jeroen_arsenal",
"A3A/addons/logistics",
"A3A/addons/main_menu",
"A3A/addons/maps",
"A3A/addons/patcom",
"A3A/addons/scrt",
"A3A/addons/ultimate"
],
"clientMods": [],
"ftpConnection": {},
"steamPath": "pathToSteamLibrary"
}

Extender Documentation

Antistasi Ultimate Extender Example

This is an example of how you could extend Antistasi Ultimate with new maps and templates or overwrite existing ones. This is a fork of A3AExtender made by Antistsi Official Community Arma 3

Requirements

Arma 3
Arma 3 Tools

Both need to be run once from steam.

How to get started:

Run the Install.ps1 script and follow the instructions on screen.
Run the Build.ps1 script. This will create a folder in the root folder called build and compile your extension into it.
Start the ArmA 3 launcher and in the launcher do the following:

Under Mods -> ...More select add watched folder... then add custom folder.... Navigate to your extensions root folder and select the newly created build folder. If successful it will have added that folder in the list of watched folders and a green box would have shown stating that a mod has been installed.
Load Antistasi Ultimate - Mod and the newly installed A3 Antistasi Ultimate Extender example mods.
Start the game and confirm that the new template is loaded by starting a local host session under multiplayer. Then start a game of antistasi and confirm that the new and overwritten templates are there (these are the example templates provided with the extender).
The new templates are AAF and AAF2 .

Assuming everything went well you are now ready to make your own modifications. Remember to remove unused content and read thoroughly through the files while making any edits. As a hint all content is added from the config.cpp files located within each of the addons so you can follow that down to the files that govern the different parts like templates and functions etc.

Example additions

Maps

Antistasi now supports 3rd party map porting.

There are two examples added for working with maps. Adding a new map and overwriting/applying additions for an existing map.

In this examples there are also demonstrations of mission specific overwrites of mapInfo and navGrid data as well as global overwrite/addition.

You will find all the information regarding this under your extension mod/addons/maps.

Take care to study all the files in the addon to not miss crucial porting steps.

Templates

Antistasi now supports 3rd party template additions/overwrites.

To add new templates or overwrite existing ones follow the demonstration given in your extension mod/addons/templates/Templates/Templates.hpp.

Note that while you can add addon vehicle templates to Antistasi at this time, it should be noted that it is still a limited system and you shouldn't expect full functionality from them atm.

Again it's important to read through all the files in the templates addon to not miss important steps.

Functionality

Antistasi now has events that you can listen to and extend existing functionality. A list of all events and their parameters can be found in the in game config under: A3A >> Events.
In addition you can overwrite any of Antistasi's functions to add, change or remove functionality. This includes full systems (be aware that this is more complex and can break on updates). To do so, simply add a function to the A3A and/or A3U and/or A3UE class of CfgFunctions.hpp under the addon functions (you can also replicate the config.cpp to allow this in any other addon).

Releasing your extension

Now that you have added the content/functionality you wanted its time to release the extension.
You should first make sure that any example content not being used is removed, you can do so either carefully by removing lines from the configs, or by removing a addon folder completely.

Note that you can not remove the core addon.

Next update the mod.cpp and meta.cpp files to contain the correct information for you (for steam release you can delete the meta.cpp from the build folder afterwards).

Now simply run the Build script in the root folder to build it and use the arma tools for signing and publishing the extension. (Note: it will not sign it for you, this needs to be done manually before publishing with Arma 3 Tools -> DSUtils & Publisher). You can also distribute it in other ways other than the steam workshop simply by sending the build output to the users.

Small disclaimer:

When you want other Antistasi players to easily find your extension, give it a descriptive name including the abbreviation A3UE like for example A3UE - My awesome Antistasi Ultimate extension.

Here you will find some useful information!

Developer Documentation

Utility Functions

Spawn Trader Mission

Spawns a trader mission on a new save

Export Crate To Arms Dealer

Grabs all the weapons out of a crate, grabs mags for them, then puts it into a formatted config array for the arms dealer (returns into your clipboard)

You can also have multiple crates and do this to export them one at a time

Export Pylon Loadout For Config

(As of 10.2.2) Grabs the current pylon loadout of an air vehicle and exports it for config (returns into your clipboard)

Draw cargo seats of vehicles, with index

(doesn't always work with modded vehicles, due to weird setups)

Logging

cfgPatches check

Alternate Syntax

Weight Test

Logs occurence of each value over 10000 iterations

Change player faction money/hr

Changes player's faction Money and HR (takes effect immediately but ui won't update untill next tick)

Debug Rivals

Sets up the rivals, and reveals their location on the commander menu

Python Stuff

Town Generator

VSCode Stuff

VSCode arma-dev.json

Extender Documentation

This is an example of how you could extend Antistasi Ultimate with new maps and templates or overwrite existing ones. This is a fork of A3AExtender made by Antistsi Official Community Arma 3

Antistasi now supports 3rd party map porting.

There are two examples added for working with maps. Adding a new map and overwriting/applying additions for an existing map.

In this examples there are also demonstrations of mission specific overwrites of mapInfo and navGrid data as well as global overwrite/addition.

You will find all the information regarding this under your extension mod/addons/maps.

Take care to study all the files in the addon to not miss crucial porting steps.

Antistasi now supports 3rd party template additions/overwrites.

To add new templates or overwrite existing ones follow the demonstration given in your extension mod/addons/templates/Templates/Templates.hpp.

Note that while you can add addon vehicle templates to Antistasi at this time, it should be noted that it is still a limited system and you shouldn't expect full functionality from them atm.

Again it's important to read through all the files in the templates addon to not miss important steps.

Now that you have added the content/functionality you wanted its time to release the extension. You should first make sure that any example content not being used is removed, you can do so either carefully by removing lines from the configs, or by removing a addon folder completely.

Small disclaimer:

When you want other Antistasi players to easily find your extension, give it a descriptive name including the abbreviation A3UE like for example A3UE - My awesome Antistasi Ultimate extension.

Grabs all the weapons out of a crate, grabs mags for them, then puts it into a formatted config array for the arms dealer
(returns into your clipboard)

(As of 10.2.2)
Grabs the current pylon loadout of an air vehicle and exports it for config (returns into your clipboard)

Now that you have added the content/functionality you wanted its time to release the extension.
You should first make sure that any example content not being used is removed, you can do so either carefully by removing lines from the configs, or by removing a addon folder completely.