🏷️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:

// Player vending logging (includes shop openings)
ragnasync_vending_log_enabled: true
ragnasync_vending_log_channel_id: "YOUR_CHANNEL_ID"
ragnasync_vending_log_min_zeny: 0
ragnasync_vending_log_group_min: 0
ragnasync_vending_log_group_max: 99

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:

🏪 Vending Item:  | MerchantName     | Red Potion           | 2,000z
🏪 Vending Item:  | MerchantName     | Blue Potion          | 5,000z
🏪 Vending Item:  | MerchantName     | Lord Kaho's Horn     | 5,000,000z

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:

item_id|item_name|price,item_id|item_name|price,...

Example:

512|Apple|2000,5013|Lord Kaho Horn|5000000,2301|Cotton Shirt|50000

The price is per unit, not total.

Example Use Cases

Public Marketplace Channel

Let players browse shop listings from Discord:

ragnasync_vending_item_channel_id: "1234567890"  // #marketplace

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:

[template: 🏷️ {{player_name}} is selling {{item_name}} for {{price}}z]

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

With location:

[template: 📍 Shop at {{pos}}: {{item_name}} - {{price}}z by {{player_name}}]

Result: 📍 Shop at prontera|150|180: Red Potion - 2,000z by Merchant

Marketplace style:

[template: **{{item_name}}** | {{price}}z | 📍 {{pos}} | Seller: {{player_name}}]

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