ScrapMe

版本 v0.5.0·更新於 2026-05-29

!! BREAKING CONFIG UPDATE!! On-pickup item scrapping for per-character item bans

模組介紹 作者原文

Last breaking config change: 0.5.0

the mod

If you're a mod dev and there's one item you really hate for its interactions with a character

(i.e. Eclipse Lite), but don't want to write auto-scrap code, use this mod's API.

If you're a player and really hate how one item interacts with a character, but don't want to

blacklist it for every character, this is the mod for you.

how to use (player)

Instructions should appear in the config file after first launch.

Currently, it's recommended to use RiskOfOptions to configure the mod, but is not required.

Here's a quick guide:

  • Click the button to create an entry for the current character.
  • In the section for the particular character, enter in the item IDs you want banned.
  • With Quality, to ban Rare Leeching Seed, you would add SeedRare, for example.
  • You're done! Unpause, and the item will turn into scrap from that point onwards.

Right now, config changes won't scrap items in your inventory.

how to use (dev)

For mod devs, add a dependency on ScrapMe, then modify the set returned by ScrapMe.plugin.bans.items.dev[bodyIndex].

Don't worry about having to clean config when a broken item stops being broken, this API

is separate from the user config, just remove the item ban and you'll be able to

pick up the item as normal.

I'm not sure if there are ways in which items get added to inventories that sidestep the

calls I've seen so far, so bring it up on the discord if it becomes an issue.

evil schemes

  • Config:
  • [X] Re-do config to use CharacterBody.name rather than name tokens.
  • [X] Add ability to change item bans mid-game.
  • Add DebugToolkit compat.
  • [X] Add RiskOfOptions compat.
  • [X] Add config auto-apply.
  • Scrub inventory on changes to item bans.
  • [X] Add ability to unban items.
  • Implementation
  • [X] Add support for equipment bans. This is an extremely specific issue.
  • Add ability to ban particular item combos.
  • Scrub inventory on morphing characters.
  • Change item pickup notification for clarity a la void item corruption.
  • Custom pickup replacements (maybe???)
  • Compatibility:
  • [X] Quality
  • [X] Void item corruption exclusion
  • Multiplayer (might work, likely server-authority right now)

thanks

  • toast: the amazing and awesome icon
  • ror2 modcord: being patient and helpful
  • diselgonk: giving me the motivation to update this mod

安裝與使用 安裝:BepInEx 外掛

  1. 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
  2. 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
  3. 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
  4. 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。

帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。

前置依賴

下面這些內容需要先安裝,否則該模組不會生效:

bbepis-BepInExPack

檔案與校驗

檔案名稱
ScrapMe-0.5.0.zip
檔案大小
86.3 KiB