Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
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
| Date uploaded | 17 hours ago |
| Version | 0.0.1 |
| Download link | MCMac-ScanRarity-0.0.1.zip |
| Downloads | 70 |
| Dependency string | MCMac-ScanRarity-0.0.1 |
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
- Install BepInEx for Lethal Company (BepInEx 5, 64-bit).
- Place
ScanRarity.dllin:
BepInEx/plugins/ScanRarity/
- Launch the game once to generate the config file, then adjust settings in
BepInEx/config/ScanRarity.cfgif 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.
CHANGELOG
Changelog
0.0.2
- Added switchable marker styles: Point, Particles and Cheat (bounding box that encloses the whole item).
- Added a new
[Change]config section:StyleType(marker style),MarkerColor(single fixed color for all styles, supports #RRGGBB),PointSize(point size),ParticleAmount(particle count: Low / Medium / High),BoxLineWidth(box line thickness). - Renamed
ShowDollarSigntoShowSignand added a newCustomSignoption to define any custom prefix text before the value (default$). - Updated default presets to match the current config:
StyleType=Particles,BeaconDuration=3,BeaconHeight=1,TextFontSize=25,TextVerticalOffset=-0.5,BoxLineWidth=0.04.
0.0.1
- Spawns a rarity-colored marker when scanning scrap with right-click; higher value = higher rarity color: White → Green → Blue → Purple → Gold → Red.
- Shows "item name + value" text above the marker, with an optional
$sign prefix (ShowDollarSign). - Localization for 8 languages: en, zh-CN, ru, pl, la, fr, pt, es.
- Can hide the vanilla scan HUD labels (
DisableVanillaScanDisplay). - Pure client-side mod, depends only on BepInEx and Harmony.
