The /mercantile command tree. Op-restricted subcommands require permission level 2 (default op). Self-query commands work for any player.
/mercantile reputationNo permission required. Displays the executing player's reputation score and tier name (e.g. "Liked", "Trusted", "Honored"). Returns the score as the command result.
Example: /mercantile reputation → "You: 42 (Neutral)"
/mercantile reputation <player>Op-restricted. Reports another player's score and tier.
Example: /mercantile reputation Steve → "Steve: 105 (Liked)"
/mercantile reputation set <player> <value>Op-restricted. Sets a player's reputation to an absolute value. Range: −200 to 1500; Brigadier rejects out-of-range values at parse time.
Example: /mercantile reputation set Steve 100 → broadcasts "Set Steve's reputation to 100 (Liked)"
/mercantile reputation add <player> <value>Op-restricted. Adds (or subtracts, with a negative value) to the current score, then clamps to [−200, 1500]. The <value> argument is bounded to [−1700, 1700] — wide enough to traverse the full range in one call, narrow enough to reject parser overflow.
Example: /mercantile reputation add Steve -50 → "Added -50 to Steve's reputation: 50 (Neutral)"
/mercantile pinsNo permission required. Lists the executing player's pinned trades — each entry shows a 1-based index, the villager's name, the trade summary, and a live stock status (In stock / Out of stock / Unknown). The header reports how many pins are used against your cap (maxPinnedTradesPerPlayer). Returns the pin count as the command result.
Listing lazily prunes dead pins: any pin whose villager is loaded nearby but no longer sells the offer is dropped before the list is shown.
Requires enableTradePinning. When the feature is disabled this subcommand reports that pinning is off.
/mercantile pins remove <index>No permission required. Removes the pin at the given 1-based <index> as shown by /mercantile pins.
Works even when enableTradePinning is off — an escape hatch so pins, which occupy cap slots, can always be shed while the feature is disabled.
/mercantile pins clearNo permission required. Removes every pinned trade for the executing player.
Also works when enableTradePinning is off, for the same escape-hatch reason as remove.
/mercantile reloadOp-restricted. Re-reads .minecraft/config/mercantile.json on the server and broadcasts the new config to every connected client via the ConfigSyncS2CPayload. No restart required.
Out-of-range numeric values are clamped on load — hand-edited typos are silently corrected to safe values.
Example: /mercantile reload → broadcasts "Mercantile config reloaded."