πŸ›’Shop Logs

Logs NPC shop buy/sell transactions to Discord

The Shop Log feature tracks when players buy from or sell to NPC shops. This helps you understand your server's economy and monitor for unusual trading patterns.

Action

shop_log

When It's Used

This log is triggered when a player:

  • Buys items from any NPC shop

  • Sells items to any NPC shop

All items in a single transaction are batched together in one message.

Why Use It

  • Monitor economy by tracking zeny flow through NPC shops

  • Detect abuse like item duplication or price exploits

  • Track popular items to understand what players need

  • Audit transactions for server administration

Server Configuration

In conf/channels.conf:

Setting
Description
Default

enabled

Enable/disable shop logging

false

channel_id

Discord channel ID for shop logs

-

buy_enabled

Log buy transactions

true

sell_enabled

Log sell transactions

true

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

Tip: Set min_zeny: 1000000 to only log transactions over 1 million zeny.

Message Format

The default message shows player, items, quantities, and total prices:

Multiple items in one transaction are grouped together.

Data Fields

Field
Type
Description

type

string

Transaction type: buy or sell

player_name

string

Character name

list

string

Batched item data (see format below)

pos

string

Player location: `map

npc_id

int

NPC ID (optional)

account_id

int

Player's account ID

char_id

int

Player's character ID

channel

string

Discord channel ID

List Format

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

Example:

Example Use Cases

Economy Monitoring Channel

Track all NPC transactions in an admin channel:

Detect Unusual Activity

Large purchases from NPCs might indicate:

  • Item price exploits

  • Automated bots

  • Economy manipulation

See which items players buy most frequently to balance your server economy.

Custom Templates

Customize shop log messages with templates:

Simple format:

Result: Buy: Knight - Red Potion x100 for 5,000z

With location:

Result: πŸ›’ Knight buy Red Potion x100 at prontera|150|180

See Message Templates for all available placeholders.

Notes

  • All items in a single shop transaction are sent together

  • The price field shows the total cost (unit price Γ— quantity)

  • Position tracking (pos) helps identify which NPC was used

  • Both buying and selling are tracked with the type field

Last updated