5.4 KiB
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
{
"format": "nte-history-export",
"format_version": 1,
"game": "Neverness to Everness",
"source": "packet_capture",
"capture_source": "npcap",
"exporter": {
"name": "nte-history-exporter",
"version": "0.2.1"
},
"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",
"server_id": "23003",
"account_region": "EU",
"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.server_id: Optional numeric account-server ID, detected from the initial TCP connection or selected by the user.account_region: Region code mapped from a known productionserver_id. Current values areAS,NA_SA,EU, andSE. It is omitted for an unrecognized server ID rather than guessed.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 withuidif 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 matchpool_group_idon 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 ascharacter,item, orarc.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.Gashapon_MysteryBox: Mystery Box. Records are single pulls and history is not split into event rotations by the exporter.
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:
nte|monopoly|pool_group_id|timestamp_raw|timestamp_group_ordinal
Arc source:
nte|gashapon|pool_group_id|timestamp_raw|timestamp_group_ordinal
Mystery Box uses the same Gashapon UID source. Reward quantity is preserved,
but each record represents exactly one pull and has result_type = single_pull.
Example records
Monopoly:
{
"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:
{
"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"
}
Mystery Box:
{
"uid": "2610c6e96afd64aa4a53fb9e8cebe031",
"pool_group_id": "Gashapon_MysteryBox",
"timestamp": "2026-07-08 19:09:33",
"timestamp_group_ordinal": 0,
"result_type": "single_pull",
"reward_type": "item",
"reward_id": "vehicle039",
"reward_name": "Draco",
"reward_rank": "S",
"quantity": 1,
"source_type": "mystery_box"
}
CSV diagnostics
CSV exports are mainly for debugging the decoder. Tools should prefer JSON unless they specifically need raw packet details.