Configuration & everyday use

Consumables Manager
User Guide

Configure your first character, assign consumables to a zone, and check that the setup works in game.

Follow the first five sections in order. Then configure the optional settings, set your refill quantities, and use the restocking and profile instructions when you need them. Numbered pictures show the controls used in each step.

Start the walkthrough →
  1. 1. Open CM
  2. 2. Build the catalog
  3. 3. Add a zone
  4. 4. Choose items
  5. 5. Save & verify

BJ Scripts · EverQuest II · Runtime 2.146

First setup · Step 1

Open CM and identify your character

Before you begin

  • Run EverQuest II through InnerSpace on Windows.
  • Make sure ISXEQ2 is ready and your character is in game.
  • Have ISXBJEQ2 and the Consumables Manager controller/client installed and available to your account.
  • Put the consumables you want to configure in your character’s inventory.

Use the connected character first

For the first setup, keep Profile set to the character shown after Live:. Inventory scans and restock requests use the connected live character.

The profile selector also lets you edit other saved characters. That selection does not switch the live game session.

1. Start the runtime. Enter this in the InnerSpace console.

BJ CM

2. Open the controller. Enter this in the same session.

BJ CM UI

Already running? Use BJ CM UI to open settings. Running BJ CM again restarts the runtime.

Consumables Manager for Aelira on Moonspire. Callouts identify 1 live context and profile, 2 zone lists, 3 configured zones, 4 zone consumables, 5 settings, and 6 Save.
Find your way around the controllerRead the Live character and current zone before making changes.
  1. Live context & ProfileConfirm the connected character and the saved profile being edited.
  2. Zone ListsChoose the default list and the active list.
  3. Configured ZonesSelect the zone whose item choices you want to edit.
  4. Zone ConsumablesOpen Manage or assign items to the selected zone.
  5. SettingsAdjust inactivity, quantities, bag organization, and restocking.
  6. SaveWrite the profile and request that the runtime apply it.

Check before continuing: the Live character, Profile, and current zone match the character and location you intend to configure.

First setup · Step 2

Build the character’s catalog

The catalog defines item names and categories. The Use checkbox makes an item available to the character you are editing. Zone selections determine where it is used.

  1. Click Manage in Zone Consumables.

    The Manage Consumable Catalog window opens.

  2. Refresh, then add inventory items.

    Click Refresh inventory 1 and wait for the scan to finish. Open the inventory dropdown 2 and select an item to add or update it in the table. Repeat for the items you want to manage.

  3. Check availability and categories.

    Enable Use 3 for each item needed by this character. Check the Name and Category columns. For a missing item, choose Add manual item, replace “New Consumable” with the exact in-game name, and choose the appropriate category.

  4. Save the catalog.

    Click Save 4 to return to the controller. Assign these items to a zone in the next steps.

Manage Consumable Catalog: 1 Refresh inventory, 2 inventory item dropdown, 3 Use column, and 4 Save.
Refresh → select items → check Use → SaveThe inventory dropdown adds items to the catalog table.

Changing Use affects existing selections. Saving the catalog with an item unchecked removes that item’s assignments from this character’s zone lists. To stop using an item in only one zone, change that zone’s selection instead.

Check: the saved items appear in the appropriate dropdowns or checklists under Zone Consumables.

First setup · Step 3

Create a list and add a zone

Zone controls: 1 Default list, 2 Active list, 3 selected zone The Shimmering Citadel, and 4 Add current zone.
Choose the list before editing its zonesKeep Default and Active list together for your first setup.
  1. Name your first list.

    Use the initial Current list, or click Rename and name it Adventuring. To make a separate list, use New.

  2. Set Default and Active list.

    For the first setup, select the same list in both controls 12. This keeps consumption and restocking based on the same set of zones.

  3. Add your destination.

    Click Add current zone 4 to add the zone shown in the controller. If you are configuring another location, use Add manual and enter its exact zone name.

  4. Select the zone.

    Click the zone in Configured Zones 3. The controls on the right now show that zone’s consumable choices.

Import zones adds missing entries from the supplied zone catalog. It does not assign consumables for you. Purge zones removes empty entries from the active list; Delete beneath the zone list removes the selected zone.

Check: your intended list is active and the intended zone is highlighted before you choose items.

First setup · Step 4

Assign items to the selected zone

