MCMac-ScanRarity icon

ScanRarity

Scan scrap to spawn a rarity-colored light pillar with value text. Client-side, no dependencies beyond BepInEx. Colors: White < Green < Blue < Purple < Gold < Red.

By MCMac
Last updated 2 hours ago
Total downloads 8
Total rating 0 
Categories Mods Client-side
Dependency string MCMac-ScanRarity-0.0.1
Dependants 0 other packages depend on this package

README

ScanRarity

Scan scrap items in Lethal Company to reveal their value with a rarity-colored particle effect. When you right-click scan a scrap item, a colored particle beacon spawns at its position with the item name and value displayed on top. The higher the value, the higher the rarity color tier: White → Green → Blue → Purple → Gold → Red.

A pure client-side mod. The only dependencies are BepInEx and Harmony — no other prerequisites.

Features

  • Right-click scanning spawns a rarity-colored particle effect at the scrap item's position.
  • The item name and value text float above the effect, colored to match the rarity tier.
  • Optional $ prefix for the value display.
  • Re-scanning refreshes the effect duration and color tier.
  • Can hide the vanilla scan HUD labels for scrap so only the new display is shown.

Rarity Tiers (default thresholds, configurable)

Color Value
Red ≥ 300
Gold 200 – 299
Purple 130 – 199
Blue 80 – 129
Green 40 – 79
White < 40

All thresholds can be adjusted in the config file.

Configuration

Config file: BepInEx/config/ScanRarity.cfg

Key Default Description
Enabled true Master switch for the mod.
BeaconDuration 8 Duration of the particle beacon in seconds.
BeaconHeight 3 Height of the particle beacon.
ShowValueText true Show the value text above the beacon.
ShowDollarSign false Prefix the value with $ (e.g. $10).
Language en Language file to load: en, zh-CN, ru, pl, la, fr, pt or es.
TextFontSize 72 Font size of the value text.
TextVerticalOffset 0.4 Vertical offset of the value text above the particles.
DisableVanillaScanDisplay true Hide the vanilla scan HUD labels for scrap.
Rarity.RedThreshold 300 Value threshold for Red tier.
Rarity.GoldThreshold 200 Value threshold for Gold tier.
Rarity.PurpleThreshold 130 Value threshold for Purple tier.
Rarity.BlueThreshold 80 Value threshold for Blue tier.
Rarity.GreenThreshold 40 Value threshold for Green tier.

Supported Languages

en, zh-CN, ru, pl, la, fr, pt, es — 8 languages in total.

Installation

  1. Install BepInEx for Lethal Company (BepInEx 5, 64-bit).
  2. Place ScanRarity.dll in:
BepInEx/plugins/ScanRarity/
  1. Launch the game once to generate the config file, then adjust settings in BepInEx/config/ScanRarity.cfg if desired.

Language files are loaded from BepInEx/plugins/ScanRarity/languages/<Language>.json (for example, languages/en.json).

Compatibility

  • Hooks HUDManager.UpdateScanNodes (Postfix) and is compatible with mods that rewrite the scan pipeline (e.g. ScanValue).
  • Vanilla Lethal Company only. Pure client-side — no NetworkBehaviour, RPC, or server-side code.