Documentation

nShopper User Manual

Automate buying and selling items at any OSRS shop with world hopping, teleport support, and GE restocking.

Links: TRiBot Store | Forum Thread | Discord

Table of Contents

Quick Start

  1. Position your character near the shop you want to use
  2. Start the script - it will auto-detect the nearest shop NPC with a "Trade" option
  3. Configure shop details:
    • Verify the Shop NPC Name is correct
    • Click Set Current Tile if the shop location needs adjusting
  4. Add items to buy or sell:
    • Select Buy or Sell transaction type
    • Enter the Item ID (use Help → Item ID List to find IDs)
    • Enter Quantity (0 = unlimited)
    • Click Add
  5. Configure teleports (optional) for faster travel between bank and shop
  6. Click Start

The script will buy/sell items, bank when needed, and world hop when stock runs out.

Script Arguments

Load a saved settings profile by passing the profile name as a script argument:

MyProfile

This loads <tribot-folder>/nScripts/nShopper/settings/MyProfile.ini and starts immediately without showing the GUI. Useful for automation and automatically starting scripts on clients.

Additional options:

  • last - Load the most recently used settings
  • Profiles saved to nScripting.com Settings Storage can also be loaded by name

Requirements

Items/GP Needed

  • For buying: Coins in your bank
  • For selling: Items to sell in your bank
  • For teleports: The configured teleport items (e.g., rings of dueling, games necklaces)

Optional

  • GE Restocking: Requires access to the Grand Exchange
  • Muling: Requires nMule running on a mule account

How It Works

nShopper automates the shop buying/selling process:

  1. Banking - Withdraws coins (for buying) or items (for selling) from bank
  2. Traveling - Walks or teleports to the shop location
  3. Trading - Opens the shop interface and buys/sells configured items
  4. World Hopping - When stock is depleted, hops to another world to find more stock
  5. Repeat - Returns to bank and continues until quantities are met

GE Restocking (optional): When enabled, the script will:

  • Buy teleport items from the GE when you run out
  • Buy items to sell to shops from the GE
  • Sell items bought from shops at the GE when you run low on coins

Muling (optional): Integrates with nMule to:

  • Cash-in: Request gold from the mule at script start
  • Threshold muling: Automatically send excess gold to the mule when GP exceeds a threshold

Progressive Mode (optional): Chain multiple shopping tasks together. Each task runs until its quantities are fulfilled, then moves to the next.

Settings Reference

Shop Configuration

Shop NPC Name

  • The exact name of the shop NPC to trade with
  • Auto-filled with the nearest NPC that has a "Trade" option
  • Must match exactly (case-sensitive)

Shop Location

  • The tile coordinates where the shop NPC is located
  • Click Set Current Tile to use your current position
  • The script searches within 15 tiles of this location for the NPC

Items to Buy/Sell

Transaction Type

  • Buy - Purchase items from the shop
  • Sell - Sell items to the shop

Item ID

  • The OSRS item ID number
  • Use Help → Item ID List in the GUI to look up IDs
  • For item packs (e.g., Feather pack), use the pack's ID - the script will automatically open packs when inventory fills up