Make selections in Zone Consumables. Repeat this process for each zone that needs a different setup.

Zone Consumables: 1 food, drink and ammo dropdowns, 2 potions, 3 poisons, 4 totems, 5 temporary adornments, and 6 Other.
Every selection belongs to the highlighted zoneCatalog availability and zone assignments are separate choices.
Picture controlWhat to do
1 · Food, Drink, AmmoSelect one item in each dropdown you want CM to manage for this zone. Leave a selection blank when you do not want an item assigned there.
2–4 · Potions, Poisons, TotemsCheck each item you want enabled. These lists allow multiple selections; only choose combinations suitable for your character.
5 · Temporary AdornmentsCheck one temporary adornment for the equipped primary weapon. Checking another replaces the previous selection for this zone.
6 · OtherCheck OgreBot Overseer if you want it enabled in this zone while OgreBot is running. This controls an OgreBot setting, rather than consuming an inventory item.

Configure a primary temporary adornment

  1. Keep a supported primary-weapon temporary adornment in inventory.
  2. Refresh inventory while out of combat, enable the item’s Use setting in Manage, and save the catalog.
  3. Choose the zone, then check the item under Temporary Adornments.
  4. Save the main profile. When conditions allow, inspect the equipped primary weapon to confirm the selected attachment.

CM checks attached names rather than an estimated expiration timer. Permanent adornments and temporary adornments for other slots are excluded. Application waits for eligible conditions, including being out of combat and not casting; a weapon change cancels pending work.

Disabling a zone’s auto-consume settings does not remove effects or temporary adornments that are already applied. An unconfirmed adornment application is not automatically repeated on the same weapon; inspect the weapon and use Debug logging to investigate.

First setup · Step 5

Save, apply, and verify in game

  1. Click the main Save button.

    This writes the character profile and requests a runtime reload. Read the status line at the bottom of the controller.

  2. Check the saved result.

    A message saying the profile was saved and a reload requested confirms that the request was sent. If it says the script signal was unavailable, the settings are saved, but you still need a running, connected runtime to apply them.

  3. Check your character in the configured zone.

    While out of combat and in a stable zone, verify food/drink/ammo choices and the intended managed auto-consume settings. Check the primary weapon if you assigned a temporary adornment. Some actions wait until the character is eligible.

  4. Try the next zone.

    CM reapplies saved choices on zone changes. In a zone without configured selections, managed auto-consume is disabled. Existing buffs can remain until they expire.

Save and Reload have different jobs
ControlResult
Main Save buttonSaves editor changes and requests that the relevant character’s runtime reload the profile.
Main Reload buttonReloads the editor from saved files. If edits are unsaved, it asks before discarding them. It does not save or apply those unsaved edits.
BJ CM reloadRequests that the runtime reload and apply the settings already saved on disk.

Your first setup is complete when: the correct profile and zone list are saved, your items are assigned, and the expected item settings appear in game.

Optional configuration · Step 6

Adjust the everyday settings

These options belong to the character profile. Change the options you need, then click the main Save button.

Settings: 1 Inactivity timeout, 2 Keep consumables in bag, 3 Low quantity warnings, 4 Summon mount and maintained effect, and 5 Debug logging.
Set preferences for the characterQuantities and restock controls sit below the everyday settings.
1 · Inactivity timeout
Check the box and choose 1–240 minutes. CM uses character movement to track activity. When the timeout is reached in a configured zone and conditions allow, managed consumables are disabled. Movement resumes activity and zone settings are reapplied when safe.
2 · Keep consumables in bag
Enable the option and choose a bag number from 1–12. Confirm the destination bag exists and has available space. CM organizes configured consumables there.
3 · Low quantity warnings
Enable this to receive warnings for configured minimums. The checkbox does not set a threshold by itself; enter minimums under Quantities in the next section.
4 · Summon mount
Summon the desired mount in game so its maintained effect is available. Enable Summon mount, open the effect dropdown, and choose the effect that identifies your mount. The dropdown requests a fresh maintained-effects snapshot. CM uses the game’s summon_mount action when that effect is absent and conditions allow; this option does not choose a different mount from your collection.
5 · Debug logging
Enable this while investigating behavior, save, and inspect the InnerSpace console for diagnostic messages. Turn it off and save again when you are finished troubleshooting.

