Name: Auto Item Collector
Version: 2.7.1
Date: 06/03/2024
Category: Gameplay Effects and Changes
Requirements: xNVSE 6.3.3 or higher
JIP LN NVSE Plugin 56.52 or higher
JohnnyGuitar NVSE 4.85 or higher
UIO - User Interface Organizer 2.30
ShowOff xNVSE Plugin 1.75
Optional: The Mod Configuration Menu 1.5
Author: ebizoe
Source: https://www.nexusmods.com/newvegas/mods/77775

Description
===========
An auto-loot mod with a user-customizable "Custom Filter" function.

Features
========
- Auto loots containers and dead bodies by just looking at them.
- When you pick up an item, keep press-and-hold activate key for a second will make the same items near the player getting auto-collected. No more micro-clicking multiple caps on the floor!
- Allows you to mass-auto-picking plants by press-and-hold activate key at a plant for a second.
- UI message will be shown over the container you just auto-looted, telling what items and how many of them you looted. This can be turned off if you prefer Xilandro Axeuora's "Recent Loot Log" for this function (Thanks bct18181 for the idea).
- User-customizable Custom Inclusive Filter. Items on this filter will be auto-looted. Pretty much any item in the game can be registered to it. Thanks HajimeSaito for the idea.
- Custom Exclusive Filter. Thanks NCRFan86 for the idea.
- Users can make any container to be excluded from getting auto-looted. Might be useful for the containers at player's home. Thanks HajimeSaito for the idea.
- Over-encumbered check while auto-collecting items. Thanks dandadern for the idea.
- LShift-clicking items/recipes on Pip-Boy or crafting menus will register/unregister the items to Custom Filters. Thanks stoikcypriot for the idea on recipes.
- Value-to-weight ratio support. Thanks stoikcypriot for the idea.
- User-customizable Cell Filter. Cells on this filter will be skipped by auto-looting script. Thanks JonFrenger for the idea.
- Supports PushTheWinButton's Universal Item Sorter. Thanks grafitier for the input.
- Supports Xilandro Axeuora and Hitman47101's B42 Loot. Thanks JonFrenger for the idea.
- Controller support.
- Can be turned ON/OFF by pressing a hotkey ("N" key by default). No controller support for this function, unfortunately.

What item the mod will auto loot?
=================================
- AID/Ingestible items, like food and chems, that are lighter than the weight-limit setting.
- All ammo, ammo casings, and drained cells/packs/tanks in your setup (including ones from user-made mods).
- A few of misc items, listed below:
- Bottle Caps
- Faction Currencies
- Skill Magazines
- Pre-War Money
- Bobby Pins
- Casino chips

...plus, ones listed on a user-customizable "Custom Inclusive Filter".

To fire the auto-looting script, you need to "look at" the container you want to loot. If you successfully auto-looted, a UI message will be shown over the container so you will know what items you looted and which container you just looted from.

About stealing items
====================
Stealing items from containers is not supported. However, you can mass-auto steal world items (items on the floor or the bookshelves) or plants if you click on an owned item/plant. Because micro-clicking all those Maize one by one is not fun.

Custom Filters
==============
You can add just about any item to Custom Filters (up to 128 entries). To add items to Custom Filters, open Pip-Boy then while holding Left-Shift key (or Left-Thumbstick for controllers), click the item you want to add to Custom Filter. The ingredients of crafting recipes can also be added to Custom Filter by LShift-clicking (or Left-Thumbstick for controllers) a recipe in crafting menus at workbench, reloading bench, campfire or electric hot plate. Custom Filters can be edited via MCM. Custom Filters are in plain text format, so you can also edit it manually with any text editor. Make sure to place one item per line.

Custom Filter.ini example:
0 $Nuka-Cola
1 $Sunset Sarsaparilla

Custom Filter.ini must be formatted accordingly:
- The first column indicates whether the entry is for exclusive (1) or inclusive (0) filter.
- The second column is the name of the item, which must be prefixed with '$'.
- Values must be separated with tabs, not spaces.

