152 lines
4.4 KiB
Markdown
152 lines
4.4 KiB
Markdown
# Export Format
|
|
|
|
The JSON export is the format to use when building tools around captured NTE
|
|
history. It is cleaned for import/use and does not include raw packet bytes or
|
|
decoder-only offsets.
|
|
|
|
## JSON shape
|
|
|
|
```json
|
|
{
|
|
"format": "nte-history-export",
|
|
"format_version": 1,
|
|
"game": "Neverness to Everness",
|
|
"source": "packet_capture",
|
|
"capture_source": "npcap",
|
|
"exporter": {
|
|
"name": "nte-history-exporter",
|
|
"version": "0.1.8"
|
|
},
|
|
"banner": {
|
|
"id": "Lottery_Permanent",
|
|
"name": "Standard Board",
|
|
"system": "Monopoly",
|
|
"shared_pity": false
|
|
},
|
|
"scan": {
|
|
"mode": "stable_only",
|
|
"boundary_policy": "export_ordinal_stable_groups",
|
|
"decoded_records": 0,
|
|
"exported_records": 0,
|
|
"skipped_records": 0,
|
|
"warnings": []
|
|
},
|
|
"user_uid": "optional-user-uid",
|
|
"records": []
|
|
}
|
|
```
|
|
|
|
Top-level fields:
|
|
|
|
- `format` / `format_version`: Identify this export format.
|
|
- `game`: Game name.
|
|
- `source` / `capture_source`: Where the export came from.
|
|
- `exporter`: Exporter name and version.
|
|
- `banner`: The history pool this file belongs to.
|
|
- `scan`: Export counts and capture warnings.
|
|
- `user_uid`: Optional game account UID, if known.
|
|
- `records`: Pull/reward records.
|
|
|
|
## Fields to identify pulls
|
|
|
|
For most tools, prefer these fields:
|
|
|
|
- `uid`: Stable unique ID for this exported pull/reward row.
|
|
- `user_uid`: Account UID, when present. Use this with `uid` if storing data for
|
|
multiple accounts.
|
|
- `pool_group_id`: Stable pool ID for the record.
|
|
- `banner.id`: Stable pool ID for the whole file. This should match
|
|
`pool_group_id` on records.
|
|
- `timestamp`: Display timestamp from the game history.
|
|
- `timestamp_group_ordinal`: Stable ordering inside records that share the same
|
|
timestamp.
|
|
- `reward_id`: Stable decoded reward ID.
|
|
- `reward_type`: Reward category, such as `character`, `item`, or `arc`.
|
|
- `quantity`: Reward quantity, for Monopoly records.
|
|
- `roll_result` / `result_type`: Monopoly result details.
|
|
|
|
Current stable pool IDs:
|
|
|
|
- `Lottery_Permanent`: Standard Board.
|
|
- `Lottery_LimitedCharacter`: Limited Character Board. New limited character
|
|
banners should still use this ID while they share the same history/pity pool.
|
|
- `Arc_MiracleBox`: Arc Miracle Box.
|
|
|
|
Avoid using `banner.name`, `reward_name`, `reward_type` or `reward_rank` as primary IDs. They
|
|
are useful display fields, but may change when mapping files are updated.
|
|
|
|
## Stability notes
|
|
|
|
Every JSON record is exported with a stable `uid`. Re-scanning deeper history can
|
|
add older rows, but already exported rows keep the same `uid`.
|
|
|
|
Limited character banners are grouped by their shared history pool, not by the
|
|
currently featured character. If the game adds a new visible limited character
|
|
banner that uses the same pool, tools should continue treating it as
|
|
`Lottery_LimitedCharacter`.
|
|
|
|
If the game adds a genuinely new history pool, the exporter mappings need to be
|
|
updated before tools can identify it cleanly. Reward display data also comes from
|
|
the mapping files, so new rewards may export with stable IDs before they have
|
|
nice names or ranks.
|
|
|
|
## UID generation
|
|
|
|
The `uid` is the first 32 hex characters of `sha256(source)`. The game does not
|
|
appear to send a stable pull/reward row ID, so the exporter builds one from the
|
|
history pool, raw packet timestamp, and ordinal inside that timestamp group.
|
|
Decoded content such as dice result, reward ID, and quantity is intentionally
|
|
excluded so decoder fixes do not change the identity of an already-captured row.
|
|
|
|
Monopoly source:
|
|
|
|
```text
|
|
nte|monopoly|pool_group_id|timestamp_raw|timestamp_group_ordinal
|
|
```
|
|
|
|
Arc source:
|
|
|
|
```text
|
|
nte|gashapon|pool_group_id|timestamp_raw|timestamp_group_ordinal
|
|
```
|
|
|
|
## Example records
|
|
|
|
Monopoly:
|
|
|
|
```json
|
|
{
|
|
"uid": "7aae34232160e950ecc7b5da38812caa",
|
|
"pool_group_id": "Lottery_LimitedCharacter",
|
|
"timestamp": "2026-06-10 13:32:17",
|
|
"timestamp_group_ordinal": 0,
|
|
"roll_result": 5,
|
|
"result_type": "dice",
|
|
"reward_type": "character",
|
|
"reward_id": "1033",
|
|
"reward_name": "Adler",
|
|
"reward_rank": "A",
|
|
"quantity": 1
|
|
}
|
|
```
|
|
|
|
Arc:
|
|
|
|
```json
|
|
{
|
|
"uid": "75c42ad1171d1d0f72b2c8d8307f7230",
|
|
"pool_group_id": "Arc_MiracleBox",
|
|
"timestamp": "2026-06-10 23:46:29",
|
|
"timestamp_group_ordinal": 0,
|
|
"reward_type": "arc",
|
|
"reward_id": "fork_nonos",
|
|
"reward_name": "First Step to Success",
|
|
"reward_rank": "B",
|
|
"source_type": "miracle_box"
|
|
}
|
|
```
|
|
|
|
## CSV diagnostics
|
|
|
|
CSV exports are mainly for debugging the decoder. Tools should prefer JSON
|
|
unless they specifically need raw packet details.
|