DMS_Exile/README.md

Instructions

See also: http://www.exilemod.com/topic/61-dms-defents-mission-system/?do=findComment&comment=242

To install:

Put the pre-packed PBO in your @ExileServer\addons\ directory. It should be alongside exile_server and exile_server_config.

NOTE: Also look at the first part of this comment. This will solve a few issues that you may encounter.

If you are using infiSTAR and want to keep _CGM = true;, then set _UMW = true;, and add DMS_MissionMarkerCircle, DMS_MissionMarkerDot to _aLocalM, so your _aLocalM would look like:

    _aLocalM = ["DMS_MissionMarkerCircle","DMS_MissionMarkerDot"];

Optional:

To modify the config:

• Download the a3_dms folder
• Edit the config.sqf to your preferences.
• Pack the a3_dms folder with a PBO tool (PBO Manager, Eliteness, or Arma 3 Tools suite)
• Follow the "To install:" steps using the PBO you just created instead of the pre-packed one.

HEADLESS CLIENT:

Headless Client is currently broken in ArmA as of the 4th of September, do not use it as it WILL crash your server.

Add this code to the TOP of your initPlayerLocal.sqf

if (!hasInterface && !isServer) then
{
	1 spawn
	{
		waitUntil {player==player};
		DMS_HC_Object = player;
		publicVariableServer "DMS_HC_Object";
	};
};

Thanks:

• Defent for creating Defent's Mission System.
• eraser1 for his constant codebase improvments.
• Zupa for suggestions and coding help.
• Nawuko for catching a silly mistake :P
• shaworth and KawaiiPotato for making the README all nice and pretty :)
• Everbody's feedback on the DMS thread on exile forums
• maca134 for M3Editor Stuff

Changelog:

September 25, 2015 (7:30 PM CST-America):

• NEW CONFIG VALUES: DMS_SpawnMineWarningSigns DMS_BulletProofMines
• You can now manually define the rare loot chance per crate.
• You can now define the mine amount and radius directly from the call for DMS_fnc_SpawnMinefield.

September 25, 2015 (1:30 AM CST-America):

• NEW CONFIG VALUES: DMS_SpawnMinesAroundMissions DMS_despawnMines_onCompletion DMS_MineInfo_easy DMS_MineInfo_moderate DMS_MineInfo_difficult DMS_MineInfo_hardcore DMS_explode_onRoadkill
• You can now spawn randomly generated minefields around missions! Numberof mines and radius is dependent on difficulty.
• Also, you can now spawn an explosion on an AI when it is roadkilled, causing a wheel or two of the roadkilling vehicle to break.
• Commented out the spawning of static-relative conversion of base objects in test mission.
• Included example of how to spawn the minefield in the test mission.
• Reduced some of the RPT spam.
• Smoke/IR grenades will only spawn on proper crates - you can now safely use DMS_fnc_FillCrate with non-crate objects but still have smoke available.

September 21, 2015 (11:30 PM CST-America):

• NEW CONFIG VALUES: DMS_Diff_RepOrTabs_on_roadkill DMS_Bandit_Soldier_RoadkillMoney DMS_Bandit_Soldier_RoadkillRep DMS_Bandit_Static_RoadkillMoney DMS_Bandit_Static_RoadkillRep DMS_Bandit_Vehicle_RoadkillMoney DMS_Bandit_Vehicle_RoadkillRep
• Removed config value: "DMS_credit_roadkill"
• You can now REDUCE a player's respect/poptabs when the player roadkills an AI. The default values are -10 poptabs and -5 respect (hardly noticeable, but I didn't want it to be extreme).
• Alternatively, you can simply reduce the amount of poptabs gained by giving each corresponding config a positive value less than the regular. Set the value to 0 if you don't want to credit the poptabs/respect.
• The player will get an appropriately colored message if he/she LOSES poptabs (as opposed to gaining them).
• The player also gets a little more information regarding the type of AI he/she has killed.

September 20, 2015 (11:30 PM CST-America):

• CONFIG VALUES: Changed "DMS_MissionTypes" to "DMS_BanditMissionTypes"
• Renamed some variables to "future-proof" them
• Placed all current missions under "bandit" subfolder to for easier future integration.
• Created function "DMS_fnc_SpawnBanditMission" to handle bandit mission spawning (makes it easier to spawn missions via admin console).
• Attached vehicle eventhandlers to DMS-spawned non-persistent vehicles.
• Fixed the "lock" option appearing on DMS-spawned vehicles.

September 20, 2015 (3:30 PM CST-America):

