client/addons/task

Forge Task Module

Overview

The Task module provides a comprehensive mission and objective system for the Forge client. It includes features for creating, managing, and tracking various types of tasks, with support for rewards, penalties, and mission completion conditions.

Dependencies

• forge_client_main

Authors

• J. Schmidt
• Creedcoder
• IDSolutions

Features

Task Types

1. Attack Tasks (fnc_attack.sqf)

   • Eliminate specific targets
   • Time-based objectives
   • Target escape prevention
   • Success/failure conditions
   • Reward system integration

2. Defend Tasks (fnc_defend.sqf)

   • Hold designated zones
   • Wave-based enemy attacks
   • Minimum force requirements
   • Time-based objectives
   • Zone control monitoring

3. Hostage Tasks (fnc_hostage.sqf)

   • Rescue hostages
   • Extraction zone management
   • Hostage protection
   • Time-based objectives
   • CBRN zone support

4. HVT Tasks (fnc_hvt.sqf)

   • Capture or eliminate HVTs
   • Extraction requirements
   • Target tracking
   • Success/failure conditions
   • Reward system integration

5. Defuse Tasks (fnc_defuse.sqf)

   • Defuse explosive devices
   • Time-based objectives
   • Success/failure conditions
   • Reward system integration
   • Explosive entity management

6. Delivery Tasks (fnc_delivery.sqf)

   • Transport objectives
   • Route management
   • Time-based delivery
   • Success/failure conditions
   • Reward system integration

Task Management

1. Task Configuration

   • Unique task IDs
   • Success/failure limits
   • Time limits
   • Reward settings
   • Mission end conditions

2. Reward System (fnc_handleTaskRewards.sqf)

   • Company funds
   • Reputation points
   • Equipment rewards
   • Supply rewards
   • Weapon rewards
   • Vehicle rewards
   • Special rewards

3. Task Tracking

   • Progress monitoring
   • State management
   • Objective tracking
   • Time tracking
   • Success/failure detection

Module System

1. Attack Module (fnc_attackModule.sqf)

   • Target configuration
   • Success/failure settings
   • Reward configuration
   • Time limit settings
   • Mission end conditions

2. Defend Module (fnc_defendModule.sqf)

   • Zone configuration
   • Wave settings
   • Force requirements
   • Reward configuration
   • Mission end conditions

3. Hostage Module (fnc_hostageModule.sqf)

   • Hostage configuration
   • Extraction settings
   • Time limit settings
   • Reward configuration
   • Mission end conditions

4. HVT Module (fnc_hvtModule.sqf)

   • Target configuration
   • Extraction settings
   • Success/failure settings
   • Reward configuration
   • Mission end conditions

5. Defuse Module (fnc_defuseModule.sqf)

   • Explosive configuration
   • Time limit settings
   • Success/failure settings
   • Reward configuration
   • Mission end conditions

Event Handlers

The module uses several event handlers for initialization and execution:

• XEH_preInit.sqf: Pre-initialization setup
• XEH_postInit.sqf: Post-initialization tasks
• XEH_preStart.sqf: Pre-start configuration

Usage

To use the task module:

// Create an attack task
["task_attack_1", 1, 2, 1500000, -75, 375, false, false] spawn forge_client_task_fnc_attack;

// Create a defend task
["task_defend_1", "defend_marker", 900, 500000, -100, 400, false, false, 3, 300, 1] spawn forge_client_task_fnc_defend;

// Create a hostage task
["task_hostage_1", 1, 2, "extract_marker", 1500000, -75, 500, [false, true], false, false] spawn forge_client_task_fnc_hostage;

// Create an HVT task
["task_hvt_1", 1, 2, "extract_marker", 1500000, -75, 500, false, false] spawn forge_client_task_fnc_hvt;

Integration

The task module integrates with other Forge client systems:

1. Organization System

   • Fund management
   • Reputation tracking
   • Asset rewards
   • Transaction processing
   • Balance updates

2. Notification System

   • Task assignments
   • Progress updates
   • Success/failure alerts
   • Reward notifications
   • Mission end notifications

3. Mission System

   • Mission success/failure
   • End conditions
   • State management
   • Progress tracking
   • Objective management

Debugging

Debug mode can be enabled by uncommenting the following in script_component.hpp:

#define DEBUG_MODE_FULL

Version Information

Version information is managed through the main Forge client system configuration.

Technical Details

• Real-time task monitoring
• Multi-objective support
• Reward system integration
• State management
• Progress tracking
• Time management
• Cross-module integration
• Event system integration
• Notification handling
• Error management
• Resource management
• Mission control
• Objective validation