📦 Containers

Automated container management, auto-opening, and quiver handling.

---

📖 Overview

The Containers module manages your backpacks and their contents automatically. It opens containers on login, organizes items between backpacks, and handles quiver ammunition for paladins.

Key capabilities:

• Auto-open containers on login
• Nested container traversal (BFS)
• Quiver auto-refill for paladins
• Container role assignments (loot, supplies, runes)
• Pagination support for large containers
• Deduplication to prevent opening a container twice

---

🚀 Quick Start

1. Open the Containers panel from the Main tab.
2. Assign roles to your container slots:
   • Slot 0: Main Backpack
   • Slot 1: Loot Container
   • Slot 2: Supplies
   • Slot 3: Runes
3. Enable Auto Open on Login.

---

🏷️ Container Roles

Main Backpack

Your primary container that holds all other backpacks. It should be a large-capacity bag (e.g., a Golden Backpack or an Adventurer's Bag).

Loot Container

Where monster drops go during hunting. Use a large container (e.g. Beach Bag with 36 slots) to maximize hunting time between depot visits.

Supplies Container

Holds your potions, food, and other consumables. HealBot and the food system search this container for items.

Runes Container

Holds your attack and utility runes. AttackBot pulls runes from here during combat.

---

🔓 Auto-Open System

The Container Opener (v12) uses a sophisticated BFS queue system:

1. On login, it waits for containers to load (500 ms delay)
2. Opens assigned containers
3. Scans for nested containers and queues them for opening
4. Handles paginated containers automatically
5. Emits containers:open_all_complete via EventBus when done

Architecture

Component	Responsibility
ContainerQueue	Manages the BFS queue of containers to open
ContainerTracker	Prevents duplicate opens (4-second grace period)
ContainerScanner	Scans containers for nested containers
ContainerOpener	Orchestrates the entire opening process

Deduplication

The queue uses slot-based keys (containerId:absoluteSlotIndex) for robust deduplication. The ContainerTracker prevents re-opening the same slot within a 4-second grace period, even if events fire multiple times.

---

🏹 Quiver Management

For Paladins, the quiver system handles ammunition automatically:

• Monitors equipped ammunition count
• Detects when the quiver is running low
• Refills from supplies container
• Works with all arrow and bolt types

Supported Ammunition

Type	Examples
Arrows	Arrows, Crystalline Arrows, Diamond Arrows, Spectral Arrows
Bolts	Bolts, Power Bolts, Infernal Bolts, Prismatic Bolts, Spectral Bolts

Quiver management is enabled by default — no toggle needed.

---

⚙️ Configuration

Setting	Description	Default
Auto Open	Open containers on login	OFF
Auto Stack	Stack identical items	ON
Sort Containers	Organize item positions	OFF
Close Empty	Close empty containers	OFF
Auto Minimize	Minimize opened containers	Configurable
Rename	Rename containers with labels	Configurable

---

📐 Setup Examples

Knight

Main BP: Golden Backpack
├── Supplies: Beach Bag (potions)
├── Loot: Beach Bag (drops)
└── Runes: Blue Backpack (SD / Magic Wall)

Paladin

Main BP: Adventurer's Bag
├── Supplies: Beach Bag (potions)
├── Loot: Beach Bag (drops)
├── Ammo: Grey Backpack (arrow reserve)
└── Quiver: Auto-managed

Mage

Main BP: Jewelled Backpack
├── Supplies: Beach Bag (mana potions)
├── Loot: Beach Bag (drops)
└── Runes: Blue Backpack (attack runes)

---

🔗 EventBus Integration

-- Subscribe to container events
EventBus.on("containers:open_all_complete", function()
  print("All containers opened!")
end)

The onAddItem handler queues new container items for opening, and onContainerOpen triggers scanning of newly opened containers.

---

❓ Troubleshooting

Containers not opening on login

1. Is Auto Open enabled in the panel?
2. Are containers correctly assigned to slots?
3. Wait a few seconds after login — the opener has a deliberate delay
4. Check console for containers:open_all_complete event

Quiver not refilling

1. Do you have arrows/bolts in a supply container?
2. Is the quiver equipped?
3. Are the arrows the correct type for your weapon?

Items going to wrong container

1. Verify container role assignments
2. Check slot order matches your in-game backpack layout
3. Reset container configuration and re-assign

"Schedule execution error" or nil function errors

This usually means a partial or outdated Containers.lua file. Replace it with the latest version and restart the client.