# NeoXResearch: investigating NeoX archives and Python bytecode

> NeoXResearch investigates NetEase's NeoX game engine through static analysis and dynamic debugging of its native library. It documents NPK archive headers and metadata entries, the file-loading and decryption path, and changes to Python bytecode opcodes. Python scripts support NPK unpacking, decryption and bytecode repair.

- Type: Case study
- Targets: Binary · Game
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-08
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/ZhangFengze/NeoXResearch>
- Primary source: <https://github.com/ZhangFengze/NeoXResearch/blob/6a61b94fa7d4c5130e6e7121b14646e6d401adf0/README.md>
- Catalog page: <https://awesomerea.org/resources/neoxresearch-neox-format-case/>
- Record JSON: <https://awesomerea.org/resources/neoxresearch-neox-format-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/neoxresearch-neox-format-case/index.md)

## Requirements & limits

- **Prerequisites:** The documented analysis uses IDA Pro and dynamic debugging of a NeoX core shared object.
- **Prerequisites:** The bytecode workflow compares NeoX's Python 2.7 implementation with CPython and uses uncompyle6.
- **License:** No licence file in the repository.

## Primary sources

1. <https://github.com/ZhangFengze/NeoXResearch/blob/6a61b94fa7d4c5130e6e7121b14646e6d401adf0/README.md>

## More in Games

- [NetspherePirates: an S4 League Patch 34 server emulator](https://awesomerea.org/resources/netspherepirates-s4-league-case/index.md) · Case study
- [Neverness to Everness: mapping a TCP connection's records](https://awesomerea.org/resources/nte-network-traffic-analysis-case/index.md) · Case study
- [NexusForever: WildStar build 16042 server reconstruction](https://awesomerea.org/resources/nexusforever-wildstar-case/index.md) · Case study
- [NFS Online Server: reconstructing Need for Speed online services](https://awesomerea.org/resources/nfs-online-server-case/index.md) · Case study
- [ngp-link: reconstructing the Neo Geo Pocket Color link cable](https://awesomerea.org/resources/ngp-link-case/index.md) · Case study
- [NGPC–Dreamcast link cable: reconstructing retail game uploads](https://awesomerea.org/resources/ngpc-dreamcast-link-cable-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.