Valuable Tracker

Valuable Tracker is a client-side utility mod for R.E.P.O. that adds a real-time HUD to track loot during your run. It solves the mystery of "Did I lose that item, or did it count?" by distinguishing between items extracted via the tube, items currently in your carts, and items lost to the void.

Features

• Real-Time Counter: Displays Items: X / Y on your HUD, showing how many valuables you have successfully extracted vs. the total on the map.
• In Cart Counter: Displays In Cart: W, summing up items inside all active carts in the level.
• Loss Detection: Displays a red Lost: Z counter if a valuable falls off the map or is destroyed without being sold.
• Smart Positioning: Automatically detects if other mods (like MapValueTracker) are occupying the HUD slot and adjusts its position to prevent overlapping text.
• Visual Feedback: Text turns Green when you have successfully extracted 100% of the reachable loot.
• In-Game Settings Menu: Press F4 to open the settings window.
• In Cart Tracking: A new counter shows exactly how many items are currently sitting in your shopping carts, ready for extraction.
• Customizable HUD: Toggle specific counters (Items, Lost, or In Cart) on or off in real-time

Controls

• F4 Opens the Settings Menu.
  • Enable/Disable the HUD.
  • Toggle "In Cart" tracking.
  • Reset all settings to default.

Recommended Companions

While this mod works perfectly on its own, it pairs beautifully with these mods to give you a complete HUD information suite:

1. Map Value Tracker by Tansinator
   • Tracks the total dollar value of the loot, while this mod tracks the count.
2. LevelNumberUI by ironbean
   • Displays the current Level Number on the HUD.

Installation

Recommended

The easiest way to install is using the Thunderstore App or r2modman. Just click "Install with Mod Manager" on the mod page.

Manual Installation

1. Install BepInEx: Ensure you have BepInExPack installed.
2. Place File: Extract ValuableTracker.dll into your game's plugin folder:
   • \steamapps\common\R.E.P.O\BepInEx\plugins\
3. Launch: Run the game and look for the HUD in the bottom right (by default).

1.0.8

Fixed

• Lost item tracker was not tracking items broken during extraction after the recent change in valuable detection logic.
• Session Hint Reset: The "Press [Key] to open settings" hint now correctly resets when returning to the Main Menu, ensuring it appears once per session start.

Changed

• Mutual Exclusion: The Settings Menu now respects the game's native UI state. If the Pause Menu or Terminal is opened, the Tracker Settings will automatically close to prevent overlapping. NOTE: You will no longer be able to open the Tracker Settings Menu in the game menu. You must be in-game to open the Tracker Settings Menu.
• Keybinds are now displayed with user-friendly names (e.g., "Numpad 1" instead of "Keypad1") in both the menu and the helper text.

Technical Explanation

• Hierarchy Mismatch Resolution: The game's extraction logic (RoundDirector) tracks the physical Parent object, while the tracker monitors the specific ValuableObject Component. A recursive hierarchy check was implemented to verify if the tracked item (or its parent) exists in the dollarHaulList, preventing valid extractions from being flagged as "Lost."
• Zombie State Detection: "Broken" items are often disabled in the hierarchy (SetActive(false)) rather than immediately destroyed from memory. The tracker now explicitly checks !activeInHierarchy and value thresholds to correctly categorize disabled items as Lost.
• Native Menu Integration Strategy: The settings panel is now registered as a MenuPage to properly align with the game's object lifecycle. However, leveraging the game's native input blocking for a custom overlay proved unreliable. To resolve this, a Mutual Exclusion Protocol was implemented: the code now actively monitors MenuManager.currentMenuState via reflection to enforce a "one menu at a time" rule, automatically preventing the Tracker settings from opening if the Terminal or Pause menu is active.

1.0.7

Fixed

• Duck and Elsa will no longer be detected as valuable items.
• Any Physics Grabbable object will no longer be immediately treated as valuable items. Instead, we look for objects that are actually valuables.
• The Items In Cart counter will no longer turn to green when the number of items is fulfilled. This was an unintended design that was overridden by a standardized method, which caused it to also turn green.

Technical Explanation

• The item detection logic has been shifted from reflecting the raw itemsInCartCount integer to iterating through the itemsInCart list. By performing a GetComponent<ValuableObject>() check on each entry—matching the logic used by the cart's own haul display and the extraction point—the HUD now correctly filters out any PhysGrabObject that does not possess a monetary value defined by the ValuableDirector.
• UI Scoping: The HUD display logic was updated to use Rich Text Tags specifically for the main item counter. This prevents color inheritance, ensuring that green "fulfillment" highlighting is scoped only to the total item count while the "In Cart" display remains the default standardized color.

1.0.6

Fixed

• Fixed a bug with the UI setting toggles.

1.0.5

Changed

• Corrected READ.md

1.0.4

Added

• New Interactive Settings Menu (Press F4 to Open).
• Added "In Cart" counter to HUD to track items ready for extraction.
• Added "Reset to Default Settings" button in the menu.
• Added audio feedback when interacting with menu toggles.
• Added a contextual hint to fire once per session upon the first time a level's gameplay state becomes fully visible.

Changed

• Refactored HUD logic into a separate module for better performance.
• Styled the settings menu to match the R.E.P.O. Amber aesthetic.

Fixed

• Improved UI collision logic to prevent overlapping with other HUD mods.

v1.0.3

• I promise this is the final hotfix. Updated README with clearer installation instructions.
• Transferred all changelogs from README.md to CHANGELOG.md

1.0.2

• Fixed an oopsie. Uploaded the wrong file and forgot to include .dll!

1.0.1

• Attempted to fix the oopsie.

1.0.0

• Initial release.
• Added HUD tracker for extracted and lost items.
• Implemented smart positioning to avoid overlapping with Map Value Tracker.