Siphon System Documentation

The Siphon System centralizes siphon transaction processing, leaderboard visibility, and player balance checks for each guild. It includes Discord commands, dashboard operations, and public leaderboard pages.

Prerequisites: Before using Siphon features, your guild must be configured and managers need access to the Siphon dashboard page.

How to Generate Siphon Log File
System Overview
Discord Command: /siphons
Dashboard: API Siphons
Public Pages
Manager Workflow
Troubleshooting

How to Generate Siphon Log File

Before uploading data to the Siphon dashboard, generate the log file directly from Albion Online.

Step-by-Step (In Game)

Press G to open the guild menu.
Click Guild Logs (bar chart icon with 3 bars).
In Guild Logs, open the side tab Guild Account Logs (coins icon).
In the middle dropdown, change Silver to Siphoned Energy.
Do not type anything in the Search... input (player-name filter).
Keep the third filter set to ANY (Deposit/Withdraw filter).
Set Timeframe to:
- 7 days for shorter periods, or
- 4 weeks for broader history.
Choose the timeframe based on the start date you need.
Export/copy and save the log as .txt.

Game Limitation: Albion only provides up to 4 weeks of logs.

Dashboard Block Date: If a block date is configured in the Siphon dashboard, old transactions before that date are ignored automatically.

System Overview

The Siphon System is split into three practical surfaces:

Discord: Real-time check with /siphons playername:<name>.
Dashboard: Upload siphon logs, maintain ignored players, add manual transactions, set block date, and reset data.
Public views: Guild leaderboard and per-player transaction timeline.

Guild separation: Every guild has its own Siphon data, ignore list, and leaderboard.

Discord Command: /siphons

Purpose

Returns the current siphon balance for a player in the current Discord server context.

Usage

/siphons playername:YourPlayerName

Behavior

Works only inside a guild (server).
On success, shows embed fields: Player, Balance, and Last Updated (when available).
Uses an image thumbnail attachment (SiphonedEnergy.png).

Common Errors

Configuration Error: Siphon service is not configured yet.
Not Found: player not found or no siphon data recorded for that player.
Guild Only: command used outside server context.

Dashboard: API Siphons

This is the manager page to maintain Siphon data for a selected guild.

Upload Siphon Log File

Accepts only .txt file.
Processes transaction log lines and skips duplicates.
Supports multiple language formats from the game logs.
Shows upload success/error messages in-page after redirect.

Players to be Ignored

Ignored players are excluded from leaderboard output.
Actions: add ignored player, remove ignored player.
Useful for test accounts, alt accounts, and players you do not want in rankings.

Advanced Settings

Add Manual Transaction: creates a transaction with date, player, reason (Deposit/Withdrawal), and amount.
Reset All Data: deletes all siphon transactions for the guild (irreversible).
Block Date: rejects transactions before configured date during processing/manual insertion.
Remove Block Date: allows transactions from any date again.

Warning: Reset operation permanently clears all siphon transaction records for the selected guild.

Leaderboard Section

Shows ranked players by total siphon balance.
Supports sortable columns and CSV export.
Player names are clickable to open the transaction timeline for that player.

Public Pages

Public Siphon Leaderboard

Public page that shows Siphon standings for the selected guild.

Displays rank, player name, and siphon balance.
Shows last log entry timestamp when available.
Allows sort by rank, player, and balance.
Supports CSV export from current table.
Player names are clickable and open player transaction timeline.

Player Transaction Timeline

Detailed page for one player, opened from the public leaderboard.

Shows chronological list (latest first) of one player's siphon transactions.
Columns: Date, Reason, Amount.
Visual amount color: positive (deposit), negative (withdrawal).
Breadcrumb navigation back to leaderboard/select-type page.

Navigation flow: Leaderboard list -> click player -> transaction timeline -> back to leaderboard.

Manager Workflow

Open the Siphon manager page for your guild.
Upload the latest log file from Albion.
Review ignored players and adjust when needed.
Use manual transactions only for corrections or exceptional cases.
Set block date to prevent older logs from being imported again.
Use reset only when you intentionally want a full clean start.

Troubleshooting

No leaderboard data: verify uploads succeeded and ignore list is not filtering all players.
Command not returning balance: confirm player has transactions in the selected guild.
Player not found: check player name spelling and try again.
Upload rejected by date: verify configured block date in Advanced Settings.
Empty page after reset: expected behavior until new logs are uploaded or manual transactions are added.

Banking System

Documentation Home