nte-exporter/docs/export-format.md
2026-06-23 15:49:09 +01:00

4.5 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.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). We generate our own roll UID as the game does not send their own, so to make things trackable and to help prevent duplicates we create our own UID with a selection of feilds making each entry in the history 100% unique. The way it is done means on a rescan the same UID is generated for the same history item even if it is further in the history and you have pulled more since the last scan.

Monopoly source:

nte|monopoly|pool_group_id|timestamp_raw|timestamp_group_ordinal|roll_result|reward_key_hex|quantity

Arc source:

nte|gashapon|pool_group_id|timestamp_raw|timestamp_group_ordinal|reward_key_hex

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"
}

CSV diagnostics

CSV exports are mainly for debugging the decoder. Tools should prefer JSON unless they specifically need raw packet details.