How to Download Lucky Bun Hand Histories

Hand histories are the raw record behind session review, opponent reports, and population analysis. LuckyBun Edge collects monitored Lucky Bun hands, converts them, and makes eligible files available through the customer panel.

What access is based on

Your access depends on four fields: highest purchased stake, plan, subscription dates, and ante filter. A higher stake includes the eligible lower stakes. For example, NL500 access covers NL100, NL200, and NL500, each split into ante and no-ante.

Historical access by plan

• Monthly: a one-time bonus equal to the newest 10% of the eligible historical pool at first purchase, plus eligible new hands played during the active subscription.
• Quarterly: a one-time bonus equal to the newest 30% of the eligible historical pool at first purchase, plus eligible new hands played during the active subscription.
• Annual: the eligible full historical pool, plus eligible new hands played during the active subscription.

The historical bonus is not granted again on renewal. If the subscription expires, files already downloaded remain with the customer, but access to new updates stops.

Use played time, not upload time

Subscription eligibility is evaluated using when the hand was played. A hand uploaded later can still belong to the correct active period. This avoids penalizing a customer when collection, conversion, or upload is delayed.

Download a filtered set or all eligible hands

The panel supports filters for stake, ante state, and time range. Download ALL means all hands matching the current filters and your entitlement, not every hand stored by the system.

1. Log in to the panel.
2. Open Hand Histories.
3. Choose stake, ante state, and date filters, or leave them open for your full eligible set.
4. Review the displayed count.
5. Use the filtered download or Download ALL.
6. Keep the ZIP unchanged as a backup before extracting it.

Verify before a full tracker import

Extract a small sample and open a few text files. Confirm that hand IDs, timestamps, stakes, player names, actions, board cards, and results are present. Then import that test batch into PT4 or Hand2Note.

Collection is monitored and measured, but it should not be described as infallible. Coverage can be very high while an unobserved table remains invisible to a collector. That is why the production system uses lobby monitoring, reconciliation, alerts, and a separate observer rather than relying only on the files it already found.