CommandQueue Remastered

Beta 0.4.1 — plan your Artifact of Command picks directly in the Risk of Rain 2 scoreboard.

Development build for branch testing. Gameplay and multiplayer testing is incomplete; some essences can remain on the ground while moving.

Build item queues, repeat your preferred picks and save presets without leaving the game's interface. Remastered combines the functionality of CommandQueueExtended, CommandQueueExtendedIconFix and ProperSave_CommandQueueExtended in one mod.

Features

• Scoreboard integration: switch between the original Players overview and Command Queue using the game's configured scoreboard key.
• Optional gameplay controls: choose On, CommandQueueOnly or Off for BlockGameplayInput to control which scoreboard views block movement and gameplay buttons.
• Item queues: add quantities, reorder or split stacks with drag and drop, remove items and clear queues with confirmation.
• Automatic Command selection: selects the next queued item for the essence's actual tier. Empty queues or unavailable next items normally open the manual selection menu. Temporary/ethereal essences skip entries unavailable in their pool; exclusive-item behavior is configurable below.
• Queue and Limiter: switch views per item group. The third button shows Repeat in Queue view or the independent Limiter On/Off state in Limiter view. Pause remains a separate group control.
• Repeat modes: rotate selected items to the end, or cycle through the planned quantities while keeping the displayed order and counts fixed.
• Presets: save, load, preview, rename and delete queue plans. Drag preset rows to reorder them; the order is saved automatically.
• Item information: icons, permanent inventory counters and a scrollable description panel with optional LookingGlass stats.
• Configurable special pickups: choose separate behavior for temporary and ethereal Command items. Configure six exclusive items to select when queued anywhere or automatically even without a queue entry.
• Optional integrations: RiskOfOptions for in-game settings, LookingGlass for descriptions and ProperSave for run queue persistence.
• Essence locations: configure each actual item tier independently: original location, round robin, killer or player with fewest permanent items.
• Optional item collection: collect automatically selected queued items using native item-transfer orbs. Manual choices and selections without a queue entry still drop normally.

Groups appear in this order: White, Green, Red, Lunar, Boss, Void, Hallowed, Hex, Pages. Void items share one tab and show rarity color strips; automatic selection and Repeat remain separate for each actual Void tier.

Installation

Install with r2modman or another Thunderstore-compatible mod manager. BepInExPack and SeekersPatcher must be installed.

Disable or remove these older mods from the same profile before using Remastered:

• CommandQueueExtended
• CommandQueueExtendedIconFix
• ProperSave_CommandQueueExtended

Remastered replaces them and prevents simultaneous loading. ProperSave itself is a separate optional mod and should remain installed if you want to save your queue with a run.

RiskOfOptions and LookingGlass are optional. Without RiskOfOptions, use the configuration file. Without LookingGlass, descriptions use the game's normal text.

Getting started

1. Start a run with the Artifact of Command enabled.
2. Open the scoreboard using your game key, normally Tab, and select Command Queue.
3. Choose an item group and click the items you want to queue.
4. Interact with a matching Command essence. Remastered selects the next eligible queued item automatically.

The Players button returns to the original scoreboard overview. Keyboard and mouse are the intended controls; controller support has not been tested and controller compatibility is unverified.

Controls

Ctrl takes priority over Shift when removing or dragging. Matching neighboring items within a group merge after moves, removals and Repeat rotation. A full stack remains separate from any overflow; quantities are preserved.

Hover over an item to read its description. If the text is too long, use the mouse wheel over that item or the description panel to scroll it. Descriptions work independently of the game's Enable Inspect setting.

Inventory counters show permanent stacks unless an item has a configured limit, in which case LimiterItemCount controls its owned/limit count. Queue badges show planned quantities instead.

Limiter

