ItemRecommender

Client-side item recommendations for Risk of Rain 2: markers in the Artifact of Command menu and a build path in the HUD – like a build overlay in other games. Other players do not need this mod. German and English (follows the game language).

Command menu

• Hover an item to see why: what it does, why it is rated like this and what it pairs with.
• A legend is shown next to the menu.
• Void items are checked automatically (also modded ones): a void item that would eat your good items is marked red. If you already hold the void version (e.g. Safer Spaces), the normal item becomes a good pick, because it turns into another void stack.
• Pick order above the legend: the best 5 of exactly the items this menu offers, ranked like the build path (rating + survivor + synergies).
• When the menu opens, the cursor sits on an item and the game would show its description right away. The mod hides it until you move the mouse.

Ratings follow the community consensus (six tier lists combined): S = core, A = good, the rest neutral. Only items that actively hurt you (Egocentrism, Purity, …) get an X. Every survivor has its own overrides, e.g. Seeker: Rose Buckler and Little Disciple work during Sojourn.

Build path

A tile under the objectives shows which items to collect next, with icons and your progress (3/10). The next step has a gold frame, finished steps are dimmed.

• Page 1 is a fixed start per survivor from the build file.

• Page 2 onwards is generated once per page and stays until it is done. Each page is a mix instead of eight damage items:

  Slot	Page 2	Page 3+ (default)
  Offense (damage, procs)	4	3
  Defense (block, armor, barrier)	1	1
  Max health / shield (against one-shots)	1	1
  Sustain (healing)	1	2
  Utility / mobility	1	1

  Items are picked by community rating, your survivor's rating, synergies with what you hold and the survivor's own plan. Items from the last two pages are pushed back so pages don't repeat, and a void item never shares a page with the item it converts.

• Only white and green items: red and boss items rarely drop, so they are left out.

• F6 switches to the rarity view: one row of white and one row of green items (5 each), best first – what to take from the next white or green Command menu. Each row always has a defense/health item and a healing item, at most 2 damage items.

• F7 swaps the highlighted item: it is gone for the rest of the run, another item takes its slot. F8 skips the whole page.

• F5 shows the previous page (press again to go further back), F8 goes forward again.

• Skips and pages are remembered for the whole run, also after a game restart (BepInEx/config/ItemRecommender.state.txt).

• Once you hold a void item, its normal item no longer shows up; the path shows the void item and counts both stacks together (e.g. Tougher Times + Safer Spaces).

Edit the builds

After the first launch, edit BepInEx/config/ItemRecommender.builds.txt. It is re-read while the game runs; the format is explained at the top. Each Path: line in a survivor section is a page, e.g.

Path: Syringe x10 > Bear x6 > Hoof x6 > CritGlasses x10

Config

BepInEx/config/Waso.ItemRecommender.cfg – or in-game under Settings > Mod Options if Risk of Options is installed (optional, changes apply right away, hotkeys can be rebound there).

Source: https://github.com/Waso2101/ItemRecommender

Changelog

0.9.0

• Build analysis: reads your survivor's skills and every item description (also modded ones) and rates items against your build
  • Death Mark / Noxious Thorn rise with the number of debuff types you apply; new debuff types are pushed while you hold them
  • Ignition Tank, Sanguine Chalice, Vile Censer only once you have a burn / bleed / stun source
  • Crit payoff items scale with your actual crit chance; no more crit items at 100%
  • Single-target survivors (Huntress, Commando, Bandit, …) get area damage pushed; area damage pushes on-kill items
• Tooltip shows these reasons in green, and what's missing in grey
• Huntress: area damage (Gasoline, Will-o'-the-wisp, Ukulele, Behemoth) in her plan

0.8.1

• Risk of Options support (optional): change all settings and hotkeys in-game under Settings > Mod Options
• F5: back to the previous build path page (F8 goes forward again)
• Skipped items and pages are kept for the whole run and saved, so they survive a game restart
• Void items: once you hold one, its normal item leaves the path; the void item shows instead and both stacks count together

0.8.0

• Rarity view (F6): one row white, one row green, best first, each row with defense + healing
• Pick order for the open Command menu, shown above the legend
• Build path pages only use white and green items

0.7.0

• Pages after page 1 are generated once and stay until done (no more constant re-ranking, no "live" label)
• Balanced pages: offense, defense, max health/shield, sustain and utility slots; later pages favour defense + sustain (LatePageFocus)
• Picks use community ratings + survivor ratings + synergies; recent pages are pushed back, void pairs never share a page
• Red/boss items are optional (don't block a page), max 2 per page
• F7 now swaps the item: its slot gets refilled
• README rewritten

0.6.0

• Skip hotkeys for the build path: F7 = skip item until next stage, F8 = skip page
• Removed filler items (Medkit, Monster Tooth) from the start pages

0.5.1

• Plugin ID is now Waso.ItemRecommender (config file: Waso.ItemRecommender.cfg). Old settings are taken over automatically.

0.5.0

• Smaller build path icons, more items per page, higher counts
• Live pages: after page 1, the build path is re-ranked live from ratings + current synergies

0.4.0

• Build path tile under the objectives, with pages per survivor (early / mid / late run)
• Tile copies the look of the game's objective panel; icons load via the game's own async image
• Item description no longer pops up when the Command menu opens under the cursor
• Ratings reworked from community tier lists, longer explanations (DE/EN)
• Normal items are rated good if you already hold their void version
• Seeker section

0.2.0

• First version: Command menu markers, synergies, void conversion checks, legend