5d16dac4d5
Stop treating partially-captured oldest timestamp groups (including Arc 10-pulls) as a special "incomplete" case. All decoded rows are now exported and marked with stable UIDs; the previous INCOMPLETE_* warnings and related console hint logic were removed. annotate_groups and annotate_arc_groups were simplified to always set uid_status="stable" and export_record=True, and arc_stability_warnings was deleted. CLI, live capture runner, console, tests, docs and mappings were updated to reflect the new behavior and to remove emission/handling of those informational warnings.
72 lines
3.7 KiB
Markdown
72 lines
3.7 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 pressing Start on the game's main menu so the game's UDP connection can be captured, then open any supported history board in game. If you are already in game, log out to the main menu and enter again. The tool keeps listening until you press any key. Exports are written under `exports\` as `Permanent_<date_time>.json`, `Limited_<date_time>.json`, or `Arc_<date_time>.json`.
|
|
|
|
Pass `--debug` to also write the full research CSV next to each JSON export.
|
|
|
|
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.
|
|
|
|
History always loads page 1 first and is scrolled downward, so the exporter anchors to the continuous run of pages starting at page 1 and ignores anything after the first gap (with a warning). This keeps the newest pages even if a later page is lost, and guarantees the newest timestamp group's ordinal 0 is captured.
|
|
|
|
Within a timestamp group, ordinal 0 is the newest record and unseen rows can only append after the captured ones, so every exported UID is stable -- including a partially captured oldest 10-pull. All decoded rows are therefore exported. Re-scanning later simply adds any rows that were not yet captured, with the same UIDs for the rows already seen.
|
|
|
|
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. Arc pulls are always 10-pulls. In both systems every captured group is exported, including the oldest one even if it is a partially captured pull set, because its captured prefix is ordinal-stable.
|
|
|
|
## Current Adapters
|
|
|
|
- live Windows raw-socket capture
|
|
- `mitmproxy .flows` research decoder
|
|
|
|
Planned later:
|
|
|
|
- live Npcap/libpcap capture
|
|
- UI wrapper around the CLI
|