Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings
Greg edited this page Mar 6, 2026 · 12 revisions

Adding default shops

Find the shop in various *.shops.toml files, or add it if you know the inventory id

[bobs_brilliant_axes]
id = 1
defaults = [
    { id = "bronze_pickaxe", amount = 10 },
    { id = "bronze_hatchet", amount = 10 },
    { id = "iron_hatchet", amount = 10 },
    { id = "steel_hatchet", amount = 10 },
    { id = "iron_battleaxe", amount = 10 },
    { id = "steel_battleaxe", amount = 10 },
    { id = "mithril_battleaxe", amount = 10 },
]

Add the shopkeeper to a *.npcs.toml file

[bob]
id = 519
categories = ["human"]
shop = "bobs_brilliant_axes"
examine = "An expert on axes."

shop = needs to be set to the inventory string id for shops to open automatically when clicking the "Trade" option

Spawn the shopkeeper in the right place in a *.npc-spawns.toml file

spawns = [
  { id = "bob", x = 3228, y = 3203, level = 0, direction = "SOUTH" },
]

Opening a shop

Npcs with the Trade option will open shops listed in their npcs.toml automatically however when opened via dialogue options the OpenShop event should be used:

player.openShop("zekes_superior_scimitars")

General stores

To add a general store which all players can see and most tradable items can be sold to, simply make sure the inventory name ends with general_store, for example:

[lumbridge_general_store]
id = 24
defaults = [
    { id = "empty_pot", amount = 30 },
    { id = "jug", amount = 10 },
    { id = "shears", amount = 10 },
    # etc...
]

Clone this wiki locally

Morty Proxy This is a proxified and sanitized view of the page, visit original site.