tehAon’s Materialist – Material Tracker and Finder

# Nexus Mods upload sheet — Tracked Materials Finder
Paste-ready copy for the Nexus upload form. Nexus renders **BBCode**, not Markdown.
- **Mod name:** Tracked Materials Finder
- **Game:** 7 Days to Die
- **Version:** 0.2.0
- **Author:** tehAon
- **File:** `TrackedMats_v0.2.0.zip` (extracts to a single `TrackedMats/` folder)
- **Category:** Miscellaneous / Gameplay
- **Tags:** quality of life, crafting, storage, UI, DLL mod
- **Requirements:** 7 Days to Die 3.0 · EasyAntiCheat **OFF** (DLL mod)
- **Permissions:** MIT — reuse/modify freely with credit.
---
## Summary (short, one-liner field)
```
Track a recipe and the storage boxes holding the materials you still need get compass/map markers — and those items light up when you open the box.
```
---
## Description (BBCode — paste into the Description tab)
```bbcode
[size=4][b]Track a recipe. The mod finds the mats.[/b][/size]
Track a recipe the normal way and let the mod do the fetching legwork:
[list]
[*][b]Box markers[/b] — every storage box within range holding a material you [i]still need[/i] gets a green marker on the compass and map. The marker label lists which needed materials are inside.
[*][b]In-box highlight[/b] — open a marked box and the slots holding needed materials are tinted, so they jump out at a glance.
[/list]
It reads the game's own [b]tracked recipe[/b] (the one you set in the crafting window), so there is no new UI to learn. Materials you already have enough of are ignored, and markers and highlights clear themselves as you gather what you need.
[size=4][b]Install[/b][/size]
This is a DLL mod, so you must [b]launch with EasyAntiCheat OFF[/b] (run 7DaysToDie directly, or pick the EAC-off option in the launcher).
Extract the [b]TrackedMats[/b] folder into your [b]Mods[/b] folder:
[code]7 Days To Die/Mods/TrackedMats/[/code]
[size=4][b]How to use[/b][/size]
[list=1]
[*]Open the crafting window and [b]track[/b] a recipe (the vanilla track button).
[*]Green markers appear on nearby storage boxes th…

# Nexus Mods upload sheet — Tracked Materials Finder
Paste-ready copy for the Nexus upload form. Nexus renders **BBCode**, not Markdown.
- **Mod name:** Tracked Materials Finder
- **Game:** 7 Days to Die
- **Version:** 0.2.0
- **Author:** tehAon
- **File:** `TrackedMats_v0.2.0.zip` (extracts to a single `TrackedMats/` folder)
- **Category:** Miscellaneous / Gameplay
- **Tags:** quality of life, crafting, storage, UI, DLL mod
- **Requirements:** 7 Days to Die 3.0 · EasyAntiCheat **OFF** (DLL mod)
- **Permissions:** MIT — reuse/modify freely with credit.
---
## Summary (short, one-liner field)
```
Track a recipe and the storage boxes holding the materials you still need get compass/map markers — and those items light up when you open the box.
```
---
## Description (BBCode — paste into the Description tab)
```bbcode
[size=4][b]Track a recipe. The mod finds the mats.[/b][/size]
Track a recipe the normal way and let the mod do the fetching legwork:
[list]
[*][b]Box markers[/b] — every storage box within range holding a material you [i]still need[/i] gets a green marker on the compass and map. The marker label lists which needed materials are inside.
[*][b]In-box highlight[/b] — open a marked box and the slots holding needed materials are tinted, so they jump out at a glance.
[/list]
It reads the game's own [b]tracked recipe[/b] (the one you set in the crafting window), so there is no new UI to learn. Materials you already have enough of are ignored, and markers and highlights clear themselves as you gather what you need.
[size=4][b]Install[/b][/size]
This is a DLL mod, so you must [b]launch with EasyAntiCheat OFF[/b] (run 7DaysToDie directly, or pick the EAC-off option in the launcher).
Extract the [b]TrackedMats[/b] folder into your [b]Mods[/b] folder:
[code]7 Days To Die/Mods/TrackedMats/[/code]
[size=4][b]How to use[/b][/size]
[list=1]
[*]Open the crafting window and [b]track[/b] a recipe (the vanilla track button).
[*]Green markers appear on nearby storage boxes th…

NEW: Finds materials in the world, not just in containers.
- Dropped items and loot bags now get markers. A stack you tossed on the
ground, or a death/loot bag holding a needed material, is marked with that
item's icon, same as a container. On by default (scanGroundItems,
groundRadius=50).
- Harvestable blocks now get markers. Trees for wood, boulders and ore for
stone and metal, plants for fibers. Track a wood recipe and nearby trees
are marked; track stone and boulders light up. A block is only marked if
what it drops is something you still need. On by default (scanBlocks).
- Blocks are clustered into area markers, so a forest or a grass field is a
handful of markers instead of thousands. Matching blocks within
blockClusterSize (4 m, double for grass) collapse into one.
- Grass and small plants are included (scanGrass), on a tighter grassRadius
(12 m) since they're dense and only yield fibers. Turn off with "tm grass off".
- Blocks are map-only by default (blocksOnCompass=false) so they don't bury the
compass; the map still shows them. Ground items stay on the compass.
- Built to not cost frames. Block scanning resolves which block types can drop a
needed item once, up front; reads only a thin band around the ground surface in
loaded chunks; and rescans only when you move (blockRescanMoveDist=4 m), on a
slow timer (blockRescanSeconds=8 s), or when a nearby block is mined — not every
frame. A mined tree's marker clears as you harvest.
- New caps and toggles. maxGroundMarkers and maxBlockMarkers (24 each, nearest
kept) bound each source; the overall maxMarkers still caps everything. New
console commands: tm ground on|off, tm blocks on|off, tm grass on|off. tm status
now reports the ground/block sources.
- Still client-side only. Dropped-item contents and block types are both data your
client already has from any server, so this works on a vanilla dedicated server
with nothing installed on it.
- Note: only loaded chunks near you are scanned, and unopened POI crates …