Skip to content

English

siralusian edited this page Aug 11, 2026 · 2 revisions

🏠 Wiki home🇩🇪 Deutsche Version

CobbleCompanion: CobbleDollars/CustomNPCs – Wiki (English)

This page walks through turning a CustomNPCs trader into a CobbleMerchant shop, step by step. For a quick reference see the README.

Important up front: every step below needs AdminOp (see CobbleCompanion wiki: Setting up admin access) and a plain wooden hoe in your main hand. That's intentional — this module is set up by the server operator, regular players just use the finished shop.

Prerequisite: you additionally need CobbleCompanion: CobbleDollars/Create installed — the stock ticker/admin menu integration itself comes from that module, this one just extends it to CustomNPCs traders. See its wiki for everything below in more detail (the admin menu, sell menus, delivery, the Creative Crate) — this page only covers what's specific to CustomNPCs.

Step 1: Turn an NPC into a CobbleMerchant shop

First create a completely normal CustomNPC with the CustomNPCs mod (appearance, name etc. as usual). Then:

Right-click the NPC with the hoe — opens its admin options menu (the same menu CobbleMerchants use). Toggle "CobbleMerchant mode" on. The NPC keeps its normal appearance, but a simple right-click (without the hoe) now opens a CobbleMerchant-style shop instead of the usual CustomNPCs dialogs. Toggle it back off in the same menu to restore completely normal CustomNPCs behavior.

While you're in there, this is also where you pick the price list, item source, sell menu, delivery method etc. for this NPC — see the admin options menu section of the Create wiki for what every row does.

Step 2: Link it to a stock ticker/chest

Without this step the NPC can't sell anything — a ticker link is mandatory.

  1. Left-click (attack) the NPC with the hoe — starts link mode (confirmation in chat).
  2. Left-click a Create stock ticker — links the price source (required), or left-click a chest — links an additional payout target inventory for sale proceeds (optional).
  3. To cancel: left-click the same NPC again with the hoe.

After that

Once linked, the NPC's stock stays live-synced with the linked CobbleDollars system, and regular players can simply buy/sell at the NPC via right-click (no hoe, no AdminOp) — no further admin steps needed.

Clone this wiki locally