🏪Vending Logs

Logs player-to-player vending transactions to Discord

The Vending Log feature tracks player-to-player shop transactions. When someone buys items from a merchant's vending shop, the details are logged to Discord.

Action

vending_log

When It's Used

This log is triggered when:

• A player purchases items from another player's vending shop

• The transaction completes successfully

All items purchased in a single transaction are batched together.

Why Use It

• Track your server's player economy in real-time

• Monitor high-value trades for potential scams

• Celebrate big sales in your community

• Audit suspicious transactions between accounts

• Understand market prices for popular items

Server Configuration

In conf/channels.conf:

// Player vending transaction logging
ragnasync_vending_log_enabled: true
ragnasync_vending_log_channel_id: "YOUR_CHANNEL_ID"
ragnasync_vending_log_min_zeny: 100000
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	-
min_zeny	Minimum zeny threshold to log (0 = log all)	0
group_min	Minimum GM group level to log	0
group_max	Maximum GM group level to log	99

Note: This setting also controls vending_item messages when players open shops.

Message Format

The default message shows buyer, seller, items, and prices including tax:

🏪 Vending:       | Buyer        -> Merchant     | Red Potion           x10    | 20,000z (tax 2,000z)
🏪 Vending:       | Buyer        -> Merchant     | Blue Potion          x5     | 50,000z (tax 5,000z)

Data Fields

Field	Type	Description
buyer_name	string	Character name of the buyer
seller_name	string	Character name of the seller
list	string	Batched item data (see format below)
pos	string	Shop location: `map
buyer_account_id	int	Buyer's account ID
buyer_char_id	int	Buyer's character ID
seller_account_id	int	Seller's account ID
seller_char_id	int	Seller'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|amount|price|tax,item_id|item_name|amount|price|tax,...

Example:

512|Apple|10|20000|2000,513|Banana|5|50000|5000

Example Use Cases

Public Trading Channel

Let everyone see what's being traded on your server:

ragnasync_vending_log_channel_id: "1234567890"  // #marketplace

Monitor High-Value Trades

Watch for expensive items changing hands to prevent scams.

Track Economy Health

See what items players are actually buying and at what prices.

Celebrate Big Sales

When someone sells an MVP card, the whole community can see it!

Custom Templates

Customize vending log messages with templates:

Simple format:

[template: 💰 {{buyer_name}} bought {{item_name}} x{{amount}} from {{seller_name}} for {{price}}z]

Result: 💰 Buyer bought Apple x10 from Merchant for 20,000z

With tax details:

[template: {{buyer_name}} → {{seller_name}}: {{item_name}} x{{amount}} | {{price}}z ({{tax}}z tax)]

With location:

[template: 🏪 Trade at {{pos}}: {{item_name}} x{{amount}} sold for {{price}}z]

See Message Templates for all available placeholders.

Notes

• Both buyer and seller information is tracked

• Tax amount is calculated based on your server's vending tax rate

• Position shows where the merchant's shop was located

• All items from a single purchase are grouped together

• Use alongside Vending Items to see complete shop activity