Sight Customisation

MUTATOR NAME: CUSTOMSIGHTS

This mod adds a menu to the loadout screen which allows you to modify some properties of your sight reticle and laser sight for compatible weapons/optics.

---

USAGE

OPTICS

You can modify the shape, colour and size of the reticle for 1x, 2x and back-up sights. For other scopes you can change the reticle only. The "spanner" customise button icon will show next to the "Optics" upgrade selection for compatible attachments. Click it to open the menu.

Scope and back-up sight customisation can be configured separately for the same optic, if supported.

The "Scale" and "Brightness" options are relative adjustments to the original sight properties. This means there may be some inconsistency in the scaling/brightness if you use the same setting across different optics. For example, the pistol 1x optics are very bright compared to the others. Will try to normalise this.

LASER

You can modify the colour of regular laser sights for all weapons. The "spanner" customise button icon will show next to the "Siderail" upgrade selection for compatible attachments. Click it to open the menu. At some point I want to add more options, such as showing a solid beam, changing the pattern (tri-laser) and more, but this is work-in-progress.

Once you've made the changes you want, click "Apply" to save them. They will be applied to your weapon on next spawn/resupply. Think of the customisation like it's own "attachment" which is added to the weapon.

Customisations are stored for each weapon and sight combination separately. They are saved client-side to a file so should persist across restarts/map changes/servers.

CONFIG

For configuration options you can use the following. Mostly just for testing/debug.

[/CustomSights/Mutators/BP_Mutator_CustomSights.BP_Mutator_CustomSights_C] ; Enable/disable some debug logging messages in chat bDebug=False ; Enable/disable laser sight customisation independently from optics bEnableLasers=True

TROUBLESHOOTING

If you encounter any crashes or server disconnections, or your sight changes don't work after applying them, try the following workarounds:

FULLY RE-INSTALLING THE MOD MANUALLY CLIENT-SIDE

• Go to "<game install directory>/Insurgency/Mods/modio/"
• Delete the folder called "4453942"
• This does not delete the save file.

CLEARING THE OLD SAVE FILES

• Go to "%localappdata%/Insurgency/Saved/SaveGames/"
• Delete "CustomSightsConfigDualLaser.sav", "CustomSightsConfigDual.sav" and "CustomSightsConfig.sav"

If neither of those work, let me know and we can try to debug it.

KNOWN ISSUES

• If the mod gets updated and changes the save file version, old customisations may be lost.

• I'll endeavour to keep changes to a minimum and/or make loading the save backwards-compatible.

• Not thoroughly tested for compatibility with other mods such as ISMC. Cross-compatibility of the save file seems to "just work" so far.

• This mod works by adding an attachment to your weapon in a "hidden" upgrade slot (Underbarrel Hidden Bonus). As a result you may encounter compatibility issues if you use it with other mods which also use that slot (like Faster Reloads)

• Sometimes your customisations don't get applied/work on first spawn or after a round reset. Resupplying, switching weapons or respawning again may fix it.
• Tested with Checkpoint mode (working) and Survival mode (not always working on spawn). Other gamemodes may have mixed results.
• Multiplayer replication (seeing other players' custom sights and lasers) should be working but may have some issues, let me know if you see any!