Bank Stander Plugin
The Bank Stander plugin provides automation for common bank-standing tasks like using items on each other (e.g. fletching, herblore, crafting), using items on objects, and casting spells on items. It is fully integrated into the n3plugins suite and implements strict anti-ban, input lock handling, and BreakHandlerPlugin integration.
Features
- Multiple Modes: Supports Using Item, Item on Item, Item on Object, Using Object, and Spell on Item.
- Loadout Verification: Takes a comma-separated list of item names (the Loadout String) and ensures the player always withdraws and equips them if missing from equipment.
- Automatic Bank Handling: Withdraws any configured primary and secondary items in the correct quantities regardless of mode, and deposits anything else automatically.
- Make-X / Smithing Support: Automatically handles Make-X and Smithing dialogs through
ProductionApi. Selects a specific product by name when Make Item is configured, or falls back to the first option. - Anti-Ban and Breaks: Uses
ActionPacerfor paced tick actions and registers directly with the suiteBreakHandlerPlugin.
Configuration Options
| Setting | Description |
|---|---|
| Toggle hotkey | Starts or stops the Bank Stander execution. |
| Mode | The behavior of the bank stander (e.g. ITEM_ON_ITEM for Herblore, SPELL_ON_ITEM for Alching). |
| First Item / Tool | The primary item to withdraw and use (e.g., "Knife", "Vial of water"). |
| First Amount | The quantity of the primary item to withdraw per trip (default 14). |
| Second Item | The secondary item to withdraw (e.g., "Logs", "Guam leaf"). |
| Second Amount | The quantity of the secondary item to withdraw per trip (default 14). |
| Ignore Items | A comma-separated list of items to always leave in the inventory and never deposit (e.g., "Coins, Rune pouch"). |
| Target Object | Used for the ITEM_ON_OBJECT and USING_OBJECT modes. |
| Auto Make-X | If enabled, the plugin automatically handles Make-X dialogs when they open. |
| Make Item | Item name to select in the Make-X interface (e.g., "Maple longbow", "Rune dart tip"). Leave empty to select the first option. |
| Show Set Options | Adds right-click menu entries to set First/Tool, Second, Object, Option, and Make Item directly from inventory, bank, object, or production widgets. |
| Show overlay | Shows the in-client Bank Stander status overlay with running state, mode, Break Handler state, last action, and last failure. |
| Loadout String | A comma-separated list of equipment item names (e.g. "Abyssal whip, Dragon defender"). The plugin ensures these are equipped. |
| Spell Name | The name of the spell to cast for the SPELL_ON_ITEM mode (e.g. "High Level Alchemy"). |
Architecture
The plugin is designed around a simple state machine inside BankStanderPlugin.java:
- WAITING: The plugin is idle or stopped.
- BANKING: The plugin opens the bank, deposits unwanted items, withdraws necessary loadout items or primary/secondary items, and equips loadout items.
- PROCESSING: The plugin closes the bank and executes the chosen
BankStanderModeaction (e.g., combining items, casting a spell, or using an object).
Invariants
The plugin relies on PacketUtilsPlugin.requireAccountBootstrap and PacketUtilsPlugin.releaseAccountBootstrap. The BreakHandlerPlugin is notified when the plugin is running to ensure mandatory rest intervals are enforced.
All actions route through com.n3plugins.InteractionApi.actions.* which return an InteractionResult to preserve input-lock hygiene and tick-pacing constraints.