Creamy_jpg-Customisable_Reticles_Framework icon

Customisable Reticles Framework

Framework for vmt based reticles with sway and recoil correction

Last updated a week ago
Total downloads 1748
Total rating 2 
Categories Client-side Mods
Dependency string Creamy_jpg-Customisable_Reticles_Framework-1.2.0
Dependants 6 other mods depend on this mod

This mod requires the following mods to function

northstar-Northstar-1.12.0 icon

Titanfall 2 modding and custom server framework.

Preferred version: 1.12.0
EladNLG-ModSettings-2.0.2 icon

A mod that adds a settings menu for modders to add their own settings in - with a filter to find certain ones easily.

Preferred version: 2.0.2


Customisable reticles framework

Version v1.2.0


- fixed ammo_counter_meter (broke when put on multiple bodygroups)
- added aog_r1 to proto_viewmodel_test selection
- adjusted default color/style values for most of the scopes
- proto_viewmodel_test now supports all reticles/ammo_counters/field_emitters
- updated gallery

Update info for mdlshitters:
All scopes now share a single ammo_counter material, please update your models

📲Contact info:

Discord id: Creamy#5877
NS Discord Server:
 For Crashes - Please refer #modding_chat and @ me, before creating a ticket for the support team
 For Skins   - Please refer to #skin_chat and make sure to @ me


This mod adds vmts/vtfs for customisable reticles as well as convars for modsettings to use.

All transformations to reticles can be done via console, all convars start with 'CRM.'

This mod reqiures a modder to implement vmts into their model, this mod does not work on vanilla weapons.

In order to use presets you need to input ie 'exec crf_fov96', if your fov is not on a list fear not, just play around with one of the scopes and create your own custom scalar based on theese values then simply save the your .cfg file in [ns mod folder]/CustomReticlesFramework/mod/cfg

Example cfg used for fov_scale "1.7"

CRM.hcog2_offset_scalar 0.875
CRM.acgs_offset_scalar 0.875 
CRM.aog_r1_offset_scalar 0.875 
CRM.aog_r2_offset_scalar 0.875
CRM.cro_offset_scalar 0.875
CRM.r201_front_offset_scalar  0.875
CRM.vinson_front_offset_scalar 0.875

How to check all offset presets using proto_viewmodel_test

To test all of the avaible sights you need to launch private match whith sv_cheats 1 enabled.

ass text

After you load into your map type in console give proto_viewmodel_test - this will show all avaible mods that can be equipped. Lastly equip the sight you'd like to preview.

ass text

list of avaible scopes:

give proto_viewmodel_test hcog
give proto_viewmodel_test redline_sight
give proto_viewmodel_test threat_scope
give proto_viewmodel_test holosight
give proto_viewmodel_test aog
give proto_viewmodel_test aog_r1
give proto_viewmodel_test cqh
give proto_viewmodel_test hcog_r1

To use this framework in your custom models download the .blend containing r201 with all base scopes or individual smd files from github link


Unfortunetely settings such as cl_fov_scale;viewmodel_fov;zoom_fov (or any other settings that modify your fov), will 100% break the default scaling, in order to adjust it use [...]offset_scalar convar to fit your preference or use one of the presets mentioned above :p

Some .qc files need additionall $attachments like aog_r1 which you can copy from here:

$attachment "AOG_R1_FRONT" "def_c_scope_aog_r1" 0 1.685 -1.55 rotate -90 -90 0
$attachment "AOG_R1_REAR" "def_c_scope_aog_r1" 0 1.685 -1.56 rotate -90 -90 0

This is just a preview that was set up for 1.6 fov_scale, which is slightly [fov_scale 1 = 70fov; fov_scale 1.55 = 110fov]


8 styles of front reticles to choose from


ability to scale reticle


customisable base colour


reticle will be in sync with the crosshair/ center of the screen


RGB mode [can be assigned to toggle]


support for default colourblind modes

Featured scopes:

  • Holosight
  • acgs_sight
  • threat_scope
  • hcog2_sight
  • aog_r2_sight
  • aog_r1_sight
  • cqh_sight
  • hcog_r1


Install via thundersore/VTOL is preffered, but if you are installing this mod manually, install this skin as a MOD !!

📷 Gallery [all available types]


ass text


alt text


ass text


ass text


alt text


ass text


ass text


ass text


ass text Have fun <3

Deprecated changelogs

- added proper aog_r1 correction
- changed acgs_sight windage to accomodate for sway correction
- minor fixes
- added global killswitch for reticle offset
- added option to prioritize custom color over colorblind setting
- changed how Holo_scale works - now it'll adjust offset_scalar automatically
- added presets for most common fov values [enable by typing ie 'exec crf_fov96']
- updates
- added proto_viewmodel_test replacement for testing offsets
- added ui for r201/hemlok iron sights
- added cqh sight support
- added hcog_r1 support [titanfall 1 version]

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2023-1-22 1.2.0 938 Version 1.2.0 Install
2023-1-21 1.1.0 176 Version 1.1.0 Install
2023-1-14 1.0.1 355 Version 1.0.1 Install
2023-1-14 1.0.0 24 Version 1.0.0 Install
2023-1-6 0.0.2 171 Version 0.0.2 Install
2023-1-4 0.0.1 84 Version 0.0.1 Install