nte-exporter/docs/limitations.md
Golumpa bb3fe3b19a Initial NTE history exporter
Initial NTE history exporter

Add a Windows live-capture exporter for NTE pull history with support for
Permanent Monopoly, Limited Monopoly, and Arc Miracle Box histories.

Included:
- live packet capture via Windows raw sockets
- CSV and JSON export generation
- normalized reward and banner mapping files
- Monopoly v7 Points Gift / Chase Reward classification
- Arc Miracle Box decoding with shared pity metadata
- timestamp grouping and UID generation
- Windows launcher scripts with admin prompting
- docs for usage, export format, limitations, and packet notes
- tests covering decoder behaviour and mapping consistency

Generated exports, captures, briefs, and local data are ignored for privacy.
2026-06-10 23:59:01 +01:00

940 B

Limitations

This is a prototype and supports Lottery_Permanent, Lottery_LimitedCharacter, and Arc_MiracleBox.

Known limitations:

  • Other NTE banners are not implemented yet.
  • The game appears not to provide a unique server-side roll ID in the decoded record body.
  • UIDs are generated deterministically from decoded fields and timestamp-group order.
  • Boundary timestamp groups may be skipped to avoid exporting unstable data.
  • Page gaps are ignored outside the longest continuous run and reported as warnings.
  • Live capture currently uses Windows raw sockets and requires administrator permission.
  • The file adapter reads mitmproxy .flows captures for research and testing.
  • The more stable and reliable Npcap/libpcap capture is not implemented yet.
  • Reward mappings are research mappings and should be expanded as more samples are decoded.

Privacy guardrail: raw packet data must not be included in sanitized exports.