Switch between Queue and Limiter above the item grid. The Limiter is a cap, not a second automatic selection list: only items from the queue are selected. Set, for example, syringe limit 3 and glasses limit 2, then keep syringes, glasses and repeating crowbars in the queue. At the cap, syringe/glasses entries are skipped and grayed out without being consumed. They become eligible again after scrapping, trading or otherwise losing counted stacks. If every queued choice is capped, the normal picker opens.

Each item has exactly one Limiter stack, in the order first added. Left-click adds one, Shift-left adds ten; right-click removes one, Shift-right removes up to ten and Ctrl-right removes the target. Ctrl-left does not move targets to the front. Dragging always moves the whole Limiter stack, including with Shift/Ctrl held. Sort by ID replaces the drag shortcut text and sorts the current group in the same catalog ID order as the selection grid. Queue drag/split controls remain available in Queue view.

The selection grid shows owned/limit, for example 5/9. General / LimiterItemCount defaults to PermanentOnly; choose IncludeTemporary, IncludeEthereal or IncludeBoth to count those stacks too, including with UseQueueNormally. Disabling the Limiter for a group ignores its caps and dims only the limit number. Queue-view items with an active cap have a thin silver-gray strip along the bottom edge.

Targets and Limiter On/Off states are included in presets and supported ProperSave payloads; preview always combines both lists. Within each tier, queued items appear first, followed by limiter-only items, before the next tier. Repeated queue entries are summed per item, badges show saved queue quantity/limit (— means no limit), and limiter-only items are gray with quantity zero. No items are automatically added to the queue from the Limiter. The Limiter applies to automatic Command choices, not manual pickups or unrelated sources.

Item Distribution Rules

These host settings have their own RiskOfOptions tab. Defaults: distribution enabled, Bazaar Between Time and Computational Exchange excluded, chest/exchange/teleporter sources enabled, DrifterSalvage set to SkillUser, Hex blocks disabled.

Source/stage exclusions leave the original location and retain normal queue selection/collection settings. Original per-tier mode keeps the original location except for the explicit Drifter SkillUser target, which overrides per-tier modes. Master/stage/source exclusions, personal Ignore and optional paused-group exclusions still apply. With no eligible caster, keep the original skill location; do not redirect to a different Drifter. Source recognition covers the native hooked paths; mods implementing their own sources may bypass these contexts.

Hex blocks override the selected Hex recipient algorithm except Original. With no existing Hex items, give one player seven, then the next. Complete an unfinished block first; with several partial blocks, start with the one closest to completion and finish that player's block. Once complete, rotate by stable player ID. All eligible living players participate, with the existing optional paused-group exclusion. Different Hex items count together; temporary/ethereal stacks are excluded.

LimiterItemCount appears directly above BlockGameplayInput in General. DrifterSalvage uses one dropdown; previous checkbox/target settings are migrated automatically.

RiskOfOptions shows three categories per page for this mod: Groups, General and Special Items on page one; Item Distribution Rules followed by Item Distribution on page two. Other mods retain their native paging. ExcludedStages descriptions list environment names. In the selector, checked means excluded; Apply saves and Cancel discards changes. Defaults selects the two default realms; None allows every stage. Variants sharing a display name are selected together. Existing additional/custom scene exclusions are preserved. On the first startup of this correction, both default realms are added once to the existing exclusions; later changes, including an empty selection, are retained. Advanced comma-separated scene names remain supported in the config file.

Repeat and presets

Pause is the first button of the right-hand action group, followed by Clear Group and Clear All. It pauses automatic selection for the current item group while preserving quantities and Repeat progress; orange indicates paused. The left-hand group contains Queue, Limiter and either Repeat: On/Off or Limiter: On/Off. All six visible buttons have equal width, with a gap between the two groups. Limiter and Repeat use green for On. Pause and Limiter remain independent; pause resets each run while Limiter state is saved with targets.

Drag preset rows to change their order. A cursor label and insertion line show the destination; the list scrolls when dragging near its edges. Order is saved immediately and retained after restarting. Drop outside the list or press Escape to cancel. Selection and preview stay with their preset.

