🔨Refine Logs

Logs equipment refining attempts to Discord

The Refine Log feature tracks equipment refining attempts, including successes, failures, and downgrades. Perfect for celebrating those +10s or commiserating over broken gear.

Action

refine_log

When It's Used

This log is triggered when a player:

• Successfully refines equipment (refine level increases)

• Fails a refine (equipment breaks or refine fails)

• Downgrades equipment (refine level decreases)

Why Use It

• Celebrate lucky refines with your community

• Share the pain of broken equipment

• Track refine statistics for your server

• Monitor for refine exploits or unusual patterns

• Create engaging community moments

Server Configuration

In conf/channels.conf:

// Refine attempt logging
ragnasync_refine_log_enabled: true
ragnasync_refine_log_channel_id: "YOUR_CHANNEL_ID"
ragnasync_refine_log_min_level: 7
ragnasync_refine_log_group_min: 0
ragnasync_refine_log_group_max: 0

Setting	Description	Default
enabled	Enable/disable refine logging	false
channel_id	Discord channel ID for refine logs	-
min_level	Minimum refine level 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_level: 7 to only log high-refine attempts where the real excitement (and heartbreak) happens!

Message Format

The default message shows the refine result with appropriate emoji:

✅ Refine [Success]:  | Knight           | Valkyrie Armor       +6 -> +7 | 100,000z
❌ Refine [Fail]:     | Mage             | Staff of Destruction +7 -> +0 | 200,000z
⬇️ Refine [Downgrade]: | Archer          | Composite Bow        +9 -> +8 | 150,000z

Data Fields

Field	Type	Description
player_name	string	Character name
item_name	string	Name of the item being refined
item_id	int	Item database ID
refine_from	int	Refine level before attempt
refine_to	int	Refine level after attempt
result	string	Result: success, fail, or downgrade
material_id	int	Refine material item ID
zeny_cost	int	Zeny cost of the refine
account_id	int	Player's account ID
char_id	int	Player's character ID
channel	string	Discord channel ID

Example Use Cases

Public Refine Channel

Share the excitement (and despair) of refining:

ragnasync_refine_log_channel_id: "1234567890"  // #refine-results

High Refine Celebrations

Everyone can cheer when someone hits +10!

RNG Tracking

Monitor refine success rates to ensure your server rates are working correctly.

Economy Monitoring

Track zeny sink from refining attempts.

Custom Messages

Want to customize how these messages look? Head to the Message Routes page on your dashboard, set the format to Custom Message, and compose your own template using {{placeholder}} syntax.

Example template:

:slot_machine: {{player_name}} went for +{{refine_to}} on {{item_name}}... {{result}}! ({{zeny_cost}}z)

Available placeholders for this event:

Placeholder	Example
{{player_name}}	Marky
{{item_name}}	Knife
{{item_id}}	1201
{{refine_from}}	6
{{refine_to}}	7
{{result}}	success
{{zeny_cost}}	10000

See Message Routing for more about formats, conditions, and multi-channel routing.

Result Types

Result	Description	What Happens
success	Refine succeeded	Level increases by 1
fail	Refine failed	Equipment breaks (goes to +0)
downgrade	Refine downgraded	Level decreases by 1 (safe refine)

Notes

• Each refine attempt is logged individually

• Material ID helps track which ores are being used

• Zeny cost is the amount charged by the NPC

• Great for creating community engagement around RNG moments