Quantity

  • Number of items to buy or sell
  • 0 = unlimited - continues indefinitely (useful with Progressive Mode's repeat option)

Items List

  • Shows all configured items
  • Double-click an item to edit it
  • Drag items to reorder priority
  • Use keyboard arrows to move selected items

Teleports

Configure optional teleports to speed up travel between the bank and shop.

Bank Method / Bank Location

  • Teleport method and destination for traveling to the bank
  • Leave empty to walk instead

Shop Method / Shop Location

  • Teleport method and destination for traveling to the shop
  • Leave empty to walk instead

Equip Checkbox

  • Check this to equip the teleport item (e.g., ring of dueling) before using it
  • Useful for jewelry and other equippable teleport items
  • Only available for equippable teleport methods

Note: Teleports are used once per trip, then walking is used until you bank again. This prevents wasting charges on short distances.

Progressive Mode

Run multiple shopping tasks in sequence.

Use Progressive Mode

  • Enable to run tasks from the progression list instead of the main configuration

Repeat Task List When Done

  • Loop back to the first task after completing all tasks
  • Useful for continuous operation with unlimited quantity items

Task List

  • Add Task - Adds current shop configuration as a new task
  • Update Selected - Replaces selected task with current configuration
  • Remove Selected - Deletes selected task
  • Double-click a task to load its configuration for editing
  • Drag tasks to reorder

Each task includes:

  • Shop NPC and location
  • Items to buy/sell with quantities
  • Teleport settings
  • World hop preference

Tasks complete when all item quantities are fulfilled, then the next task begins.

Advanced Settings

Access via the Advanced Settings button.

Utility

  • Mute Sound, Optional Failsafe, Stuck Failsafe, Auto Bond, Discord Webhooks, Client State, Logout options

Antiban

  • AFK behavior, Mini Breaks, ABC2 settings, Artificial Delay

Controls

  • Basic Controls, Preferred Zoom level

GE Restocking Pricing

  • Configure default buy/sell prices for GE offers
  • Set custom prices per item
  • Adjust price source, percentage adjustments, and relist policies

Muling

  • Compatible with nMule by Naton
  • Mule Connection: Server address and mule ID to connect to
  • Cash-in: Request gold from the mule at script start (configure amount)
  • Threshold Muling: Send gold to mule when GP exceeds threshold (configure threshold and amount to keep)

nScript Settings

  • Signature tracking and other nScript-wide options

Stop Conditions

  • Configure automatic stop conditions (runtime, items processed, etc.)

World Hopping

  • Configure world hopping preferences and restrictions

Common Use Cases

Buying Runes for Profit

  1. Set Shop NPC to a rune shop (e.g., "Aubury" in Varrock)
  2. Add runes to buy (e.g., Fire rune ID 554, quantity 0 for unlimited)
  3. Enable World hop when out of stock
  4. Enable GE Restocking to sell bought runes at GE when low on gold

Selling Items to Shops

  1. Set Shop NPC to a general store or specialty shop
  2. Add items with Sell transaction type
  3. Configure teleports for efficient travel
  4. The script withdraws items from bank and sells them

Multi-Shop Progressive Setup

  1. Configure first shop with items
  2. Click Add Task to add it to progression
  3. Configure second shop with different items
  4. Click Add Task again
  5. Enable Use Progressive Mode
  6. Enable Repeat for continuous operation

Troubleshooting

"Out of coins - received 'not enough coins' message too many times."

Cause: Ran out of gold while trying to buy items.

Fix:

  • Add more coins to your bank
  • Enable GE Restocking to automatically sell bought items when low on gold
  • Configure Muling with cash-in to request gold from a mule

"Could not find shop NPC '[name]' after 10 attempts. Check NPC name and shop location."

Cause: The script cannot locate the shop NPC near the configured tile.

Fix:

  • Verify the Shop NPC Name is spelled exactly correct (case-sensitive)
  • Stand next to the shop NPC and click Set Current Tile
  • Ensure no quest or other requirement is blocking access to the NPC

"Too many consecutive buy failures. Check that you're at the correct shop and the item is available."

Cause: The script clicked to buy items but nothing was purchased, multiple times in a row.

Fix:

  • Verify the item exists in this shop's stock
  • Check that you have enough coins for the item's price
  • Ensure you're at the correct shop (some NPCs have multiple shops)

"Too many consecutive sell failures. Check that you're at the correct shop and the item can be sold here."

Cause: The script clicked to sell items but nothing was sold, multiple times in a row.

Fix:

  • Verify the shop accepts this item (not all shops buy all items)
  • General stores buy most items; specialty shops may be limited
  • Check that you have the items in inventory

"Max world hops (10) reached without finding stock. Items may not be available in any world."

Cause: The script hopped 10 worlds consecutively without finding any stock of the items you want to buy.

Fix:

  • The item may have very limited stock across all worlds
  • Try during off-peak hours when fewer players are buying
  • Consider adding multiple items so the script can buy whichever is in stock

"Progressive mode enabled but no tasks configured"

Cause: Progressive mode is checked but no tasks have been added to the task list.

Fix:

  • Configure a shop and items, then click Add Task
  • Or disable Use Progressive Mode to use the main configuration

Getting Help

If you run into issues not covered in Troubleshooting:

  1. Generate a bug report - In TRiBot: Dev Tab → Generate Bug Report (includes logs, settings, and screenshot)
  2. Post on Discord - Share the zip and describe what happened vs. what you expected at discord.gg/BFtypSSbjp

For issues that are hard to capture in a screenshot, a short screen recording helps.

Tips

  • Use teleports for shops far from banks - the time saved adds up significantly over long sessions

  • Item packs (like Feather pack, Vial pack) are automatically opened when your inventory fills up, maximizing items per trip

  • Progressive mode with repeat is useful for cycling through multiple shops that stock the same items (e.g., different rune shops)

  • GE Restocking creates a self-sustaining loop: buy items from shops, sell at GE for profit, use profit to buy more

  • Equip jewelry teleports to save inventory space - the script will equip them from bank before each trip

  • World hop setting can be disabled if you want to wait for stock to respawn instead of hopping (useful for ironmen who can't hop freely)

  • Threshold muling keeps your gold safe by automatically transferring excess GP to a mule account - useful for extended gold farming sessions