CommandQueueExtendedIconFix

版本 v1.2.0·更新於 2026-10-11

Restores CommandQueueExtended item icons and adds owned-item counts and configurable inspect tooltips.

模組介紹 作者原文

CommandQueueExtended Icon Fix

A small, client-side compatibility patch for CommandQueueExtended in Risk of Rain 2.

CommandQueueExtended lets you choose and queue items while using the Artifact of Command. On newer game builds, its item-selection grid can show white or empty squares instead of item icons. This plugin restores the icons without replacing CommandQueueExtended or changing the queue itself.

Features

  • Restores the missing item pictures in the Command Queue item-selection grid.
  • Uses the game's built-in RoR2.UI.ItemIcon component rather than obsolete direct sprite fields.
  • Keeps the existing item buttons and their click behavior.
  • Leaves queue ordering, automatic selection, save slots, and saved queue data to CommandQueueExtended.
  • Runs as a separate BepInEx plugin; it does not modify CommandQueue.dll.

Requirements and compatibility

| Component | Version / notes |

| --- | --- |

| Risk of Rain 2 | Tested on 1.5.0#1210 |

| CommandQueueExtended | 2.0.0 (required) |

| BepInEx | Version 5; install the dependencies required by CommandQueueExtended |

| r2modman | Recommended for profile management, but not required |

The fix is intended for CommandQueueExtended 2.0.0. Other game and mod versions have not been verified. It only changes local UI rendering; multiplayer compatibility has not been separately verified.

Installation with r2modman

  • Install CommandQueueExtended through r2modman and let r2modman install its required dependencies.
  • Download the compiled CommandQueueIconFix.dll from a GitHub Release, or build it using the instructions below.
  • Open your Risk of Rain 2 profile folder in r2modman and place the DLL at:

BepInEx/plugins/CommandQueueExtendedIconFix/CommandQueueIconFix.dll

  • Ensure there is only one copy of CommandQueueIconFix.dll anywhere under the active profile's BepInEx/plugins directory.
  • Launch the game with Start modded.

If you distribute a packaged mod ZIP containing manifest.json and the compiled DLL, you can also use Settings → Profile → Import local mod (menu wording may vary by r2modman version).

Do not remove or overwrite CommandQueue.dll. This is an addon, not a replacement for CommandQueueExtended.

How it works

CommandQueueExtended 2.0.0 creates the available-item choice grid by assigning PickupDef.iconSprite to a UnityEngine.UI.Image. On Risk of Rain 2 1.5.0, that sprite field can be empty, producing blank buttons.

The fix uses a targeted Harmony transpiler on the callbacks generated by CommandQueue.UIManager.CreateQueueContainer():

  • Intercepts the legacy sprite assignment for an item-choice button.
  • Gets the game's existing ItemIcon prefab from HUDSimple / ItemInventoryDisplay.
  • Creates a child icon using the prefab and assigns the item's ItemIndex with ItemIcon.SetItemIndex().
  • Hides the obsolete image, prevents the child graphics from blocking button clicks, and rebinds the item after the next Unity frame.
  • Falls back to the original image assignment if the new icon cannot be created.

This patches only how the item choices are drawn. It does not rewrite the command queue, affect item drops, or change CommandQueueExtended's save format.

Building from source

You need a.NET SDK (8 or newer), a Risk of Rain 2 installation, and an r2modman profile with BepInEx installed. The project targets.NET Standard 2.1 and compiles against the game and BepInEx assemblies. The Unity Editor is not required.

In PowerShell, set the two local paths (examples below; replace them with your actual paths):

$env:ROR2_GAME_DIR = 'C:\Program Files (x86)\Steam\steamapps\common\Risk of Rain 2'

$env:ROR2_PROFILE_DIR = Join-Path $env:APPDATA 'r2modmanPlus-local\RiskOfRain2\profiles\CommandQueue'

dotnet build -c Release

Alternatively, supply MSBuild properties GameDir and ProfileDir when building. Any BepInEx architecture warning (MSB3270) should be reviewed separately, but it did not prevent building the tested mod.

Packaging and releases

This repository contains two different m

安裝與使用 安裝:BepInEx 外掛

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

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

前置依賴

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

gabrielgad-CommandQueueExtended

檔案與校驗

檔案名稱
CommandQueueExtendedIconFix-1.2.0.zip
檔案大小
1.1 MiB