CommandQueue.IconFix

CommandQueueIconFix (1.0.3) — Companion extension for CommandQueue: fixes the "white squares" that appear in place of item icons after the game update. The base mod is neither replaced nor bundled — a soft dependency on com.kuberoot.commandqueue is declared instead.

⚠️ Disclaimer: This mod was AI-generated and has not been fully tested alongside other mods. Conflicts or unexpected behavior when combined with third-party plugins are possible.

Extension for CommandQueue — fixes the white item-icon squares introduced by the October 2026 game update (buildid 25921972) without bundling or replacing the mod itself; it declares a soft dependency on com.kuberoot.commandqueue and repairs its runtime behavior.

What happened

The game update moved pickup icons to async/Addressables loading: PickupDef.iconSprite is now often null until the reference resolves, while the game's own UI uses AsyncImage + AssetReferenceT<Sprite>. Any mod that assigns Image.sprite = pickupDef.iconSprite directly (e.g. the CommandQueue item grid) shows white squares, and the old Resources.Load of the lock icon returns null.

What it does

1. Icon backfill — at run start it resolves every pickup icon through the new public API (PickupDef.GetIconAODR(true) → WaitForCompletion()) and writes the resulting sprite back into the public PickupDef.iconSprite field. Any code reading that field afterwards (CommandQueue included) then gets a valid sprite.

2. UI repair pass — locates the scoreboard container that CommandQueue creates (CommandQueueContainer) and for any item button whose Icon image is still empty assigns the correct sprite: available items get their icon (button order is recomputed with the same public APIs the game and the mod use), locked buttons get the unlock/lock icon loaded via LegacyResourcesAPI.

Everything uses only public game APIs — no IL patching, no method detours. On game builds without the async icon pipeline the plugin feature-detects and stays completely idle. It is also idempotent: alongside a CommandQueue that already has official support it simply finds nothing to fix.

Requirements

• BepInEx 5 + HookGenPatcher (same set as for CommandQueue)
• CommandQueue ≥ 1.7.0 installed (soft dependency — the plugin loads without it, but then has nothing to fix)

Install

• Thunderstore Mod Manager: just install Rewanit-CommandQueueIconFix — TMM pulls in CommandQueue itself if it's missing.
• Manual: copy the CommandQueue.IconFix folder into <game>\BepInEx\plugins\.

Verify

Start a run, open the scoreboard (Tab) → Command Queue tab: item icons must render; locked items show the lock icon. Logs: <game>\BepInEx\LogOutput.log — search for CommandQueue.NewGameFix ("Backfill done: …", "IconFix repair finished: N button icon(s) assigned").

Changelog

1.0.3

• Added per-tier mapping diagnostics to the log (Tier X: grid images=N, items=M, first='…', last='…', plus a duplicate warning if the mod's own item list contains repeats) — no behavior change.

1.0.2

• Fixed an off-by-one icon mapping: each tier container also carries the per-tier "repeat" toggle button (an HGButton with its own Icon child, created before the item grid). It was collected first and shifted every item icon by one slot, leaving the last item white. Icon collection is now scoped to the item grid (the sub-container with the largest number of grid buttons), so each button gets exactly its own item's icon.

1.0.1

• Button icons are now assigned through the game's own async icon pipeline (AsyncImage) instead of one-shot sprite resolution. This fixes white squares that persisted for icons still loading at run start (the one-shot path returned null while the scene was loading). Direct sprite assignment remains as a fallback.
• Added an "IconFix repair finished" summary log line.

1.0.0

• Initial release: icon backfill + UI repair pass.

---

Crossed-wrenches glyph: Font Awesome Free 6.5.2 by Fonticons Inc. — icons licensed under CC BY 4.0 (https://fontawesome.com/license/free).