Enable Repeat for the selected group to keep using its plan. With RotateRepeatedItems enabled, each selected item moves to the end and stacks with a matching neighbor. With rotation disabled, the queue cycles through every planned quantity while its displayed order and counts stay fixed. Editing the queue or restoring it starts a new cycle.

Enter a preset name and use Save / Rename to save your plan. Select a saved row, then use Load, Preview, Rename or Delete.

Queue and Limiter load independently: queued entries replace only Queue groups represented in the preset, while limits replace only represented Limiter groups. A limiter-only preset preserves the entire Queue and its Repeat progress; a queue-only or older preset preserves all limits. Unrepresented groups stay intact. An empty preset leaves the current plan unchanged. Preview is read-only and groups items by tier, with queued items before limiter-only items.

Presets are stored in BepInEx/config/commandQueueRemastered.presets.json. With ProperSave installed, run queue persistence is available for singleplayer and the multiplayer host. Multiplayer-client queue persistence is not implemented.

On startup, Remastered imports presets from BepInEx/config/commandQueueSaves.json in the same profile once. Existing Remastered presets remain; the old file stays unchanged. Names, item order and quantities are retained. Repeat starts off because the old file does not store it. Deleting imported presets does not import them again. If the source is missing, it can be added before a later startup; invalid input is logged and retried on the next startup.

Settings

With RiskOfOptions installed, open Settings → MOD OPTIONS → CommandQueue Remastered. Otherwise edit BepInEx/config/local.commandqueue.remastered.cfg.

Essence location settings are controlled by the host/server and affect Command item droplets from all sources. Clients need no mod for relocation. Equipment, Delusion and non-Command drops retain their locations. Actual tier names are used (Tier1 = White, Tier2 = Green, Tier3 = Red, Cursed = Hallowed), with independent choices for all four Void tiers.

RoundRobin alternates between living players by stable network ID, independently per tier, resetting each run. Killer uses the killing player, including owned minions. Missing/dead killers, non-kill sources and delayed boss rewards without a live kill context fall back to round robin. With no living players, keep the original location. Essences remain shared and require interaction; relocation does not reserve or automatically open them.

FewestItems counts permanent stacks plus outstanding permanent essence assignments. Choose AllItems across all items or SameTier for the actual essence tier. Temporary and ethereal items are excluded; ties alternate per tier. Assignments follow the native droplet, essence, selected ground item and transfer orb, and are released on collection, arrival, destruction or run reset. All settings apply immediately. This accounting grants no exclusive ownership of drops.

AutoCollectQueuedItems defaults off and collects only successful automatic selections using an existing queue entry. Manual choices and exclusive Automatic choices without an entry still drop normally. Use AutoPickupCommandEssence to also open matching nearby essences automatically. Pause, group and temporary/ethereal policies retain priority; native item-transfer orbs preserve pickup status and normal consumption/Repeat behavior. In multiplayer, Remastered 0.4.0 or newer and this option are required on both host and selecting client. Older/unmodded hosts retain normal item drops. Multiplayer behavior still needs in-game validation.

Preset files keep their versioned metadata and legacy import status, with one compact preset per line.

Assigned drops wait as complete pickup data until delivery. The host leaves at least 1/30 second between deliveries (at most 30 per second), never creates more than one per rendered frame, and does not catch up with a burst after a frame hitch, using the recipient's current position and the native Command conversion. Waiting drops do not depend on live droplet objects. Missing recipients fall back to the original position and normal physics; Original-location drops keep their normal flight.

AutoPickup uses registered live essences, with at most 32 distance checks, four nearby choice checks and one interaction per local player per step. New essences receive priority and old candidates rotate. No repeated full-scene essence/prompt scan or global sorting is used. Normal interaction range, line of sight, pause and next-frame queue validation still apply. These limits do not constitute a measured FPS guarantee; large bursts and fast multiplayer movement need in-game testing.

