Fallout New Vegas

File information

Last updated

Original upload

Created by

vivanto

Uploaded by

vivanto

Virus scan

Safe to use

About this mod

Changes the default binocular behavior and adds more.

Permissions and credits
Important
==========================
This mod should be considered deprecated, and I will no longer update its funcitonality. It is now part of my VMods Utility plugin, which features a slightly more stable version. The 1.21 uploaded here may conflict with Grenade Hotkey in rare cases.

Binocular Overhaul
=========================

Conflicts and known issues
------------
- Conflicts with mods with dirty edits that mess up the Chicken and egg script.
- May conflict with any mod that modifies the default binoculars (or just makes those mods obsolete)
- Weapons with extended magazines will be only loaded to default capacity after using binoculars. You can fix this if you assign your weapon of choice to a regular hotkey in your pip-boy.
- If you have multiple weapons of the type you have currently equipped, the lowest health percent will be re-equipped after using the binoculars. You can fix this with the same method as the above magazine bug.
- If you only press your assigned zoom key for a very short time, you can end up with an equipped weapon.


Changelog
------------
1.01 - Timing fix for main script, beta configuration menu.
1.02 - Hotfix for a possible ctd.
1.10 - Fully configurable key settings and configuration menu, new binoculars, mostly script changes to allow custom key bindings and some optimization, default key bindings changed, proper messages for swapping binoculars.
1.11 - Bugfix, reduced scope wobble for the binoculars.
1.12 - Bugfix
1.13 - Recipe fix for MK2
1.20 - New vision modes / special thanks to LucyBlue /, menu changes, third person fix, some new features associated with vision modes.
1.21 - Fixes non-hardcore mode, allows for toggleable binocular key (defaulted to), fix for function key while weapon out, temporary workaround for concrete weapon referencing (fixes ext. ammo and related bugs)
1.2.2 - Removed the workaround from previous version to modded weapons, it was causing ctd related to a likely nvse bug.
1.2.3 - Update to FNV build 1.2.0.314

Requirements
------------
New Vegas Script Extender - NVSE
Keyboard and Mouse

Desciption
------------
Completely changes the default binocular in the following ways.

The original binocular is replaced by a "misc" item, instead of a weapon, and renamed "Binoculars, Weathered", implying why it sucks so much.

Every binoculars FOV is full screen now with new scope reticules.

Adds new binoculars as upgrade options at a workbench, their feature list are the following:

Binoculars, Weathered - No much change here, permanent zoom setting, works similarly as before (except the controls, but get to that later).
Binoculars, Light Frame - Weighs less than the previous, has a limited range of zoom, looks cooler.
Binoculars, Tech - Higher range of zoom, can zoom farther, but the minimum zooming angle is also narrower, has toggleable night vision and monochromatic heat vision.
Binoculars, Tech MK2 - Similar as the above, with full color spectrum thermal vision and danger sense mode.

To use the binoculars, all you require is to have them in your inventory, since they're a misc item now. Holster all your weapons (fists included), press and hold the 'b' key. All the related hotkeys for the mod can be customized with its config menu.

The default key settings are as follows:
- left mouse = toggle vision mode on/off (with tech binoculars)
- middle mouse = invert mouse wheel for zooming
- wheel up = zoom in
- wheel down = zoom out
- 'b' key = equip and zoom with binocular
- '2' key = function key (explained below)

The function key is context sensitive, depending on your current state, allows you the following:
- swap between multiple binoculars - if every weapon holstered
- open config menu - if every weapon holstered and you press and hold the function key
- open main/recharge menu - if every weapon holstered, holding key, you have Tech or MK2 in inventory and are in hardcore mode.
- cycle between vision modes - while actively zooming with Tech/MK2 and vision mode is currently enabled.


Installation
============
Download, unzip, copy all the files and folders to your new vegas/data folder, enable the esp in your loader and you're set.

Uninstall
=========
You must assign your binocular-zoom key to something that's not your default zoom key. Otherwise, if the two types of zoom are on the same key, the mod disables that control. This is only for uninstalling, it is safe to set rmb for zoom while the mod is active. After that, you can safely delete or disable the esp.

Updating
========
You must first create a clean save file, before updating. To do this, unload your current version, then load your current save. Continue to load when prompted for missing mod, then save and exit game. Now delete the old one and load the new file. To gain back your lost binoculars from the update, use the in-game cheat menu.

Credits
========
Artisten's Zooming Scoped Weapons mod
Atlanticmongrel's Binoculars mod
Hengebob's ST Tech Binoculars resource
LucyBlue's Enhanced Vision and Thermal Vision mod
Bethesda's Fallout New Vegas
Myself

Troubleshooting
===============
The current version due to lack of NVSE supported inventory walking, requires you to have your normal weapon hotkeyed to a regular hotkey (1..8) to properly re-equip it after using the binoculars. If you don't do this, extended magazine mods may not be loaded fully by default, and you will have the lowest condition weapon equipped if you have multiple.

Due to the heavy automation and event scripting in this mod, if you run into any bugs with it, describe every step you made to reproduce it (what weapon you had equipped, what keystrokes were pressed in exact sequence etc). Else I can't really help.

Modding
==============
You can easily add your own binocular version to it so that the handler will recognize properly. To do this you need 3 forms:
- Your custom binocular as a weapon, this will have the scope and will be equipped for zooming. Use the weapon's min and max range for min and max FOV and weaponSight as default FOV.
- The same binocular mesh as a misc item. This will be present in your inventory and needs to be added to the game in some way so you can acquire it.
- A short message saying something similar to " ** binocular equipped". This will be used by the swapping function to cycle between the binoculars.

Add these 3 forms to V86bcWeapBinocularList; V86bcMiscBinocularsList; V86bcMsgBinocularList respectively, and make sure they all have the same list-index. (and didn't mess up the rest of the list order).
???
Profit.

Legal stuff
============
Feel free to use this mod as long as you give credit to the original modelers and authors as well, exactly as I did in the credits section, and I'd like to know where this mod gets used in.