Making containers to be excluded from auto-loot
===============================================
You can make any container to be excluded from auto-loot by placing a special item, called "NO AUTO ITEM COLLECT" (yes it's screaming), into it. You can collect "NO AUTO ITEM COLLECT" item from one of Mojave Express dropbox, or Pony Express dropbox (TTW).

Value-to-Weight Ratio option
============================
This option has higher priority than all the other filters except Custom Filters. For example, if its value is 100, Microfusion cells will be auto-collected even if the "Ammo for energy weapons" option is unchecked, because Microfusion cells' value-to-weight ratio is over 100.

Cell Filter
===========
The cells on Cell Filter will be ignored by auto-looting script. Might be useful for player's home. Push and hold the ON/OFF hotkey ("N" key by default) for about a second will bring up a cell-managing message box. You can also manage the filter via MCM.

Configuration Options
=====================
This mod is configurable via editing "config\Auto Item Collector.ini" directly, or via MCM. I recommend using MCM since it allows you to tweak the settings on the fly.

Install
=======
I recommend Mod Organizer 2 (https://www.nexusmods.com/skyrimspecialedition/mods/6194?tab=files) for installation of this mod. If you're using Mod Organizer 2, follow its instruction for managing mods.

If you insist installing this mod manually;
1. Extract the files to a temporary location.
2. Copy all the contents of this package into Fallout New Vegas\Data\
3. Start FalloutNVLauncher, click 'Data Files', place a checkmark beside the .esp file.

You can place this mod anywhere in your load order since this mod has no esm/esp dependency nor overwrite any record entries.

Upgrade
=======
Overwrite old files with new ones.
Pre-version-2.0 Custom Filter will automatically be converted to new format.

Uninstall
=========
You can just remove this mod whenever you want and it's completely safe to your saves.
There are five files to be deleted;
- Fallout New Vegas\Data\Auto Item Collector.esp
- Fallout New Vegas\Data\config\AIC Custom Filter.ini
- Fallout New Vegas\Data\config\Auto Item Collector.ini
- Fallout New Vegas\Data\menus\prefabs\AIC\AIC.xml
- Fallout New Vegas\Data\uio\public\Auto Item Collector.txt

History
=======
2.7.1, 06/03/2024
- FIXED: Mass-picking up plants doesn't work properly.
- FIXED: UI message will report inaccurate quantity for the picked-up items.
- FIXED: UI message shouldn't be displayed when drinking from water.

2.7, 04/03/2024
- Added ShowOff xNVSE Plugin to the requirement.
- Added a feature to mass-auto-pick world items.
- Added a feature to mass-auto-pick plants.
- Added controller support.
- FIXED: Some wording.

2.6.2, 14/02/2024
- FIXED: "Value-weight ratio" slider on MCM is broken. Thanks Atfaster for the report.

2.6.1, 31/12/2023
- FIXED: "Weight limit for AID items" slider on MCM doesn't work. Thanks JonFrenger for the report.

2.6, 20/12/2023
- Added support for Xilandro Axeuora and Hitman47101's B42 Loot. Thanks JonFrenger for the idea.
- Auto-looting a locked container immediately after the container gets unlocked is now optional.
- FIXED: Some typos.

2.5, 27/11/2023
- Added ON/OFF switch option for encomber-check. Thanks JonFrenger for the idea.
- Better UI message placement.
- FIXED: The player-owned containers won't be auto-looted.

2.4, 09/11/2023
- Made compatible with PushTheWinButton's Universal Item Sorter. Thanks grafitier for the report and testing.
- Removed unnecessary UI messages that spammed in the top-left corner of the screen.
- FIXED: Edits on filters won't be saved if user exit MCM screen with ESC key.
- FIXED: A few minor bugs.

2.3, 05/11/2023
- Added user-customizable Cell Filter. Cells on this filter will be ignored by auto-looting script. Thanks JonFrenger for the idea.
- Reworked item adding/removing procedure.

2.2, 20/10/2023
- Added value to weight ratio support. Thanks stoikcypriot for the idea.
- Added crafting recipe support. Thanks stoikcypriot for the idea.
- Items can now be added to, or removed from Custom Filters via Pip-Boy or crafting menus.
- Item-filtering script is significantly quicker at processing a lot of stacked items at the same time.
- Removed value-threshold option for AID/Ingestible items.
- FIXED: The encumbered-check won't work correctly under certain condition. Thanks Wolfindex for the report.
- FIXED: Minor bugs and wording.

2.1, 05/10/2023
- Added support for Xilandro's Retrievable Throwables Reforged.

2.0.1, 21/08/2023
- FIXED: The item weight calculation for over-encumbered check is inaccurate.
- FIXED: Scripts fail to load user settings when loading saves under certain conditions.
- FIXED: Item filtering process can be very slow under certain conditions.
- FIXED: There can be a large delay between pick-up sound and UI message display.
- FIXED: The UI message for failing the over-encumbered check won't be displayed.
- FIXED: BoxCase4570Govt, BoxCase50MG, BoxCase10mm, BoxCase127mm, BoxCase556mm, BoxCase5mm and BoxCase9mm are missing from the hand loading items filter.
- FIXED: Minor bugs and typos.

2.0, 16/08/2023
- Overhauled item filtering system.
- The format of Custom Filter has been changed. If you edit Custom Filter manually, see "Custom Filter" section of Readme.txt.
- Supports all ammo, ammo casings, and drained cells/packs/tanks in your setup (including ones from user-made mods).
- Custom Exclusive Filter. Thanks NCRFan86 for the idea.
- Users can make any container to be excluded from getting auto-looted. Thanks HajimeSaito for the idea.
- Over-encumbered check while auto-collecting items. Thanks dandadern for the idea.
- Weight threshold settings for ammo have been removed.
- Added "Ammo for explosive weapons" option.
- Ammo casings and drained cells/packs/tanks options are now separated.
- Flamer fuel and liquid nitrogen are now covered by "Ammo for energy weapons".
- Added "Hand loading items" option, which covers all the primers, gun-powders and lead.
- Added "Ammo for Rock-It Launcher" option, which covers a broad range of misc items.
- Collects casino chips by default, including Sierra Madre chips.
- Alien crystals from Zeta DLC have been added to default auto-collecting list (TTW).
- Auto convert pre-version-2.0 Custom Filter to new format.
- FIXED: No picking-up sound will be played when any of the items that has been auto-collected has "Pick Up" sound data.
- FIXED: UI messages shouldn't be visible when Pip-Boy panel is brought up.
- FIXED: Item weight calculation was wrong when "Pack Rat" perk was involved.
- FIXED: A few minor bugs.

1.5, 22/4/2023
- UI messages are toggleable now. Probably useful when you're using "Recent Loot Log" mod. Thanks bct18181 for the idea.
- Lowered how frequent the scripts run. It was unnecessarily high.

1.4.2, 15/9/2022
- FIXED: Equipped items won't get auto-collected.
- FIXED: UI messages stay visible for too long under certain condition.
- FIXED: Changed "fNonEnergyMaxWeightThreshold" setting to 0.076 so 12 gauge round will be auto-looted by default.

1.4.1, 8/9/2022
- FIXED: Hotkey for ON/OFF is unnecessarily enabled while in menu modes, causing a conflict with other mods, such as hman101's "To-Do List". Thanks bct18181 for the report.
- FIXED: Changed "fNonEnergyMaxWeightThreshold" setting to 0.066 so 20 gauge round will be auto-looted by default. Thanks bct18181 for the report.

1.4, 6/9/2022
- Added a font-scaling setting. Thanks dandadern for the idea.
- Respecting fDyingTimer game setting is now optional. Thanks bct18181 for the idea.
- FIXED: The main Hotkey setting on MCM doesn't work.

1.3.1, 29/8/2022
- FIXED: Quest items (ie NCR Dogtags) would not be removed from the container.

1.3, 29/8/2022
- Crosshair's info will be updated if the container is auto-looted and become empty.
- FIXED: Quest items (ie NCR Dogtags) would never get auto-collected even if it's on Custom Filter.

1.2, 20/8/2022
- Added a robust "Custom Filter" function. Users can add any item to the filter. Thanks HajimeSaito for the idea.
- Added options for Grenades/Mines and Throwing Weapons. Thanks Amazonalpaca15 for the idea.
- Tweaked and made UI animation slightly better.
- xNVSE 6.2.8 is now required.
- FIXED: The scripts ignore "Pack Rat" perk.
- FIXED: The auto-collect script fires too early on dying actors, even before they turn into a plasma-goo.
- FIXED: If player lock-picked a container, the auto-collect script won't fire immediately.

1.1, 7/8/2022
- Added options for ammunition.
- Added support for .45 Auto ammo/case from "Honest Hearts" DLC.
- FIXED: The hotkey function won't work properly under certain conditions.

1.0, 3/8/2022
- Initial release.

Tools Used
==========
Garden of Eden Creation Key (GECK) - http://geck.bethsoft.com/index.php?title=Main_Page
GECK Extender - https://www.nexusmods.com/newvegas/mods/64888
xEdit - https://www.nexusmods.com/newvegas/mods/34703
Hot Reload (NVSE) - https://www.nexusmods.com/newvegas/mods/70962
Readme Generator - http://HammondsLegacy.com/obmm/tools_readme_generator1.asp

Licensing/Legal
===============
You can do whatever you want with this mod.