RiskOfOptions uses Item Distribution, Special Items, VoidWhite, VoidGreen and VoidRed. Behavior choices in descriptions are separated by blank lines. Existing BepInEx sections and keys retain their stored values.

AutoCollectQueuedItems is under General: automatically collect the item selected from your queue; otherwise it drops on the ground. In multiplayer, enable this on both the host and your client. Moving the setting retains its previous value.

AutoPickupCommandEssence, also under General, automatically opens nearby Command essences within normal interaction range when your active queue has an available matching entry. Empty, paused, disabled or unavailable queues are left alone, including exclusive Automatic choices without an entry. It works while viewing the scoreboard; other menus, dialogs, text input, dragging, another active interaction and obstructing world geometry prevent automatic interaction. Enable AutoCollectQueuedItems as well to collect the selected item.

ExcludePausedPlayers is a General host setting, off by default. It skips players whose matching queue group is paused in RoundRobin, Killer and FewestItems; other groups remain eligible. Void uses its shared pause. When everyone is excluded, the essence keeps its original location. Remote players need this updated mod to report their pause state; unknown or stale states remain eligible. Reports are sent shortly after changes. RiskOfOptions displays the basic tiers as White, Green and Red, retaining existing Tier1/Tier2/Tier3 configuration keys and values.

BlockGameplayInput has three choices and defaults to On:

Changes and view switches apply immediately. In an unblocked view, movement and gameplay buttons stay active after clicking or hovering buttons, while typing preset names, and during the Clear all confirmation. UI actions can therefore also trigger gameplay actions. The UI keeps its normal focus and the cursor remains available for menu interaction; mouse-look follows the game's normal cursor behavior. The actual pause menu and the game's camera-control restrictions remain in effect.

Menu scale affects the whole interface and is limited by the available screen space. Item scale adjusts icon size separately.

Temporary and ethereal pickups each have these choices:

IgnoreTemporaryItems and IgnoreEtherealItems are independent personal True/False settings under Special Items, both off by default. Enabling one excludes only your own player from distribution of that pickup type, even when ExcludePausedPlayers is off. It also disables proximity auto-opening for that type; manual interaction retains your chosen Behaviour. The host's personal settings do not override another player's preferences. Updated clients report only their own choices to an updated host; unknown or stale remote states remain eligible. If every recipient is excluded, the drop keeps its original location. Manually collecting items remains possible.

For temporary items from other sources to route to Drifter, enable a per-tier distribution mode and let other players enable IgnoreTemporaryItems while Drifter leaves it off. For Salvage, select DrifterSalvage = SkillUser (default): Drifter A's drops target A and Drifter B's drops target B. A caster who personally opts out with Ignore is not assigned those drops.

The selected item's temporary or ethereal status is preserved. For temporary and ethereal essences, skip queued items absent or unavailable in that essence and select the next eligible item of the same actual tier. Skipped entries remain queued; consumption and Repeat apply only to the selected entry. If no eligible queued choice exists, open the normal picker. Permanent essences retain their usual head rule.

ExclusiveItemSelection applies to exclusive Command essences offering Halcyon Seed, Newly Hatched Zoea, Exposed Cerebellum, Encrypted Cerebellum, Prison Matrix or Sentry Key. Default requires the item anywhere in the queue. Automatic selects it even without an entry. Automatic selects after you interact with the essence; it does not open an essence by itself. AutoPickupCommandEssence opens it only when an active queue has a matching entry. Existing entries follow consumption/Repeat rules; without an entry, the queue stays unchanged. Pause, disabled groups and temporary/ethereal policies take priority. AutoCollectQueuedItems can collect selections using an existing queue entry; selections without an entry still drop normally. Queued exclusive items that are not offered by the current essence do not block later normal items of the same tier. Those exclusive entries stay queued for their matching essences. Offered but unavailable items still open the manual menu.

