Root's Cyber Warfare

An improved adaptation and expansion of the original Cyber Warfare mod, adding advanced hacking capabilities to Arma 3 missions. Control doors, lights, vehicles, drones, and more through a terminal interface powered by AE3 ArmaOS.

Features

Root's Cyber Warfare introduces 8 distinct device types that can be hacked and controlled via laptop terminals:

• Building Doors - Lock and unlock doors remotely, prevent ACE breaching
• Lights - Control building and street lights on/off
• Drones (UAVs) - Change faction allegiance or disable enemy drones
• Vehicles - Manipulate fuel, speed, brakes, lights, engine, and alarms with customizable limits
• Databases - Download files with optional code execution
• Custom Devices - Create custom scripted devices with activation/deactivation code
• GPS Trackers - Track objects in real-time with configurable update frequencies
• Power Grids - Control lights in radius with optional explosion effects

Key Capabilities

• Desktop GUI and Terminal CLI - All operations can be performed using the Desktop (GUI) or Terminal (CLI)
• Power Management System - All operations consume battery power (configurable costs in Wh)
• Flexible Access Control - Link devices to specific computers or make them public
• Customizable Operation Limits - Set min/max ranges for vehicle operations, toggle counts, and cooldown timers
• Zeus & 3DEN Support - 9 Zeus modules and 8 3DEN editor modules for easy setup
• ACE Integration - GPS tracker attachment via ACE interaction menu
• Programmable Devices - Custom devices with SQF activation/deactivation scripts
• Mission Maker API - Full programmatic access for dynamic scenarios

Requirements

Dependencies (Required)

• CBA_A3 - Community Base Addons
• ACE3 - Advanced Combat Environment 3
• AE3 - Advanced Equipment 3 (ArmaOS)
• ZEN - Zeus Enhanced

Installation

Steam Workshop

1. Subscribe to Root's Cyber Warfare on Steam Workshop (Development Build / Release Build) - link at the bottom of this page
2. Subscribe to all required dependencies (CBA, ACE3, AE3, ZEN)
3. Launch Arma 3 and enable the mod in the launcher

Manual Installation

1. Download the latest release from GitHub Releases
2. Extract the @root_cyberwarfare folder to your Arma 3 directory
3. Add -mod=@CBA_A3;@ace;@AE3;@zen;@root_cyberwarfare to your launch parameters

Quick Start

For Players

1. Open ACE interaction menu on an AE3 laptop (Windows key or ACE self-interact)
2. Select ArmaOS -> Use
3. Type devices all to list all hackable devices you have access to
4. Use specific commands to control devices (e.g., door 1234 a unlock)
5. Type <command> help or <command> -h for detailed command syntax and examples

Available Commands:

• devices help - List device types and usage
• door help - Lock/unlock doors
• light help - Control lights
• vehicle help - Manipulate vehicles
• changedrone help - Change drone faction
• disabledrone help - Destroy drones
• download help - Download database files
• custom help - Activate custom devices
• gpstrack help - Track GPS devices
• powergrid help - Control power grids

For Zeus Curators

1. Open Zeus interface (Y key by default)
2. Find Root's Cyber Warfare category in modules
3. Use Add Hacking Tools module on a laptop
4. Use Add Hackable Object/Vehicle/etc. modules to register devices
5. Players can now hack those devices from the laptop

Zeus Module Features:

• Terrain Object Placement: Place modules directly on terrain objects (buildings, vehicles, etc.) to register them
• Radius Mode: Place modules on empty ground to register all compatible objects within a configurable radius
• Bulk Registration: Use radius mode to quickly register multiple devices at once (buildings, lights, vehicles, drones)

For Mission Makers

// Add hacking tools to a laptop
[_laptop, "/network/tools", 0, "HackStation", ""] remoteExec ["Root_fnc_addHackingToolsZeusMain", 2];

// Register a building with doors as hackable
[_building, 0, [], false, false] remoteExec ["Root_fnc_addDeviceZeusMain", 2];

