nte-exporter/docs/limitations.md
Golumpa 354b0e9232 Decode reward keys and use mapping files
Add decoding for Monopoly reward keys and switch reward metadata to be looked up by decoded id. Implement decode_reward_key() and infer_reward_type(); replace the previous raw-key KNOWN_REWARDS approach with REWARDS_BY_ID built from mappings/*.json. Add mappings/items.json and expand mappings/arcs.json. Update decoder to produce reward_id, use REWARDS_BY_ID, and change guess_quantity() to accept reward_id. Refactor pool_mappings to reuse the new mapping loader, and update tests and docs to validate mapping files and document the reward key encoding/behavior.
2026-06-11 11:09:02 +01:00

1 KiB

Limitations

This is a prototype and supports Lottery_Permanent, Lottery_LimitedCharacter, and Arc_MiracleBox.

Known limitations:

  • Other NTE banners are not implemented yet.
  • The game appears not to provide a unique server-side roll ID in the decoded record body.
  • UIDs are generated deterministically from decoded fields and timestamp-group order.
  • Boundary timestamp groups may be skipped to avoid exporting unstable data.
  • Page gaps are ignored outside the longest continuous run and reported as warnings.
  • Live capture currently uses Windows raw sockets and requires administrator permission.
  • The file adapter reads mitmproxy .flows captures for research and testing.
  • The more stable and reliable Npcap/libpcap capture is not implemented yet.
  • Reward keys decode to their reward id string, so unknown rewards still export a usable reward_id; display names/ranks come from the mapping JSON files and should be expanded as new rewards appear.

Privacy guardrail: raw packet data must not be included in sanitized exports.