Beta status and feedback

This beta targets Risk of Rain 2 1.5.0. Multiplayer behavior and all mod combinations have not been fully validated. Controller support is untested.

Each queue stack supports up to 999 items. Larger imported stacks are split without losing items.

When reporting a problem, include the mod and game versions, steps to reproduce it, relevant settings, and your BepInEx/LogOutput.log. A screenshot helps with interface problems.

Credits

• gabrielgad — CommandQueueExtended.
• KubeRoot — original CommandQueue project.
• KennedyMindsetMovement — ProperSave_CommandQueueExtended, the reference for CommandQueueExtended run queue persistence.
• KingEnderBrine / ProperSave — optional run save integration.
• Rune580 / RiskOfOptions — optional in-game settings UI.
• Wet-Boys / LookingGlass — optional enhanced item descriptions.

AI disclosure

Generative AI (OpenAI Codex) assisted with the development of this mod and the writing of its documentation. In-game testing and feedback were provided by the maintainer. AI assistance does not guarantee correctness; the validation limits described above apply.

VERSION 0.4.1

• Place LimiterItemCount directly above BlockGameplayInput in RiskOfOptions General settings.

• Add independent personal IgnoreTemporaryItems/IgnoreEtherealItems switches (default off), separate from the three Behaviour choices. Exclude opted-out recipients from all distribution algorithms and proximity auto-opening while retaining manual Behaviour. Sync each client's own flags to the host with connection validation and expiry; host preferences affect only the host's own player. With no eligible recipient, preserve the original drop location.

• Skip queued items absent or unavailable in temporary/ethereal Command pools, selecting the next eligible item of the same tier without removing skipped entries. Preserve Pause, Limiter, consumption and both Repeat modes; permanent essence selection retains its usual head rule.

• Add one Item Distribution Rules / DrifterSalvage dropdown: Original keeps the skill location; SkillUser (default) keeps each caster's drops together; ItemDistribution uses the per-tier mode. Migrate previous checkbox/target settings automatically. Master/stage rules and personal opt-outs still apply. Other temporary sources remain independent.

• Add a separate Limiter view with one whole stack per item, independent per-group Limiter On/Off, insertion-order storage and Sort by ID. Limiter drag operations always move whole stacks; Queue retains its split-stack controls.

• Display owned/limit counts in the item selection grid, with LimiterItemCount choosing permanent-only, temporary, ethereal or both special stack types. Mark active limits with a thin silver-gray bottom strip in Queue view. Align Limiter and Void strips to screen pixels, rounding fractional heights down with a one-pixel minimum to keep thin markers consistent between rows. Dim disabled limits and gray out capped queued items. Skip capped entries without consuming or reordering them; make them eligible again after inventory loss. Limiter targets do not select items absent from the queue.

• Save limiter targets and enabled states with presets and supported ProperSave data. Show a combined preset preview with summed queue quantity/limit badges and gray limiter-only items. Continue reading older queue documents. Load Queue and Limiter groups independently so limiter-only presets preserve the Queue and queue-only presets preserve limits. Order previews by tier, with queued items before limiter-only items.

• Add Item Distribution Rules with a master switch, named stage checklist, chest/exchange-pool/teleporter-reward switches and optional Hex blocks of seven. Bazaar Between Time and Computational Exchange are excluded by default; existing additional exclusions are retained. Source exclusions retain original drop locations. Exclude test scenes and combine duplicate Bulwark's Ambry entries.

• Fix FewestItems burst accounting by including outstanding permanent assignments until collection, transfer completion or cancellation. Respect AllItems/SameTier and retain shared pickup access.

• Display distribution options as Hallowed, Hex, Pages in that order while preserving saved configuration keys. Clarify host authority and per-tier tie rotation in FewestItemsCount.

