30dc4e4831
Allow an oldest-boundary timestamp group to be exported when its dice-only record count is a positive multiple of 10. This adds a dice_complete check in the boundary annotation logic so a proved-finished pull set on a full final page is exported (unseen continuation rows can only be non-dice tails that sort after seen rows, keeping ordinals/UIDs stable). Docs and README updated to explain the rule, and tests updated/expanded to cover dice-complete, partial, and newest-boundary behaviors.
68 lines
3.1 KiB
Markdown
68 lines
3.1 KiB
Markdown
# NTE History Exporter
|
|
|
|
Prototype CLI exporter for Neverness to Everness pull history.
|
|
|
|
This version supports:
|
|
|
|
- Game: Neverness to Everness
|
|
- System: Monopoly
|
|
- Banner ID: `Lottery_Permanent`
|
|
- Banner name: Standard Board / Permanent Board
|
|
- Banner ID: `Lottery_LimitedCharacter`
|
|
- Banner name: Limited Character Board
|
|
- System: Gashapon
|
|
- Banner ID: `Arc_MiracleBox`
|
|
- Banner name: Arc Miracle Box
|
|
|
|
## What It Does
|
|
|
|
The exporter decodes Permanent Board, Limited Character Board, and Arc Miracle Box history pages from captured UDP data, applies conservative timestamp-boundary handling, and writes sanitized JSON suitable for tracker import.
|
|
|
|
It does not export tokens, account IDs, role IDs, device IDs, server IPs, raw packets, cookies, session data, or other capture metadata. The import JSON contains decoded history rows only.
|
|
|
|
## Privacy
|
|
|
|
Do not commit packet captures, generated exports, research briefs, or personal account data. The repository keeps `exports/` as an empty output folder, but ignores everything generated inside it.
|
|
|
|
## Usage
|
|
|
|
Live capture, Windows:
|
|
|
|
```powershell
|
|
.\run-exporter.ps1 --live
|
|
```
|
|
|
|
Launch it before logging in, then open any supported history board in game. The tool keeps listening until you press any key. Exports are written under `exports\` as `Permanent_<date_time>.csv/json`, `Limited_<date_time>.csv/json`, or `Arc_<date_time>.csv/json`.
|
|
|
|
If only one banner is captured, the export JSON is copied to the clipboard. If multiple banners are captured in the same run, clipboard copy is skipped so one banner does not overwrite another.
|
|
|
|
File replay:
|
|
|
|
```powershell
|
|
.\run-exporter.ps1 capture.flows
|
|
```
|
|
|
|
For reliable deduplication, start from page 1 and scroll downward. If you only want pages 1-5, scroll through page 6 as well so the exporter can confirm the final timestamp group boundary.
|
|
|
|
Limited character history is exported as one shared pity pool: `Lottery_LimitedCharacter`.
|
|
Arc Miracle Box history is exported as one shared pity pool: `Arc_MiracleBox`.
|
|
|
|
Live capture needs a local admin-capable packet socket on Windows. The prototype uses the built-in raw socket path first, without requiring mitmproxy capture files.
|
|
|
|
## Boundary Policy
|
|
|
|
NTE history records do not appear to contain a unique server-side roll ID. UIDs are generated from decoded record fields and the record's order within all rows sharing the same raw timestamp.
|
|
|
|
Because 10-pulls can span page boundaries, partial timestamp groups can produce unstable UIDs. Normal mode exports only complete/stable timestamp groups. Boundary groups are skipped with warnings when the exporter cannot prove they are complete.
|
|
|
|
For Monopoly, Points Gift and Chase Reward rows stay in the timestamp group for UID ordinal generation, but only `result_type = dice` rows count toward pull-set sizing. An oldest boundary group whose dice-roll count is a complete multiple of 10 is treated as a finished pull set and exported even when the scan stopped on a full page. Arc groups are expected to be complete 10-pull timestamp groups.
|
|
|
|
## Current Adapters
|
|
|
|
- live Windows raw-socket capture
|
|
- `mitmproxy .flows` research decoder
|
|
|
|
Planned later:
|
|
|
|
- live Npcap/libpcap capture
|
|
- UI wrapper around the CLI
|