Stock management · Step 7

Set warning minimums and refill targets

Assign items to zones first, then click Quantities in Settings. The dialog lists configured items. If an item is missing, return to its zone assignment before setting quantities.

Consumable Quantities: 1 Minimum column, 2 Restock Target column, and 3 Save. Trail Rations has a minimum of 10 and a target of 40.
Minimum and Restock Target are separate valuesSet whole numbers without commas, then save both the dialog and the main profile.
  1. Enter Minimum values.

    The Minimum column 1 sets the low stock threshold for warnings. Enable Low quantity warnings in Settings if you want those warnings.

  2. Enter Restock Target values.

    The Restock Target column 2 sets the total quantity you want to have after restocking, rather than the number to withdraw. Use non-negative whole numbers such as 40 or 1000.

  3. Save in both places.

    Click the dialog’s Save button 3, then click Save on the main controller to persist the updated profile before restocking.

A refill example

Already carried8Warning minimum10Restock target40Needed to reach target32

CM aims to withdraw 32 more items, subject to stock and access. With a positive target, restocking can refill you even when your current count is above the warning minimum.

Blank or zero target: CM falls back to a positive Minimum. If both values are blank or zero, the item is skipped by restocking. A positive Restock Target takes precedence over Minimum.

Stock management · Step 8

Restock yourself or your group

Restocking reads the connected character’s saved Default zone list. It gathers configured items across that list’s zones and uses the saved quantity settings. A different Active list does not change the restock source.

Restock controls: 1 Quantities, 2 Me, 3 Group, and 4 Restock Now.
Choose the restock scopeMe and Group are alternative selections.
  1. Save the profile and check its Default list.

    Items need a positive target or minimum. Save any edits before starting the run.

  2. Move near a supported depot.

    Stand within 20 in-game distance units of an accessible Food & Drink, Poison/Potion/Totem, or Ammo depot or personal stash. Supported large variants are included. Make sure there is stock, you have withdrawal access, and your inventory has space.

  3. Close any open depot or container window.

    Begin from a stable zone outside combat. Restock can reject a request while dead, hated, zoning, or casting; wait until those conditions clear.

  4. Choose Me or Group, then Restock Now.

    Me 2 restocks the connected live character. Group 3 requests restocking for connected group members in the same zone. Each participant uses its own saved default list, quantities, and nearby stock. Group requests require working Ogre communication between sessions.

  5. Watch the status line.

    The button 4 changes to Stop while running. Read the final status for completion, unavailable sources, or remaining shortages.

To cancel: click Stop or enter BJ CM restock stop. The run may briefly show Cancelling while it checks a withdrawal already sent. Stop/cancel requests do not start a stopped runtime.

Selecting another saved Profile in the controller does not redirect restocking to that character. Check the Live: identity before choosing Me or Group.

Check: compare the resulting inventory counts with your targets. A run can finish below target when available nearby stock is exhausted.

Reusable setups · Step 9

Use alternate lists and import a setup

Switch between lists on one character

Use New for a blank list or Duplicate for a copy of the active list. Give the list a useful name, choose it under Active list, adjust its zone assignments, and click the main Save button.

Saving an Active list different from Default enables that list as the consumption override. To return to the baseline, select the Default list as Active and save. Restocking continues to use the saved Default list.

Import from another saved character

Import Character Sub-Profile: 1 source character list with Brenwick and Elowyn on Moonspire, 2 Adventuring sub-profile, and 3 OK.
Choose the source, then its sub-profileImport adds a separate zone list to the destination profile.
  1. Open the destination Profile.

    Choose the character that should receive the setup, then click Import in Zone Lists.

  2. Select a source character.

    Choose a saved character in the source list 1. At least one other character profile must exist.

  3. Select the sub-profile and click OK.

    Choose the desired zone list 2, then click OK 3. CM adds it as a separate list, selects it, saves the profile, and requests a reload when a signal is available.

  4. Review the destination’s setup.

    Check item availability, zone choices, and quantities. Missing quantity settings for imported items are copied; existing destination quantity entries are retained. Select the intended Default list and save any further edits.

Profile selection saves the outgoing profile. Switching the Profile dropdown writes the profile you were editing before opening the next one. To discard unsaved edits, use the controller’s Reload button and confirm the discard before switching profiles.

Everyday use

Your routine after setup

  1. Start CM for the character you are playing.

    Use BJ CM when the runtime is stopped. Saved zone choices are applied at startup.

  2. Play through your configured zones.

    CM updates managed selections on zone changes. Keep the configured items stocked and allow pending equipment or item actions to finish when the character is eligible.

  3. Save whenever you change settings.

    Open BJ CM UI, make your edits, and click Save. Refresh inventory after acquiring new items you want to add to the catalog.

  4. Refill at your depots.

    Review quantities, save, then use Me or Group and Restock Now.

  5. Stop when you are finished using CM.

    Enter BJ End CM to stop the runtime.

Quick reference

Console commands

Enter these in the InnerSpace console for the relevant game session. The Copy buttons copy the command text.

CommandPurposeCopy
BJ CMStart or restart the runtime.
BJ CM UIOpen the controller.
BJ CM reloadReload and apply the saved profile in the runtime.
BJ CM snapshotRefresh the inventory snapshot.
BJ CM maintainedRefresh the maintained-effects snapshot.
BJ CM restock meRestock the current character.
BJ CM restock groupRequest restocking for connected same-zone group members.
BJ CM restock stopCancel the restock run.
BJ End CMStop the runtime.

Runtime-dependent requests, including reloads, snapshots, and restock starts, can start CM and wait for readiness when it is stopped. A readiness failure is reported in the controller instead of silently applying the request.

Troubleshooting

Find the step to check

The inventory scan finished, but my item is not in the catalog.

Open the inventory dropdown in Manage and select the item to add or update its catalog row. Check Use, verify the category, and save. Refreshing the snapshot updates the available inventory choices; it does not replace the step of selecting items into your catalog.

The item is in Manage but missing from the zone controls.

Verify its Use checkbox and category, then save the catalog. Confirm that you are editing the intended character. For a temporary adornment, use an item for the primary weapon and retry the scan while out of combat in a stable zone.

I saved, but the expected item settings are not active.

Check the Live character, selected Profile, Active list, and exact zone name. Confirm that the chosen items are in inventory and the runtime is running. Read the save status for a missing script signal. If the profile is saved, use BJ CM reload to request that the runtime apply it.

Consumables turned off while I was standing still.

Check whether Inactivity timeout is enabled. CM tracks movement, so standing in place can count as inactivity. Move the character and allow eligible conditions for the zone settings to be reapplied, or adjust the timeout and save.

Restock skipped everything or used a different set of items.

Check the saved Default list, not just Active list. Each item needs a positive Restock Target or Minimum. Assign the items to zones in the Default list and save before retrying. For Group, check each participant’s own saved profile.

Restocking stopped before reaching my target.

Read the final status. Check depot range, stock, withdrawal permissions, and inventory space. Close an existing depot/container window before starting. Wait for combat, zoning, casting, or a pending ammo move to finish before retrying.

The mount does not summon.

Confirm Summon mount is enabled and a valid mount maintained effect is selected. Summon the mount manually, reopen the effect dropdown to refresh it, select its effect, and save. A blank effect, inactivity, casting, combat, or zoning can prevent the action.

The temporary adornment was not applied.

Check the selected zone, available item, equipped primary weapon, and attached adornment names. CM waits for eligible conditions and cancels pending work when the weapon changes. If an application was unconfirmed, inspect the weapon and use Debug logging; repeatedly reloading the profile does not clear the protection against an automatic repeat.

The controller reports that the runtime is not ready.

Check the live connection, ISXEQ2 readiness, and the InnerSpace console. Make sure the installed BJ Scripts components are current, then retry. For a reproducible problem, use the BJ Scripts bug tracker and include the CM version, steps taken, status message, and relevant debug output.

Keep your configuration

Back up your saved settings

After saving, keep a copy of the Scripts/BJScripts/EQ2/Consumables/Config/ folder before moving or replacing an installation. Character profiles are under Characters/ with filenames in the form {server}_{character}.json. The shared item catalog is ConsumableCatalog.json.

After restoring files to a compatible installation, open the controller and use Reload to refresh the editor from disk. Check the profile and use BJ CM reload in the relevant session to apply saved settings to the runtime.

Back to the walkthrough

Picture

Choose Actual size to read details, then scroll to explore. Press Escape to close.

Shopping Cart
  • Your cart is empty.