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.
LynxShredder
Shredder build piece: pulls low-tier gear out of nearby chests and salvages it into materials. Optional Path of Valheiman, Kvist and ItemDrawers support.
By LynxInc
| Date uploaded | 5 days ago |
| Version | 1.0.3 |
| Download link | LynxInc-LynxShredder-1.0.3.zip |
| Downloads | 20 |
| Dependency string | LynxInc-LynxShredder-1.0.3 |
This mod requires the following mods to function
ValheimModding-Jotunn
Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.
Preferred version: 2.30.2README
LynxShredder
A build piece that clears old gear out of your base. The Shredder pulls low-tier weapons, armour, shields, tools and capes out of nearby chests and salvages them into materials.
Using it
- Build it with the Hammer (LynxStations tab) near a Forge.
- E opens the output chest, where the materials go.
- Shift+E opens the settings:
- Weapons / Armour / Shields / Tools / Capes: shred items of this biome and below, or Off. Everything starts Off.
- Work radius: shown as a ring while the window is open.
- PoV rarity (only with Path of Valheiman): Common only, up to Magic, or up to Rare.
- State: Running or Paused.
- It shreds one item every few seconds and stops while the output chest is full.
Rules
- An item's biome comes from the highest-tier material in its recipe. Axes count as Weapons; pickaxes and fishing rods count as Tools. Capes include anything in the back slot, such as gliders.
- The item's crafting or repair station has to be within range.
- It never takes from player inventories, open chests, tombstones, carts, ships, Kvist's nest, item drawers, other Shredders, private chests, or chests behind a ward the builder can't use.
- Items without a recipe (disenchant-only items) are skipped.
Optional mods (detected automatically, never required)
- Path of Valheiman: same salvage formula as manual salvage, the player's return bonuses, a rarity limit, and protection for uniques, legendaries, socketed gear and unidentified gear. No XP and no gear unlocks.
- Kvist (GreydwarfSorter): the output chest is labelled "sort me", so Kvist empties it.
- ItemDrawers: drawers are never touched.
Config (server values are sent to clients)
| Setting | Default | |
|---|---|---|
| Piece.BuildCost | FineWood:10,Iron:6,SurtlingCore:1 | |
| Piece.CraftingStation | forge | |
| Piece.BuildTab | LynxStations | any name = custom Jotunn tab; vanilla names also work |
| Work.SecondsPerItem | 5 | |
| Work.DefaultRadius / MaxRadius | 10 / 20 | metres |
| Salvage.ReturnShareWithoutPoV | 0.4 | used only without PoV |
| Salvage.BiomeOverrides | (empty) | e.g. SwordBronze=Never, SomeModIngot=Plains |
| Debug.VerboseLog | false | logs every skip reason |
| Icon.Pitch / Icon.Yaw | 25 / 30 | build-menu icon camera angle (local) |
Console (F5): lynxshredder_dump logs the nearest Shredder's parts and state; lynxshredder_icon [size] saves renders from 8 angles to BepInEx/config/LynxShredder_icons.
CHANGELOG
Changelog
1.0.4
- Fixed: the Shredder could take gear from a Personal Chest when the same player built both. Any chest that isn't Public (Personal Chests and the like) is now never touched, whoever owns it.
1.0.3
- Fixed: with a large work radius in a busy base (lots of item drawers), the Shredder only looked at part of the area and missed chests holding gear it should shred.
- Materials that are themselves crafted (staff bases, plain armour upgraded into a fancier piece, axe heads...) now take the biome of their own recipe instead of blocking the item.
- Added biomes for common Therzie (Warfare/Armory/Monstrum/Wizardry) materials such as Lox bone, Prowler fang, Venomous fang, Dark crystal, the boss shards and the enchanted woods, plus vanilla Ymir remains, Ruby and the undead Bjorn ribcage. Anything still unknown is reported in the log as before, and BiomeOverrides still wins.
1.0.2
- New F5 console command
lynxshredder_why: logs every container in range of the nearest Shredder and, for each piece of gear, whether it would be shredded and the exact reason if not (with its biome tier, materials, station and PoV rarity). - Verbose logging now gives a reason for every skipped item, including categories set to Off.
1.0.1
- Live config reloading: edits to
lynx.lynxshredder.cfgapply about a second after you save, no restart needed. - On a server, the new values are pushed to every connected player straight away; they see "Shredder settings updated by the server".
- Existing Shredders pick up new limits (radius, timing, return share, biome overrides) immediately.
1.0.0
First release.
- Shredder build piece (LynxStations tab, needs a Forge; 10 Fine Wood, 6 Iron, 1 Surtling Core by default). It's a reinforced chest with a wooden hopper and two counter-rotating shafts of hooked discs.
- E opens the 6x4 output chest. Shift+E opens the settings; Esc or Cancel closes them without saving.
- Every few seconds (5 s by default) it pulls one matching item from a chest in range, salvages it and puts the materials in the output chest. It stops while the output chest is full.
- Settings: a biome cutoff for each category (Weapons, Armour, Shields, Tools, Capes), all Off to start; work radius, shown as a ring while the settings are open; Running/Paused.
- Biome tiers: an item's tier is the highest-tier material in its recipe. Ocean materials count as Swamp. PoV upgrade currencies are ignored, and so are unknown trophies when the rest of the recipe is known. Any other unknown material protects the item and is logged; admins can add
BiomeOverrides(Name=Biome, orNever). - Station: the item's crafting or repair station has to be in range, like manual salvage.
- Never takes from player inventories, open chests, tombstones, carts, ships, Kvist's nest, item drawers, other Shredders, chests the builder can't open, or chests behind a ward the builder can't use.
- Path of Valheiman (optional): the same salvage formula as PoV, using the bonus chances of the builder (or whoever last saved the settings). Adds a rarity limit; uniques, legendaries, socketed gear and unidentified gear are always kept. No XP or gear unlocks.
- Without PoV: returns 40% of the materials (configurable).
- Kvist (optional): the output chest is labelled "sort me" once, when placed. ItemDrawers (optional): drawers are never touched.
- Shredding looks: the item drops in, bounces on the teeth, then gets chewed down, with sparks and metal clangs that vary each time.
- Config: server values are sent to clients. Console commands
lynxshredder_dumpandlynxshredder_icon.