• NEW CONFIG VALUE: "DMS_MaxSurfaceNormal"
• The above config value now determines the maximum incline that a mission can spawn on. Default value is 0.95, which should be sufficiently flat.
• Added some grouping explanations in mission config settings.
• Added check for A3XAI for the lovely "Face"/"dayzai"
• Added ability for people to use a static export from M3Editor. DMS will then calculate the relative position, and spawn it at the mission. Example provided in testmission.sqf.
• Fixed an issue with DMS_fnc_TargetsKilled always returning false.

September 20, 2015 (12:30 AM CST-America):

• NEW CONFIG VALUE: "DMS_ai_offload_Only_DMS_AI"
• You can use "DMS_ai_offload_Only_DMS_AI" to offload only AI spawned by DMS. This should resolve any issues with other mission systems from DMS.
• Increased "DMS_playerNearRadius" from 75 meters to 100 meters.
• You can now define "absolute" mission conditions. If this mission condition is met, it immediately counts the mission as completed. Add "true" after the completion argument to turn it into an "absolute" win condition.
• Added compatibility with RS_VLS by Rod Serling.

September 18, 2015 (6:30 PM CST-America):

• NEW CONFIG VALUE: "DMS_HideBox".
• Loot vehicles cannot be lifted, pushed, or damaged until the mission is completed successfully. Then the vehicle will be added to the Exile simulation monitor.
• AI in vehicles will be automatically ejected on death.
• Another potential fix for launchers not despawning off of AI sometimes.
• When an AI gunner from an armed ground vehicle is killed, the driver will be switched to the gunner seat after 5-10 seconds. This prevents the driver from driving around aimlessly and trolling.
• The above feature should now also work on AI that have been offloaded now (doing so was a major, major pain in the ass, and is the reason why there was no update yesterday).

September 16, 2015 (10:30 PM CST-America):

• NEW CONFIG VALUES: DMS_MaxAIDistance and DMS_AIDistanceCheckFrequency
• You can now use the above config values to kill AI that flee from their spawn position. Only "Soldier" AI will be killed.
• Removed "O_HMG_01_F" from AI Static Weapons. AI were pretty useless on it... unless the AI were facing the right direction.
• Reduced AI count and removed the "playerNear" parameter from testmission for easier testing.
• NEW: When an AI vehicle gunner is killed, and the driver is still alive, after a little delay, the driver is then switched to the gunner seat. You should no longer have AI vehicles with a dead gunner that's driving around aimlessly :) There is a 5-8 second delay to simulate reaction time. Then the driver is ejected, then after 1.5 seconds the AI is then forced into the gunner seat.
• NOTE: The above feature only works when the AI is still local (not offloaded). If the AI is offloaded, the AI is simply ejected and becomes a foot soldier.
• AI assigned vehicles are destroyed when the crew is empty. Simulation is also disabled on them.
• Reduced some of the "params" RPT spam, from DMS_fnc_SetGroupBehavior.
• Tweaked AI Vehicle spawning logic. The AI are initially assigned to a temporary group and then behavior is set, then they join the assigned group to prevent overriding behavior of other ground units.
• Non-persistent vehicles should now be fit properly to the terrain.

September 14, 2015 (11:00 PM CST-America):

• NEW CONFIG VALUES: DMS_AIVehCleanUpTime, DMS_MinWaterDepth, DMS_Bandit_Vehicle_MoneyGain, DMS_Bandit_Vehicle_RepGain.
• Changed default value of DMS_Bandit_Static_MoneyGain to 75, DMS_Bandit_Static_RepGain to 15.
• NEW FUNCTION: DMS_fnc_SpawnAIVehicle.
• You can now spawn AI in vehicles.
• Improved cleanup method for AI in static guns.
• Working on improving OnKilled EH for AI in vehicles.
• FindSafePos should no longer check for parameters if the corresponding blacklist radius is set to 0.

September 13, 2015 (11:45 PM CST-America):

• Updated parameter type for "DMS_dynamicText_Size", as well as commented out description for "dynamicTextRequest". Will try to work on functionality for it soon.
• Improved cleaning of AI units. There may still be issues, specifically with launchers. If there are, please let me know, and test it. The more info I have, the quicker it can be fixed :)

September 13, 2015 (1:00 AM CST-America):

• New config value: DMS_AI_WP_Radius_base . Tiny waypoint radius for "base defence".
• New mission: "mercbase". Known issue: Stuff gets messed up when the mission spawns on a steep slope. Blame BIS for breaking "BIS_fnc_findSafePos" :P
• Added Taviana map safe pos params. (thanks JamieKG!)
• New functions: "DMS_fnc_CalcPos" and "DMS_fnc_ImportFromM3E".
• You can now import bases from Maca's awesome M3 Editor! Simply create the file under the "objects" folder, then call "DMS_fnc_ImportFromM3E"! Refer to the new "mercbase" mission as an example.
• "DMS_fnc_ImportFromM3E" supports static position (make sure you pass [0,0,0] as the second parameter), relative position, as well as bank/pitch. In addition, you get parameter parsing, just like any other DMS function, so if you're messing around with stuff and make a mistake, it will tell you ;)
• You can now specify which gun that an static AI spawns with.

