How marcosvll2/neoxtractor works
NeoXtractor is a GUI-first tool for opening NPK archives, optionally applying game-specific configuration, browsing and filtering entries, then extracting or previewing them. The archive readers parse indexes and decode entry data; format processors and specialized viewers support richer previews, including mesh and texture assets. The README documents config selection, archive loading, filtering, extraction, renaming, and viewer selection. Several viewer and reader internals were not sampled, so their links are omitted unless supported by the README or SOURCE INDEX.
Main entry points: main_window.py Main window · npk_file.py NPK reader · viewers Specialized viewers · wpk_file.py WPK reader
Components 22
Application UI
- App entrypoint
main.py - Main window
gui/windows/main_window.py - Archive file list
gui/widgets/npk_file_list.py - Entry filter
gui/npk_entry_filter.py - Preview panel
gui/widgets/preview_widget.py - Viewer selection
gui/utils/viewer.py - Specialized viewers
gui/widgets/viewers
Archive Reading
- NPK reader
core/npk/npk_file.py - WPK reader
core/wpk/wpk_file.py - Entry data model
core/npk/class_types.py - Binary primitives
core/binary_readers.py - Entry export
core/npk/class_types.py
Asset Processing
- Format processors
core/formats/registry.py - Image handling
core/images.py - Mesh loading
core/mesh_loader/parsers/new_parser.py - Mesh rendering
gui/renderers/mesh_renderer.py - Cocos viewer
gui/widgets/viewers/cocos_viewer/cocos_viewer.py
Configuration
- Config manager UI
gui/windows/config_manager/config_manager_window.py - Game configs
gui/config_manager.py - Config model
core/config.py - GUI settings
gui/settings_manager.py
Other components
- User
Connections 26
- User → App entrypoint: starts
- App entrypoint → Main window: starts GUI
main.py - User → Main window: opens archive
- Main window → NPK reader: loads NPK
gui/windows/main_window.py - Main window → WPK reader: loads WPK
gui/windows/main_window.py - NPK reader → Binary primitives: reads fields
core/npk/npk_file.py - NPK reader → Entry data model: creates entries
core/npk/npk_file.py - WPK reader → Entry data model: creates entries
core/wpk/wpk_file.py - NPK reader → Format processors: processes entries
core/npk/npk_file.py - WPK reader → Format processors: processes entries
core/wpk/wpk_file.py - Main window → Archive file list: shows entries
gui/windows/main_window.py - Main window → Entry filter: filters entries
gui/windows/main_window.py - Main window → Preview panel: previews selection
gui/windows/main_window.py - Preview panel → Viewer selection: selects viewer
gui/widgets/preview_widget.py - Viewer selection → Specialized viewers: registers viewers
gui/utils/viewer.py - User → Entry export: requests extraction
- Main window → Entry export: extracts entries
gui/windows/main_window.py - Format processors → Image handling: decodes images
- Specialized viewers → Mesh loading: loads mesh data
- Mesh rendering → Mesh loading: renders loaded mesh
gui/renderers/mesh_renderer.py - Specialized viewers → Cocos viewer: includes viewer
gui/utils/viewer.py - User → Config manager UI: manages configs
- Config manager UI → Game configs: updates configs
gui/windows/config_manager/config_manager_window.py - Game configs → Config model: loads config files
gui/config_manager.py - Main window → Game configs: selects active config
gui/windows/main_window.py - Main window → GUI settings: uses settings
gui/windows/main_window.py