2-7 Guidance System

2-7 Advanced Guidance System

The 2-7 Advanced Guidance System is a comprehensive, expanding framework for Arma Reforger that introduces highly realistic and advanced guidance mechanics for missiles and artillery. Designed with a strict focus on server performance (FPS-independent physics), tactical depth, and realistic environmental occlusion.

This package currently includes fully functional Semi-Active Laser Homing (SALH), autonomous Fire-and-Forget (FnF) with a custom HUD UI, and GPS guidance for precision artillery strikes. 

ROADMAP / PLANNED FEATURES
The framework is actively being developed. Future updates will introduce:
* LOFT for missiles
* Radar Systems (Search & Track)
* Wired / SACLOS Guidance
* Active Protection Systems (APS)

CURRENT FEATURES
* Volumetric Smoke Occlusion: Smoke grenades and smoke screens physically block laser beams and blind the optical/IR sensors of FnF missiles.
* Advanced Ballistics & Flight Profiles: Missiles fully support dynamic Lead (intercepting moving targets).
* Smart Raycasting: The system accurately distinguishes vehicle armor from surrounding terrain, trees, or buildings with zero performance impact.
* Realistic Cockpit UI: Visual HUD elements including an FOV limit indicator, real-time Estimated Time of Arrival (ETA), and a blind "Ghost Countdown" after firing.
* Multiplayer Ready: Tracking, seeker code cycling, and target synchronization are fully optimized for multiplayer environments.

INSTALLATION & MODDING GUIDE
To apply this system to your own custom vehicles or weapons, you need to attach the provided script components to your prefabs in the Workbench:

* Turrets / Launchers: Add the "P27_FnFSeekerComponent" (or Laser Designator equivalent) to your vehicle or turret entity.
* Missiles / Munitions: Add the "P27_FnFMissileComponent" (or Guided Missile Component) directly to your projectile prefab.
* UI / HUD: Add the "P27_FnFLockUIComponent" to your vehicle's screen layout to enable the crosshair and ETA timers.

IMPORTANT - EMITTER ALIGNMENT: 
If you notice that the Field of View (FOV) cone or the raycast is originating from the wrong place (e.g., the center of the turret instead of the camera), utilize the component attributes. You can input the specific weapon bone name in "m_sBoneName". If the origin is still slightly misaligned from your visual emitter, use the "m_vPositionOffset" attribute (X, Y, Z coordinates) to manually shift and pivot the exact starting point of the guidance ray to achieve pixel-perfect accuracy.

USER MANUAL & SYSTEM BREAKDOWN

1. FIRE-AND-FORGET (FnF) SYSTEM
Autonomous system for smart munitions where the missile takes over guidance immediately after launch.
* Lock-On: Aim your turret/optic at an enemy vehicle or infantry. The HUD will show an FOV indicator if the target is within your vehicle's forward view limit. Press your bound "Lock Target" action.
* Tracking: A lock crosshair and estimated time of impact (ETA) in seconds will appear. If the target drives behind a building, hill, or deploys smoke, the system will lose the lock.
* Fire (Forget): Upon firing, the turret automatically clears its target memory, freeing it for the next missile. The launched missile now tracks the target independently, and your HUD will display a blind countdown to impact.

2. LASER GUIDANCE (SALH / Laser Designator)
Requires constant laser illumination of the target until impact.
* Designating: A ground unit, drone, or the pilot must activate the laser and keep it painted on the target.
* Laser Codes: The weapon system (Seeker Code) must be set to the exact same code as the laser designator (default is 1111). You can cycle codes using the "Cycle Seeker Code" action.
* Limitations: If the laser beam is interrupted by a tree, building, or smoke screen, the missile will lose the reflection and fall ballistically.

3. GPS / ARTILLERY FIRE CONTROL
Guidance system for Non-Line-of-Sight (NLOS) precision strikes.
* Allows artillery platforms to receive exact GPS coordinates. The munition calculates a ballistic trajectory to navigate directly to the designated point.
* Ideal for heavy howitzers, mortars, and MLRS platforms.

INTEGRATION & SHOWCASE
This mod serves as both a standalone framework and a ready-to-use solution.

Included in this release, the guidance system is already fully integrated and functional on various munitions from the well-known WCS mod, as well as actively deployed on systems within the "2-7 SelfPropelled Artillery" mod. You can use these weapons immediately in combat or inspect the files to see how easily the components can be attached to your own custom models.

CONTACT & SUPPORT
Do you want to implement the 2-7 Guidance System into your own weapon mod, aircraft, helicopter, or artillery, but need help? Or did you find a bug?
Feel free to contact me directly on Discord!

Discord: edexus1k