September 12, 2015 (1:30 AM CST-America):

• Added Esseker map safe pos params. (thanks Flowrider!)

September 11, 2015 (8:30 PM CST-America):

• NEW CONFIG VALUES: DMS_GodmodeCrates and DMS_CrateCase_Sniper. DMS_GodmodeCrates is pretty self-explanatory :P
• NEW FEATURE FOR "DMS_fnc_FillCrate": You can now define "crate cases" in the config (such as "DMS_CrateCase_Sniper"). Passing the "crate case" name (such as "Sniper") will make the crate spawn with the exact gear defined in the config. Refer to the testmission.sqf (line 80) and "DMS_CrateCase_Sniper" config for an example.
• Spawned vehicles will now be LOCKED and INVINCIBLE until the mission is completed.
• Spawned vehicles spawn with 100% fuel.
• "Fixed" some cases where killing from a mounted gun would reset your money/respect (maybe).
• Fixed some spelling errors and incorrect names in some of the mission messages/markers.
• Fixed DMS_fnc_FindSafePos for Bornholm. If you have any issues with custom maps, please let us know.
• Fixed backpack spawning on the ground behind an AI unit that was supposed to get a launcher.

September 10, 2015 (6:00 PM CST-America):

• NEW CONFIG VALUES: DMS_MarkerPosRandomization, DMS_MarkerPosRandomRadius, and DMS_RandomMarkerBrush
• With the above configs, you can randomize the marker positions in a random position around the actual mission center.
• You can also "force" DMS_fnc_CreateMarker to randomize (or not randomize) the marker position with optional boolean parameter of index 3.
• Changed the default (non-randomized) circle marker "brush". It should be a solid circle.
• Created new functions DMS_fnc_SelectOffsetPos and DMS_fnc_SelectRandomVal
• Adjusted a couple functions to use them.
• Fixed DMS_fnc_IsNearWater.

September 9, 2015 (10:00 PM CST-America):

• Added static AI! The "donthasslethehoff" mission has them included by default. :D
• New config values: DMS_Bandit_Static_MoneyGain and DMS_Bandit_Static_RepGain.
• Future-proofed DMS_fnc_OnKilled. As a result, "DMS_BanditMoneyGainOnKill" is now DMS_Bandit_Soldier_MoneyGain, and "DMS_BanditRepGainOnKill" is now DMS_Bandit_Soldier_RepGain.
• Added config value DMS_ai_disable_ramming_damage. Check the comment for more info :)
• Removed config value "DMS_ai_static_skills"
• Randomized vehicle spawn position for "cardealer" mission.
• NOTE: If you use custom DMS_fnc_SpawnAISoldier calls, you will have to update your calling parameters! Make sure you add "Soldier" at the end of the array, or before _customGearSet if you're using it!
• Added _launcher option for _customGearSet in DMS_fnc_SpawnAISoldier. NOTE: This changes the order of the gearset parameters for the AI. _launcher is between _items and _helmet! Use empty string "" if you don't want any launcher on the AI unit.

September 8, 2015 (11:00 PM CST-America):

• AI Bodies should now be properly cleaned when run over (if configured to do so with DMS_remove_roadkill and DMS_remove_roadkill_chance).
• Added config option DMS_credit_roadkill. If set to true, players will get poptabs/respect for running over AI. Default: false.
• Fixed giving poptabs/respect for killing AI from vehicles. Passengers and mounted gunners should properly receive poptabs/respect when they kill AI.
• Launchers should now be reliably removed from AI bodies that have them.

September 7, 2015 (7:00 PM CST-America):

• AI bodies should now be cleared if configured to do so with "DMS_clear_AI_body" and "DMS_clear_AI_body_chance".

September 5, 2015 (1:00 AM CST-America):

• Created new function "DMS_fnc_IsPlayerNearby" to replace "ExileServer_util_position_isPlayerNearby".
• Fix IR Strobes spawning inside the crate and not appearing.

September 4, 2015 (11:20 PM CST-America):

• Improved crate handling by DMS. You can now spawn multiple crates with different loot, or simply no crates at all. (REQUIRES FILE CHANGES FOR EACH MISSION)
• Accounted for case sensitivity in switch-do statements for SpawnAISolder.
• Decreased default amount of money/respect gain on AI kills (Used to be 100 poptabs and 25 respect, it is now 50 poptabs and 10 respect)
• Define functions in config.cpp. This resulted in ALL FILES being changed to some degree.
• Fixed spawning Binocs and Rangefinders/Designators on AI.