Skip to content
BranchesTags

Repository files navigation

Root's Cyber Warfare

version build license

License

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:

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

About

Root's Cyberware - An Arma 3 addon that brings in cyberwarfare capabilities to both 3DEN Editor and Zeus Game Master

Resources

Readme
License
Activity

Stars

3 stars

Watchers

2 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages