BJ Scripts · EverQuest II
Consumables Manager
The right consumables for the zone you’re in.
Set up your food, drink, ammunition, potions, poisons, totems, and primary-weapon temporary adornments in one place. Consumables Manager applies your saved zone settings as you play, so there’s less to configure between adventures.
- Choose your supplies
- Build a catalog and select the items each character uses.
- Assign them by zone
- Keep different consumable selections for different destinations.
- Save and play
- Settings apply at startup, on zone changes, and when you save.
Less preparation between adventures
One place for your consumable routine
Build a setup around your character, switch between saved lists, and replenish the supplies you actually use.
Use supplies where they matter
Choose consumables for each zone. CM enables selected managed auto-consumables there and disables managed auto-consume outside your configured selections.
Keep more than one setup
Create, rename, or duplicate zone lists. Import another character’s sub-profile to reuse a setup and adjust it for the next character.
Refill your supplies
Set quantity targets, then restock yourself or connected group members in the same zone from supported nearby depots.
Maintain a temporary adornment
Select one primary-weapon temporary adornment per zone. CM checks the equipped weapon and applies the selected item when it is missing and conditions allow.
See what you have
Refresh items from your inventory, set low quantity warnings, and optionally keep configured consumables together in a chosen bag.
Handle the small details
Use an inactivity timeout, configure mount summoning, and control OgreBot Overseer by zone when OgreBot is running.
01 · Getting started
Build your first zone setup
- Launch CM and open the controller.
With your character in game, enter
BJ CM, thenBJ CM UIin the InnerSpace console. Check that the controller is connected to the character you want to configure. - Choose your character’s consumables.
Click Manage, then Refresh inventory. Check Use for the items you want available to this character and save the catalog.
- Add a zone.
Use Add current zone, Add manual, or Import zones. Select the zone in Configured Zones.
- Make your selections.
Choose food, drink, and ammo, then check the potions, poisons, totems, and temporary adornment you want for that zone.
- Save your profile.
Click the main Save button. Saving writes the character settings and requests a runtime reload. Review the controller’s status message to confirm the request.
Start with a zone you can check. Save a small selection, verify the chosen items in game, and then add the rest of your destinations.
02 · Catalog & consumables
Choose what CM manages
The catalog stores item names and categories. The Use checkbox controls availability for the current character; the selections under Zone Consumables decide where to use each item. Enabling an item in the catalog alone does not assign it to a zone.
Use Refresh inventory to discover supported items. Add manual item lets you enter a name and category when needed; use the exact in-game item name.
| Category | How to configure it |
|---|---|
| Food & drink | Choose one food and one drink for each zone. CM manages the selected slots and their auto-consume settings. |
| Ammo | Choose the ammunition for that zone. Keep a usable supply available for CM to equip. |
| Potions, poisons & totems | Check the items to enable in the selected zone. These lists allow multiple selections. |
| Temporary Adornments | Select one temporary adornment for the equipped primary weapon. Selecting another replaces that zone’s previous selection. |
| Other | Contains the OgreBot Overseer option. This controls an OgreBot setting; it is separate from the item catalog. |
CM controls managed auto-consume settings. Turning those settings off does not remove consumable effects or temporary adornments already applied.
03 · Zones & profiles
Give each character a flexible setup
The Profile selector opens saved character settings. Each character can have multiple named Zone Lists, with its own consumable selections for each zone.
Default list
The baseline list for the character. Restocking always reads this list from the saved profile and collects the items configured across its zones.
Active list
The list currently selected for editing and use. Saving an active list different from the default enables that list as an override for zone consumption.
- New / Rename / Duplicate: create and maintain alternate zone setups.
- Import: choose a source character and sub-profile. CM adds a separate list and brings in missing quantity settings for the imported items.
- Import zones: add zones from the supplied zone catalog.
- Purge zones: remove empty zones from the active list.
- Save: persist edits and request a reload for the relevant character.
Check the connected character before restocking. Selecting another saved profile for editing does not change the live character that receives the restock request.
04 · Everyday settings
Tune your routine
- Inactivity timeout
- Set a timeout from 1–240 minutes. When CM detects inactivity in a configured zone, it disables managed consumables when conditions allow. Movement resumes activity, and zone settings are reapplied when safe.
- Low quantity warnings
- Enable warnings and use Quantities to set each item’s Minimum. Choose a threshold that gives you time to restock.
- Keep consumables in bag
- Enable the organizer and select a bag number from 1–12. Make sure the destination bag is present and has space for configured consumables.
- Summon mount
- Enable mount summoning and select the maintained effect used to recognize your mount. The controller can refresh maintained effects from the connected character.
- OgreBot Overseer
- Check this under Other for the zones where Overseer should be enabled. CM updates OgreBot’s Overseer setting when OgreBot is running.
- Debug logging
- Enable detailed diagnostics when investigating skipped items, delayed actions, or restock behavior. The controller’s status and InnerSpace console help explain what CM is waiting for.
Click the main Save button after changing these settings or editing quantities.
05 · Restocking
Replenish your saved supplies
CM withdraws configured items from supported nearby depots to reach your saved quantities. Restocking uses items from the character’s saved Default zone list, including food, drink, ammo, potions, poisons, totems, and primary temporary adornments where a supported depot holds stock.
- Set your quantities and save.
Open Quantities. Minimum is the low quantity warning threshold; Restock Target is the desired inventory total. A positive target takes precedence. If the target is blank or zero, CM uses a positive minimum; if both are blank or zero, the item is skipped.
- Stand near a supported depot.
CM searches within 20 in-game distance units. Use accessible Food & Drink, Poison/Potion/Totem, or Ammo depots and personal stashes, including supported large variants. Available stock and withdrawal permissions still apply.
- Choose Me or Group, then Restock Now.
Me runs for the connected character. Group requests restocking for connected group characters in the same zone; each uses its own saved default list and quantities.
- Watch the status or stop the run.
The action button becomes Stop while restocking. Cancellation checks a withdrawal already in progress before finishing, so it may briefly show Cancelling.
Example: with 8 items in inventory, a minimum of 10, and a target of 40, CM aims to withdraw 32 more, subject to stock and access. Restocking can finish with shortages when nearby sources are exhausted; review the reported result.
Start from a live, connected character outside combat and zoning. Save profile edits first. A runtime-dependent request can start CM automatically if it is stopped; stopping or cancelling does not start it.
06 · Temporary adornments
Keep your primary weapon prepared
Use Temporary Adornments, above Other beside the Totems list, to select one item for each zone. The catalog’s Use selection still controls availability for the character.
- Supported items: temporary adornments for the primary weapon, such as Smoldering Scroll of Combat and Sathirian Rune of Combat. Permanent adornments and temporary adornments for other equipment slots are excluded.
- Inventory discovery: CM examines the item’s slot and item type. Refresh inventory while out of combat and in a stable zone; skipped inspections can be retried with another refresh.
- Application: CM checks the weapon’s attached adornment names and only applies the selected item when that name is absent. It waits for eligible conditions, including being out of combat and not casting.
- Weapon changes: changing the primary weapon or leaving an eligible state cancels a pending application. Leaving a configured zone does not remove an existing adornment.
- Confirmation: CM verifies the attachment. An unconfirmed application is not automatically repeated on the same weapon; reloading the profile does not clear that protection.
If an application is unconfirmed, check the weapon and enable Debug logging to investigate. CM relies on the actual attachment rather than a guessed duration timer.
07 · Command reference
Keep the useful commands close
Enter these commands in the InnerSpace console. Copy buttons copy text only.
| Command | Action | Copy |
|---|---|---|
BJ CM | Start or restart Consumables Manager. | |
BJ CM UI | Open the settings controller. | |
BJ CM reload | Reload saved settings and apply them. | |
BJ CM snapshot | Refresh the inventory snapshot. | |
BJ CM maintained | Refresh the maintained-effects snapshot. | |
BJ CM restock me | Restock the current character from nearby supported depots. | |
BJ CM restock group | Request restocking for connected group characters in the same zone. | |
BJ CM restock stop | Request cancellation of the restock run. | |
BJ End CM | Stop the Consumables Manager runtime. |
No commands match. Clear the search to see the full reference.
08 · Troubleshooting
Find the next step
An item is missing from my zone choices.
Open Manage, refresh inventory, and check the item’s category and Use setting. Save the catalog, assign the item to the zone, and save the main profile. For a temporary adornment, verify it supports the primary weapon and refresh while out of combat.
My consumables are not enabled in this zone.
Check the selected character profile, active zone list, exact zone name, and saved item selections. Confirm that CM is running and the items are available. An enabled inactivity timeout can temporarily disable managed consumables; movement resumes activity and eligible conditions allow the zone settings to be reapplied.
Restocking skipped an item or did not fill the target.
Verify that the item is configured in the saved Default list and has a positive restock target or minimum. Check nearby supported depot stock, access permissions, range, and inventory space. The active consumption list can differ from the list used for restocking. Read the run’s status for shortages or unavailable sources.
A controller action reports that the runtime is not ready.
Confirm the live character is connected and ISXEQ2 is ready. Runtime-dependent requests normally start CM and wait for readiness before continuing. Check the controller’s status and InnerSpace console for a startup failure, confirm the installed BJ Scripts components are current, then retry the action.
Can I reuse a setup on another character?
Yes. Open the destination profile, choose Import, and select the source character and sub-profile. Review the imported items and quantities for the destination character. Each character still needs its own supplies and saved settings.
Where are my saved settings?
Character profiles are stored under Scripts/BJScripts/EQ2/Consumables/Config/Characters/, using a {server}_{character}.json file for each character. Keep backups of your configuration before moving or replacing an installation.
Where can I report a problem?
Use the BJ Scripts bug tracker. Include your CM version, the command or control you used, the observed result, and relevant status or debug messages.
Ready for the next adventure
Make your setup part of your routine.
Explore BJ Scripts packages or open the setup guide to configure your first zone.
