🏷️Vending Items

Logs when players open vending shops with their item listings

The Vending Items feature logs when a player opens a vending shop, showing all the items they're selling and their prices. This is a snapshot of what's available in the shop at the moment it opens.

Action

vending_item

When It's Used

This log is triggered when:

  • A player opens a vending shop (uses the Vending skill)

  • The shop setup is complete with items and prices

This happens once when the shop opens, not on each sale.

Why Use It

  • Advertise player shops to your Discord community

  • Track market prices for popular items

  • Help players find deals without logging in

  • Monitor merchant activity on your server

  • Create a marketplace preview channel

Server Configuration

Vending item logging uses the same settings as vending transaction logging. In conf/channels.conf:

Setting
Description
Default

enabled

Enable/disable vending logging

false

channel_id

Discord channel ID for vending logs and shop listings

-

min_zeny

Minimum zeny threshold (doesn't affect shop openings)

0

group_min

Minimum GM group level to log

0

group_max

Maximum GM group level to log

99

Note: Shop opening messages are always sent when vending logging is enabled, regardless of min_zeny.

Message Format

The default message lists all items in the newly opened shop:

Data Fields

Field
Type
Description

player_name

string

Name of the merchant character

list

string

All items being sold (see format below)

pos

string

Shop location: `map

account_id

int

Merchant's account ID

char_id

int

Merchant's character ID

channel

string

Discord channel ID

List Format

Items are sent as a comma-separated list with pipe-delimited values:

Example:

The price is per unit, not total.

Example Use Cases

Public Marketplace Channel

Let players browse shop listings from Discord:

Price Tracking

Monitor how items are being priced across your server.

Shop Directory

Create a searchable channel of active vending shops with their locations.

Deal Alerts

Players can watch the channel for items they're looking for at good prices.

Custom Templates

Customize vending item messages with templates:

Simple format:

Result: 🏷️ Merchant is selling Red Potion for 2,000z

With location:

Result: πŸ“ Shop at prontera|150|180: Red Potion - 2,000z by Merchant

Marketplace style:

See Message Templates for all available placeholders.

Notes

  • Sent once when the shop opens, not on each sale

  • Maximum 12 items per shop (game limit)

  • Price shown is per unit

  • Use with Vending Logs to track actual sales

  • Position helps players find the shop in-game

Last updated