// Register a vehicle with full control and custom limits
[_vehicle, 0, [], "TargetCar", true, true, false, true, true, false, false, 2, 20, 80, -30, 30, 2, 8, 5, 10, 3, 5, 2, 20]
    remoteExec ["Root_fnc_addVehicleZeusMain", 2];
// Limits: Fuel 20-80%, Speed -30 to 30 km/h, Brakes 2-8 m/s², Lights max 5 toggles/10s cooldown, Engine max 3 toggles/5s cooldown, Alarm 2-20s

Examples

Example 1: Mission with Hackable Building

// initServer.sqf
// Setup hacking laptop
private _laptop = _laptop1; // Reference to AE3 laptop placed in editor
[_laptop, "/home/hacker/tools", 0, "HackingStation", ""] remoteExec ["Root_fnc_addHackingToolsZeusMain", 2];

// Make a building hackable
private _building = nearestBuilding player;
[_building, 0, [netId _laptop], false, false] remoteExec ["Root_fnc_addDeviceZeusMain", 2];

// Players can now use the laptop to lock/unlock doors:
// door <BuildingID> <DoorID> lock/unlock

Example 2: GPS Tracking Mission

// Attach GPS tracker to enemy vehicle
private _enemyVehicle = _vehicle1;
[_enemyVehicle, 0, [netId _laptop1], "Enemy_Car", 120, 5, "", false, true, 30, 5, true, [[], [], []]]
    remoteExec ["Root_fnc_addGPSTrackerZeusMain", 2];

// Players use: gpstrack <TrackerID>
// Map markers update every 5 seconds for 120 seconds

Example 3: Custom Device (Alarm System)

// Create custom alarm device on an object
private _alarmBox = _object1;
[
    _alarmBox,
    0,
    [netId _laptop1],
    "Base Alarm",
    "playSound3D ['a3\sounds_f\sfx\alarm.wss', _this select 0, false, getPosASL (_this select 0), 5, 1, 300];",
    "hint 'Alarm deactivated';",
    false
] remoteExec ["Root_fnc_addCustomDeviceZeusMain", 2];

// Activation code plays alarm sound, deactivation shows hint

Documentation

Comprehensive documentation is available in the Wiki:

• Player Guide - Terminal commands and GPS tracker mechanics
• Zeus Guide - All Zeus modules with parameters
• Eden Editor Guide - 3DEN modules and synchronization
• Mission Maker Guide - Scripting API and examples
• API Reference - Complete function reference
• Architecture - Technical implementation details
• Configuration - CBA settings reference

Contributing

Contributions are welcome! Please follow these guidelines:

1. Report Bugs - Use GitHub Issues with detailed reproduction steps
2. Suggest Features - Open an issue with the enhancement label
3. Submit Pull Requests:
   • Fork the repository
   • Create a feature branch (git checkout -b feature/YourFeature)
   • Follow existing code style and patterns
   • Run hemtt check -p to validate SQF code
   • Ensure all HEMTT linting passes with no errors
   • Update documentation if adding new features
   • Submit PR with clear description

Development Requirements

• HEMTT - Build tool for Arma 3 mods
• Run hemtt dev to build and symlink to Arma 3 directory
• Run hemtt check -p to validate code before committing

License

This project is licensed under the Arma Public License - Share Alike (APL-SA).

Key terms:

• Attribution - Credit must be given to the original author (Root)
• Non-Commercial - Cannot be used for commercial purposes
• Arma Only - Can only be used in Arma games
• Share Alike - Derivative works must use the same license

See LICENSE file for full terms.

Credits

• Root (xMidnightSnowx) - Development and maintenance
• Mister Adrian - Original Cyber Warfare mod creator
• 77th JSOC - Bug reports, feature suggestions, and testing

Links

• GitHub Repository
• Steam Workshop (DEVELOPMENT BUILD)
• Steam Workshop (PUBLIC RELEASE)
• Issue Tracker
• Discord