• Arrange six equal-width action buttons in two groups: Queue, Limiter, Repeat/Limiter On/Off on the left; Pause, Clear Group, Clear All on the right. Keep Pause separate from Limiter state.

• Show Groups, General and Special Items on the first RiskOfOptions page; Item Distribution Rules then Item Distribution on the second page. Other mods retain native category paging. New UI, native source and reservation hooks still require in-game validation; custom mod drop paths may bypass source detection.

• Allow matching queued Command essences to open while viewing the scoreboard, retaining guards for other menus, dialogs, typing, dragging and active interactions. Clarify that ExclusiveItemSelection Automatic does not open essences without a matching queue entry.

VERSION 0.4.0

• Add per-tier Command essence distribution: Original (default), RoundRobin, Killer and FewestItems, with independent Void tiers. Missing eligible killers fall back to round robin; with no eligible players, drops retain their original location.
• Add FewestItemsCount: count permanent item stacks across all items or only the matching item tier. Ties rotate between players.
• Add AutoPickupCommandEssence (default off, General): automatically open nearby unobstructed essences only when an active queue contains an available matching entry. Respect interaction range, menus, pause and special-item settings.
• Add AutoCollectQueuedItems (default off, General): collect items selected using a queue entry, preserving pickup status and Repeat rules. Multiplayer requires support and activation on both host and selecting client.
• Add ExcludePausedPlayers (default off, General): exclude players whose matching queue group is paused from distribution. Updated clients report pause states; unknown or stale states remain eligible.
• Queue complete assigned-drop data and create essences at the recipient's current position, limited to 30 per second with at least 1/30 second between deliveries and no catch-up bursts. Bound automatic pickup processing during large drop waves and use current essence geometry for proximity and line-of-sight checks.
• Integrate distribution and collection settings with RiskOfOptions, using Item Distribution, Special Items, consistent White/Green/Red and Void rarity labels, and readable description paragraphs.
• Format preset files with one compact preset per line, preserving contents and legacy import status.

VERSION 0.3.4

• Add BlockGameplayInput in General settings and RiskOfOptions with three choices: On (default, block both scoreboard views), CommandQueueOnly (block Command Queue while allowing gameplay in Players), and Off (allow gameplay in both views). Changes and view switches apply immediately.

VERSION 0.3.3

• Add a Pause button between Repeat and Clear group for the currently selected group. Each group can be paused independently; the button turns orange-yellow when that group is paused. Essences for paused groups open normal Command menus without consuming the queue or advancing Repeat. Other groups continue automatically. The shared Void tab pauses all Void tiers together. Group pauses reset at run start/end and are not stored in presets or ProperSave.
• Reorder presets by dragging their rows. Show a cursor label and insertion line, scroll at list edges, and save the new order immediately. Preserve preset contents, IDs, selection and preview. Drop outside the list or press Escape to cancel.
• Fix queued selection of Halcyon Seed, Newly Hatched Zoea, Exposed Cerebellum, Encrypted Cerebellum, Prison Matrix and Sentry Key from exclusive Command essences, regardless of queue position. Add ExclusiveItemSelection: Default requires a queued entry; Automatic also selects without one. Respect Pause, enabled groups and temporary/ethereal policies. Existing entries follow consumption/Repeat rules; no automatic collection.
• Prevent queued exclusive items from blocking later normal Boss items when the exclusive items are not offered by that essence. Keep the exclusive items queued for their matching essences.
• Prevent outdated automatic selections if the queue changes before the item is selected.

VERSION 0.3.2

• Automatically import legacy CommandQueue / CommandQueueExtended presets from BepInEx/config/commandQueueSaves.json once per Remastered preset file. Keep the source unchanged and retain existing Remastered presets.
• Persist import completion with the presets, including after imported presets are deleted. Retain names, item order and quantities; split stacks above 999. Legacy presets contain no Repeat settings.
• Continue reading existing Remastered preset arrays. Invalid legacy input aborts the complete import and is logged for retry on the next startup.