Weapon Collimator Creation – Arma Reforger

From Bohemia Interactive Community
Revision as of 12:34, 13 July 2023 by Reyhard (talk | contribs) (Created page with "{{TOC|side}} ==Tutorial Goal== In this tutorial you will learn about: *Adjusting collimator mesh & UVs *Proper placement of sockets for collimator related functionality *Col...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Tutorial Goal

In this tutorial you will learn about:

  • Adjusting collimator mesh & UVs
  • Proper placement of sockets for collimator related functionality
  • Collimator material configuration
  • Collimator prefab configuration
ⓘ
If you don't have any experience with Workbench yet, it is recommended to go through modded weapon tutorial to familiarize with some of the concepts present in the Workbench.
📥
Sources files for this tutorial can be found at Arma Reforger Samples Github repository.

Structure Preparation

While sticking to official structure is not mandatory and there are no engine restrictions asset wise about it, it is recommended to follow guidelines listed here - Data (file) structure - to ensure that all automation plugins are parsing your assets correctly and make it later easy to navigate.

Therefore, your first task will be preparing following file structure

armareforger-new-weapon-collimator-structure.png

Model Preparation

The model must be prepared in Blender accordingly. Besides the normal setup of colliders, optics memory points and weapon snap point there are two additional considerations

Plane UV

We need a grayscale reticle texture of square aspect ratio with the "aimpoint" in the center. The geometry of the projection plane needs to extend all the way to the edge of the texture (for now). See the image below for an idea on how this should look

Note that if the model's geometry allows it, you can use a simple rectangular projection plane instead, but it cannot "stick out" of the casing. Some optics like the Russian OKP-7 which have a completely open projection plane must be shaped accordingly.

  • armareforger-new-weapon-collimator-uv-1.png
  • armareforger-new-weapon-collimator-uv-2.png
  • armareforger-new-weapon-collimator-uv-3.png

Geometry Definition

In the prefab for the collimator, you will need to define the upper and lower edge of the projection plane. While this can be done without any memory points, using two empties is the easiest and most precise way.

In examples below, collimator_BR (for bottom right) and collimator_TL (for top left) is used:

  • armareforger-new-weapon-collimator-sockets-1.png
  • armareforger-new-weapon-collimator-sockets-2.png
  • armareforger-new-weapon-collimator-sockets-3.png
ⓘ
Don't forget to import sockets by checking Export Scene Hierarchy option in Import Settings of the model - without that, your sockets won't be imported.

Since collimator plane need to use separate material, don't forget to assign different material to this selection.

armareforger-new-weapon-collimator-material-slot.png

The rest of the model is the same as usual - you can find more info about mesh configuration (including RIS setup) and import procedure in Weapon Optic Creation tutorial.

Reticle Material

Basic material settings

Once model is imported and material is created, it is time to start work on material. If you named your material in model "collimator" then by default, a new Enfusion material called .emat will be created in Data folder next to the FBX file. This new material is also using PBRBasic class which is more than sufficient for collimator reticle.

armareforger-new-weapon-collimator-material-settings1.png

Open collimator material and then in Basic material maps and its modifiers section assign black and white texture (where black represents transparent pixels) to Opacity Map field. It is possible to assign multiple textures - this can be done by expanding textures parameter and then adding new entries in the array via plus button.

In theory, for an addon you can have one "master collimator" material that contains all possible reticles, since we will be able to "filter" them later in the prefab config. It is also possible to switch between reticles via API which is provided SCR_CollimatorSightsComponent although keep in mind, that such feature is not implemented in vanilla game.

After setting reticle (or multiple reticles), make sure to set ClampU and ClampV so that the texture does not wrap.


Next, in General section of the material settings, modify following properties

  • Change Sort to Translucent
  • Disable Cast Shadow & Receive Shadow properties
  • Add TCModFunc array in the general section, click the "+" sign and add a TCModShift & TCModScale to it.
  • Change Blend Mode to AlphaBlend
  • Adjust Alpha Test & Alpha Mul to achieve desired reticle transparency
✩
Optional: You can set Color, Emissive color and EmissiveLV. The emissive color should match the one set in the color settings, and EmissiveLV should be around 9, depending on the reticle. Go by taste. Keep in mind that those settings are overwritten by the prefab settings and they only serve as some quick preview of the settings. Restart of the Workbench is required after fiddling with those boxes - see warning infobox in Manual Material Corrections paragraph.

Manual Material Corrections

Unfortunately, at the time of writing, there is no way to set script bindings within the workbench, everything needs to be done in a text editor. You need to load the emat file into a text editor and manually add the following segments

⚠
This manual tweak is also necessary when inheriting from material with such tweaks. In most cases though, it is enough to copy paste Refs section

After opening .emat file in text editor, located TCModFuncs segment and Refs segments to both TCModShift & TCModScale classes (you can also paste & replace whole TCModFunc segment)

 TCModFuncs {
  TCModShift "{5CDCD917EA1E1A1B}" {
   ShiftU 0
   ShiftV 0
   Refs {
   "ShiftU" "SCR_CollimatorControllerComponent.m_fUCoord"
   "ShiftV" "SCR_CollimatorControllerComponent.m_fVCoord"
   } 
  }
  TCModScale "{5D60B8B11F689A05}" {
    ScaleU 1
    ScaleV 1
    CenterU 0.5
    CenterV 0.5
    Refs {
      "ScaleU" "SCR_CollimatorControllerComponent.m_fUScale"
      "ScaleV" "SCR_CollimatorControllerComponent.m_fVScale"
    }
  }
 }

Next ,copy paste those refs at the bottom of the material:

 Refs {
  "Color"
  "SCR_CollimatorControllerComponent.m_vColor"
  "Emissive"
  "SCR_CollimatorControllerComponent.m_vEmissive"
  "EmissiveLV"
  "SCR_CollimatorControllerComponent.m_fEmissiveLV"
  "OpacityMap"
  "SCR_CollimatorControllerComponent.m_ReticleMap"
 }
⚠
Also note that while the Refs at the bottom gets saved when you save the emat in Workbench, the one at the top (inside the TCModShift) will not, so you will have to add them again if you make changes.

Full material example 

MatPBRBasic {
 Color 1 0 0 1
 Emissive 1 0 0 0
 EmissiveLV 9.538
 ApplyAlbedoToEmissive 0
 Sort translucent
 CastShadow 0
 ReceiveShadow 0
 TCModFuncs {
  TCModShift "{5CDCD917EA1E1A1B}" {
   ShiftU 0
   ShiftV 0
   Refs {
   "ShiftU" "SCR_CollimatorControllerComponent.m_fUCoord"
   "ShiftV" "SCR_CollimatorControllerComponent.m_fVCoord"
   } 
  }
  TCModScale "{5D60B8B11F689A05}" {
    ScaleU 1
    ScaleV 1
    CenterU 0.5
    CenterV 0.5
    Refs {
      "ScaleU" "SCR_CollimatorControllerComponent.m_fUScale"
      "ScaleV" "SCR_CollimatorControllerComponent.m_fVScale"
    }
  }
 }
 AlphaTest 0.088
 AlphaMul 0.707
 BlendMode AlphaBlend
 OpacityMap "{C9DCB787E3AA1C41}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_dot_A.edds" "{2BBE7CC9FAEEC02B}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_chevron_A.edds" clampu clampv anim( 0 )
 Refs {
  "Color"
  "SCR_CollimatorControllerComponent.m_vColor"
  "Emissive"
  "SCR_CollimatorControllerComponent.m_vEmissive"
  "EmissiveLV"
  "SCR_CollimatorControllerComponent.m_fEmissiveLV"
  "OpacityMap"
  "SCR_CollimatorControllerComponent.m_ReticleMap"
 }
}
↑ Back to spoiler's top
MatPBRBasic {
 Color 1 0 0 1
 Emissive 1 0 0 0
 EmissiveLV 9.538
 ApplyAlbedoToEmissive 0
 Sort translucent
 CastShadow 0
 ReceiveShadow 0
 TCModFuncs {
  TCModShift "{5CDCD917EA1E1A1B}" {
   ShiftU 0
   ShiftV 0
   Refs {
   "ShiftU" "SCR_CollimatorControllerComponent.m_fUCoord"
   "ShiftV" "SCR_CollimatorControllerComponent.m_fVCoord"
   } 
  }
  TCModScale "{5D60B8B11F689A05}" {
    ScaleU 1
    ScaleV 1
    CenterU 0.5
    CenterV 0.5
    Refs {
      "ScaleU" "SCR_CollimatorControllerComponent.m_fUScale"
      "ScaleV" "SCR_CollimatorControllerComponent.m_fVScale"
    }
  }
 }
 AlphaTest 0.088
 AlphaMul 0.707
 BlendMode AlphaBlend
 OpacityMap "{C9DCB787E3AA1C41}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_dot_A.edds" "{2BBE7CC9FAEEC02B}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_chevron_A.edds" clampu clampv anim( 0 )
 Refs {
  "Color"
  "SCR_CollimatorControllerComponent.m_vColor"
  "Emissive"
  "SCR_CollimatorControllerComponent.m_vEmissive"
  "EmissiveLV"
  "SCR_CollimatorControllerComponent.m_fEmissiveLV"
  "OpacityMap"
  "SCR_CollimatorControllerComponent.m_ReticleMap"
 }
}
↑ Back to spoiler's top


MatPBRBasic {
 Color 1 0 0 1
 Emissive 1 0 0 0
 EmissiveLV 9.538
 ApplyAlbedoToEmissive 0
 Sort translucent
 CastShadow 0
 ReceiveShadow 0
 TCModFuncs {
  TCModShift "{5CDCD917EA1E1A1B}" {
   ShiftU 0
   ShiftV 0
   Refs {
   "ShiftU" "SCR_CollimatorControllerComponent.m_fUCoord"
   "ShiftV" "SCR_CollimatorControllerComponent.m_fVCoord"
   } 
  }
  TCModScale "{5D60B8B11F689A05}" {
    ScaleU 1
    ScaleV 1
    CenterU 0.5
    CenterV 0.5
    Refs {
      "ScaleU" "SCR_CollimatorControllerComponent.m_fUScale"
      "ScaleV" "SCR_CollimatorControllerComponent.m_fVScale"
    }
  }
 }
 AlphaTest 0.088
 AlphaMul 0.707
 BlendMode AlphaBlend
 OpacityMap "{C9DCB787E3AA1C41}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_dot_A.edds" "{2BBE7CC9FAEEC02B}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_chevron_A.edds" clampu clampv anim( 0 )
 Refs {
  "Color"
  "SCR_CollimatorControllerComponent.m_vColor"
  "Emissive"
  "SCR_CollimatorControllerComponent.m_vEmissive"
  "EmissiveLV"
  "SCR_CollimatorControllerComponent.m_fEmissiveLV"
  "OpacityMap"
  "SCR_CollimatorControllerComponent.m_ReticleMap"
 }
}
↑ Back to spoiler's top


MatPBRBasic {
 Color 1 0 0 1
 Emissive 1 0 0 0
 EmissiveLV 9.538
 ApplyAlbedoToEmissive 0
 Sort translucent
 CastShadow 0
 ReceiveShadow 0
 TCModFuncs {
  TCModShift "{5CDCD917EA1E1A1B}" {
   ShiftU 0
   ShiftV 0
   Refs {
   "ShiftU" "SCR_CollimatorControllerComponent.m_fUCoord"
   "ShiftV" "SCR_CollimatorControllerComponent.m_fVCoord"
   } 
  }
  TCModScale "{5D60B8B11F689A05}" {
    ScaleU 1
    ScaleV 1
    CenterU 0.5
    CenterV 0.5
    Refs {
      "ScaleU" "SCR_CollimatorControllerComponent.m_fUScale"
      "ScaleV" "SCR_CollimatorControllerComponent.m_fVScale"
    }
  }
 }
 AlphaTest 0.088
 AlphaMul 0.707
 BlendMode AlphaBlend
 OpacityMap "{C9DCB787E3AA1C41}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_dot_A.edds" "{2BBE7CC9FAEEC02B}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_chevron_A.edds" clampu clampv anim( 0 )
 Refs {
  "Color"
  "SCR_CollimatorControllerComponent.m_vColor"
  "Emissive"
  "SCR_CollimatorControllerComponent.m_vEmissive"
  "EmissiveLV"
  "SCR_CollimatorControllerComponent.m_fEmissiveLV"
  "OpacityMap"
  "SCR_CollimatorControllerComponent.m_ReticleMap"
 }
}
↑ Back to spoiler's top


MatPBRBasic {
 Color 1 0 0 1
 Emissive 1 0 0 0
 EmissiveLV 9.538
 ApplyAlbedoToEmissive 0
 Sort translucent
 CastShadow 0
 ReceiveShadow 0
 TCModFuncs {
  TCModShift "{5CDCD917EA1E1A1B}" {
   ShiftU 0
   ShiftV 0
   Refs {
   "ShiftU" "SCR_CollimatorControllerComponent.m_fUCoord"
   "ShiftV" "SCR_CollimatorControllerComponent.m_fVCoord"
   } 
  }
  TCModScale "{5D60B8B11F689A05}" {
    ScaleU 1
    ScaleV 1
    CenterU 0.5
    CenterV 0.5
    Refs {
      "ScaleU" "SCR_CollimatorControllerComponent.m_fUScale"
      "ScaleV" "SCR_CollimatorControllerComponent.m_fVScale"
    }
  }
 }
 AlphaTest 0.088
 AlphaMul 0.707
 BlendMode AlphaBlend
 OpacityMap "{C9DCB787E3AA1C41}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_dot_A.edds" "{2BBE7CC9FAEEC02B}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_chevron_A.edds" clampu clampv anim( 0 )
 Refs {
  "Color"
  "SCR_CollimatorControllerComponent.m_vColor"
  "Emissive"
  "SCR_CollimatorControllerComponent.m_vEmissive"
  "EmissiveLV"
  "SCR_CollimatorControllerComponent.m_fEmissiveLV"
  "OpacityMap"
  "SCR_CollimatorControllerComponent.m_ReticleMap"
 }
}
↑ Back to spoiler's top


MatPBRBasic {
 Color 1 0 0 1
 Emissive 1 0 0 0
 EmissiveLV 9.538
 ApplyAlbedoToEmissive 0
 Sort translucent
 CastShadow 0
 ReceiveShadow 0
 TCModFuncs {
  TCModShift "{5CDCD917EA1E1A1B}" {
   ShiftU 0
   ShiftV 0
   Refs {
   "ShiftU" "SCR_CollimatorControllerComponent.m_fUCoord"
   "ShiftV" "SCR_CollimatorControllerComponent.m_fVCoord"
   } 
  }
  TCModScale "{5D60B8B11F689A05}" {
    ScaleU 1
    ScaleV 1
    CenterU 0.5
    CenterV 0.5
    Refs {
      "ScaleU" "SCR_CollimatorControllerComponent.m_fUScale"
      "ScaleV" "SCR_CollimatorControllerComponent.m_fVScale"
    }
  }
 }
 AlphaTest 0.088
 AlphaMul 0.707
 BlendMode AlphaBlend
 OpacityMap "{C9DCB787E3AA1C41}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_dot_A.edds" "{2BBE7CC9FAEEC02B}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_chevron_A.edds" clampu clampv anim( 0 )
 Refs {
  "Color"
  "SCR_CollimatorControllerComponent.m_vColor"
  "Emissive"
  "SCR_CollimatorControllerComponent.m_vEmissive"
  "EmissiveLV"
  "SCR_CollimatorControllerComponent.m_fEmissiveLV"
  "OpacityMap"
  "SCR_CollimatorControllerComponent.m_ReticleMap"
 }
}
↑ Back to spoiler's top


MatPBRBasic {
 Color 1 0 0 1
 Emissive 1 0 0 0
 EmissiveLV 9.538
 ApplyAlbedoToEmissive 0
 Sort translucent
 CastShadow 0
 ReceiveShadow 0
 TCModFuncs {
  TCModShift "{5CDCD917EA1E1A1B}" {
   ShiftU 0
   ShiftV 0
   Refs {
   "ShiftU" "SCR_CollimatorControllerComponent.m_fUCoord"
   "ShiftV" "SCR_CollimatorControllerComponent.m_fVCoord"
   } 
  }
  TCModScale "{5D60B8B11F689A05}" {
    ScaleU 1
    ScaleV 1
    CenterU 0.5
    CenterV 0.5
    Refs {
      "ScaleU" "SCR_CollimatorControllerComponent.m_fUScale"
      "ScaleV" "SCR_CollimatorControllerComponent.m_fVScale"
    }
  }
 }
 AlphaTest 0.088
 AlphaMul 0.707
 BlendMode AlphaBlend
 OpacityMap "{C9DCB787E3AA1C41}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_dot_A.edds" "{2BBE7CC9FAEEC02B}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_chevron_A.edds" clampu clampv anim( 0 )
 Refs {
  "Color"
  "SCR_CollimatorControllerComponent.m_vColor"
  "Emissive"
  "SCR_CollimatorControllerComponent.m_vEmissive"
  "EmissiveLV"
  "SCR_CollimatorControllerComponent.m_fEmissiveLV"
  "OpacityMap"
  "SCR_CollimatorControllerComponent.m_ReticleMap"
 }
}
↑ Back to spoiler's top
MatPBRBasic {
 Color 1 0 0 1
 Emissive 1 0 0 0
 EmissiveLV 9.538
 ApplyAlbedoToEmissive 0
 Sort translucent
 CastShadow 0
 ReceiveShadow 0
 TCModFuncs {
  TCModShift "{5CDCD917EA1E1A1B}" {
   ShiftU 0
   ShiftV 0
   Refs {
   "ShiftU" "SCR_CollimatorControllerComponent.m_fUCoord"
   "ShiftV" "SCR_CollimatorControllerComponent.m_fVCoord"
   } 
  }
  TCModScale "{5D60B8B11F689A05}" {
    ScaleU 1
    ScaleV 1
    CenterU 0.5
    CenterV 0.5
    Refs {
      "ScaleU" "SCR_CollimatorControllerComponent.m_fUScale"
      "ScaleV" "SCR_CollimatorControllerComponent.m_fVScale"
    }
  }
 }
 AlphaTest 0.088
 AlphaMul 0.707
 BlendMode AlphaBlend
 OpacityMap "{C9DCB787E3AA1C41}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_dot_A.edds" "{2BBE7CC9FAEEC02B}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_chevron_A.edds" clampu clampv anim( 0 )
 Refs {
  "Color"
  "SCR_CollimatorControllerComponent.m_vColor"
  "Emissive"
  "SCR_CollimatorControllerComponent.m_vEmissive"
  "EmissiveLV"
  "SCR_CollimatorControllerComponent.m_fEmissiveLV"
  "OpacityMap"
  "SCR_CollimatorControllerComponent.m_ReticleMap"
 }
}
↑ Back to spoiler's top
MatPBRBasic {
 Color 1 0 0 1
 Emissive 1 0 0 0
 EmissiveLV 9.538
 ApplyAlbedoToEmissive 0
 Sort translucent
 CastShadow 0
 ReceiveShadow 0
 TCModFuncs {
  TCModShift "{5CDCD917EA1E1A1B}" {
   ShiftU 0
   ShiftV 0
   Refs {
   "ShiftU" "SCR_CollimatorControllerComponent.m_fUCoord"
   "ShiftV" "SCR_CollimatorControllerComponent.m_fVCoord"
   } 
  }
  TCModScale "{5D60B8B11F689A05}" {
    ScaleU 1
    ScaleV 1
    CenterU 0.5
    CenterV 0.5
    Refs {
      "ScaleU" "SCR_CollimatorControllerComponent.m_fUScale"
      "ScaleV" "SCR_CollimatorControllerComponent.m_fVScale"
    }
  }
 }
 AlphaTest 0.088
 AlphaMul 0.707
 BlendMode AlphaBlend
 OpacityMap "{C9DCB787E3AA1C41}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_dot_A.edds" "{2BBE7CC9FAEEC02B}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_chevron_A.edds" clampu clampv anim( 0 )
 Refs {
  "Color"
  "SCR_CollimatorControllerComponent.m_vColor"
  "Emissive"
  "SCR_CollimatorControllerComponent.m_vEmissive"
  "EmissiveLV"
  "SCR_CollimatorControllerComponent.m_fEmissiveLV"
  "OpacityMap"
  "SCR_CollimatorControllerComponent.m_ReticleMap"
 }
}
↑ Back to spoiler's top
MatPBRBasic {
 Color 1 0 0 1
 Emissive 1 0 0 0
 EmissiveLV 9.538
 ApplyAlbedoToEmissive 0
 Sort translucent
 CastShadow 0
 ReceiveShadow 0
 TCModFuncs {
  TCModShift "{5CDCD917EA1E1A1B}" {
   ShiftU 0
   ShiftV 0
   Refs {
   "ShiftU" "SCR_CollimatorControllerComponent.m_fUCoord"
   "ShiftV" "SCR_CollimatorControllerComponent.m_fVCoord"
   } 
  }
  TCModScale "{5D60B8B11F689A05}" {
    ScaleU 1
    ScaleV 1
    CenterU 0.5
    CenterV 0.5
    Refs {
      "ScaleU" "SCR_CollimatorControllerComponent.m_fUScale"
      "ScaleV" "SCR_CollimatorControllerComponent.m_fVScale"
    }
  }
 }
 AlphaTest 0.088
 AlphaMul 0.707
 BlendMode AlphaBlend
 OpacityMap "{C9DCB787E3AA1C41}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_dot_A.edds" "{2BBE7CC9FAEEC02B}Assets/Weapons/Attachments/Optics/SampleCollimator_01/Data/collimator_chevron_A.edds" clampu clampv anim( 0 )
 Refs {
  "Color"
  "SCR_CollimatorControllerComponent.m_vColor"
  "Emissive"
  "SCR_CollimatorControllerComponent.m_vEmissive"
  "EmissiveLV"
  "SCR_CollimatorControllerComponent.m_fEmissiveLV"
  "OpacityMap"
  "SCR_CollimatorControllerComponent.m_ReticleMap"
 }
}
↑ Back to spoiler's top

When you are done with those modifications, save your changes in text editor and restart the Workbench.

⚠
Refs will stop to work every time you do some change, like modification of color or emissive value, in the material.
Full restart of Workbench is required to fix this issue.

Prefab

Creation

Collimator prefab setup is quite similar to regular optic as described in Weapon Optic Creation tutorial but there are some differences. Main difference is fact that WeaponOptic_Base.et contains SCR_2DPIPSightsComponent which is not desired in this case. Since you cannot delete inherited components and disabled prefabs still have some memory footprint, it is recommended to either:

In most cases, it will be easier to use 2nd method (duplication) for creation of the new prefab. Once new prefab is created and adjusted, don't forget to put it in some proper folder (check structure paragraph at the top of the page).

ⓘ
In future updates, base prefab for collimator sights might be added to the vanilla data.

Adding Components

Next, it will be necessary to add two, collimator specific, components to the prefab - SCR_CollimatorSightsComponent & SCR_CollimatorControllerComponent.

First, begin by adding SCR_CollimatorSightsComponent to collimator prefab, which is quite standard procedure. After that, it will be necessary to add SCR_CollimatorControllerComponent as a child component of SCR_CollimatorSightsComponent via Add child component action. If everything was done correctly, you should end up with something like this

armareforger-new-weapon-collimator-components.png

Configuration

SCR_CollimatorSightsComponent does not have any attributes that need to be taken care of, all set up is done in SCR_CollimatorSightsComponent.

Set up the sight points, eye point and all other parameters of the SCR_CollimatorSightsComponent normally - you can referer to Weapon Optic Tutorial for more info.

armareforger-new-weapon-collimator-basesights.png

ⓘ
The Front and Rear Sight Points are optional; if undefined the direction of the sight is calculated from the given Collimator projection plane (see below)
Collimator section

The "Collimator" category contains all the relevant settings and most of the work will be performed in this section:

  • Collimator Top Left, Collimator Bottom Right and Collimator Center:
    • These settings are used to define the projection plane of the collimator sight. The Top Left and Bottom right points are mandatory. The center point is optional, and it is highly recommended to leave it empty. You can specify bone names and offset or just a numerical offset in the PointInfo.
  • Collimator Aspect Ratio
    • Set to true by default, it specifies that the collimator reticle textures have a 1:1 aspect ratio. There is usually no good reason to disable this

Reticle Setup

Example showing proportions of reticle width to whole texture

Reticle Default Angular Size and Reticle Default Texture Portion

  • This defines the angular size of the reticle. A collimator reticle will always appear a certain size, regardless of how close the observer is to the projection plane. Angular size is specified in degrees. The default HWS Holo sight has a reticle angular size of 68 MOA (minutes of arc), which translates to about 1.13 degrees (60 MOA is one degree). This means that the reticle is approximately the size of a human at 100 meters distance.
  • Reticle Default Texture Portion describes how much of the given texture is actually covered by the reticle. Principle is same as described in Weapon Optic Tutorial. In the above case, the reticle is 9% of the entire texture (see image)
  • Note that both of these values can be overridden in the Reticle Infos array, see below. If any or both of these values are zero, then the reticle is taken "as-is" and no angular size adjustment is made at all.

Default Reticle Color and Reticle Colors array

The settings here are ignored if there are no reticle colors defined, and the settings of the emat are used. Otherwise the color in the emat is ignored and the default reticle color specifies the color used for the reticle. Each BaseCollimatorReticleColor entry has two color values, a reticle color and a glow color. The glow color is the emissive part of the material, while the reticle color is the base color used. They should normally be relatively close, but experimentation is possible.

Default Reticle Index and Reticle Info array

If the reticle info array is empty, then the default reticle index specifies the texture index in the emat texture array of the collimator material. Otherwise, the Default Reticle Index specifies the index into the Reticle Info array. The Reticle Infos array consists of BaseCollimatorReticleInfo structures. The first field, Reticle Index, specifies the texture index from the emat. The second field is a checkbox which defaults to off. If disabled like this, the angular size and reticle portion are taken from the specified default values. If checked, two new fields will appear - an override for the Reticle Default Angular Size and one for the Reticle Default Texture Portion. Again, either one of these set to 0 will disabled reticle angular size FOR THIS RETICLE only. The example in the picture below specifies three different reticles: The first one is using the default values with the first reticle texture in the emat. The second one overrides the angular size to be twice as big. The third one uses a different texture but does not override any of the angular size/portion settings.

Misc Parameters

  • ADS Activation/Deactivation percentage
    • The collimator sight is disabled when not aiming down sights to avoid unnecessary calculations. During the blend-in and blend-out of the Aim Down Sights, the sight is enabled. These two values give a percentage when the sights are enabled during the blend in. The default is 50% (0.5), which causes the reticle to "slide in" and "slide out" of view. If the sights are very open, a  smaller value might be required for either.
  • Daylight/Night brightness
    • These values specify the brightness of the glowy bits of the reticle during daytime or night time. The night time brightness is selected via the Reticle Illumination toggle feature also available on some scopes, only that this makes the reticle less bright, but the semantics are the same.
Retrieved from "https://community.bistudio.com/wiki?title=Arma_Reforger:Weapon_Collimator_Creation&oldid=343733"