rewog 3.0.0__py3-none-any.whl

rewog-3.0.0.dist-info/METADATA

@@ -0,0 +1,518 @@
+Metadata-Version: 2.5
+Name: rewog
+Version: 3.0.0
+Summary: A modern tool to download, decrypt and unpack 3D gun models from World of Guns: Gun Disassembly
+Project-URL: Homepage, https://github.com/InzGIBA/ReWOG
+Project-URL: Repository, https://github.com/InzGIBA/ReWOG
+Project-URL: Documentation, https://github.com/InzGIBA/ReWOG/blob/main/README.md
+Project-URL: Changelog, https://github.com/InzGIBA/ReWOG/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/InzGIBA/ReWOG/issues
+Project-URL: Bug Tracker, https://github.com/InzGIBA/ReWOG/issues
+Author-email: hampta <hampta@example.com>, inzgiba <inzgiba@gmail.com>
+Maintainer-email: inzgiba <inzgiba@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: 3d-models,decryption,game-assets,unity,world-of-guns
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: click>=8.1.0
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: pydantic>=2.4.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: unitypy>=1.10.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: flake8>=6.0.0; extra == 'dev'
+Requires-Dist: httpx>=0.27; extra == 'dev'
+Requires-Dist: isort>=5.12.0; extra == 'dev'
+Requires-Dist: mkdocs-material>=9.5; extra == 'dev'
+Requires-Dist: mkdocstrings[python]>=0.25; extra == 'dev'
+Requires-Dist: mypy>=1.5.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.4.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.11.0; extra == 'dev'
+Requires-Dist: pytest>=7.4.0; extra == 'dev'
+Requires-Dist: types-requests>=2.31.0; extra == 'dev'
+Provides-Extra: mitm
+Requires-Dist: mitmproxy>=10.0; extra == 'mitm'
+Provides-Extra: print
+Requires-Dist: networkx>=3.0; extra == 'print'
+Requires-Dist: numpy>=1.26; extra == 'print'
+Requires-Dist: trimesh>=4.0; extra == 'print'
+Provides-Extra: test
+Requires-Dist: pytest-cov>=4.1.0; extra == 'test'
+Requires-Dist: pytest-mock>=3.11.0; extra == 'test'
+Requires-Dist: pytest>=7.4.0; extra == 'test'
+Provides-Extra: usd
+Requires-Dist: usd-core>=24.0; extra == 'usd'
+Provides-Extra: web
+Requires-Dist: fastapi>=0.110; extra == 'web'
+Requires-Dist: uvicorn>=0.29; extra == 'web'
+Description-Content-Type: text/markdown
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="assets/hero-dark.svg">
+  <source media="(prefers-color-scheme: light)" srcset="assets/hero-light.svg">
+  <img alt="ReWOG: World of Guns asset extraction toolkit" src="assets/hero-light.svg" width="100%">
+</picture>
+
+**WOG Dump: extract and rebuild 3D weapon models from [World of Guns: Gun Disassembly](https://store.steampowered.com/app/262410/World_of_Guns_Gun_Disassembly/).**
+
+A command-line toolkit for 3D artists, modders and researchers who study game assets. WOG Dump logs in with your own game account, downloads encrypted Unity bundles from the game servers, decrypts them and rebuilds the weapon: one command turns the in-game AK-47 into a Blender-ready glTF scene with the exact part hierarchy, game materials and studio lighting. Scenes come out in disassembly states too, with an offline HTML viewer, STL/USD/FBX export, print preparation and turntable videos.
+
+[Overview](#overview) · [Features](#features) · [Quick start](#quick-start) · [Usage](#usage) · [Configuration](#configuration) · [Development](#development) · [FAQ](#faq) · [Contributing](#contributing) · [License](#license)
+
+<div align="center">
+
+[![Python Version](https://img.shields.io/badge/python-3.12+-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Code Style](https://img.shields.io/badge/code%20style-black-black.svg)](https://github.com/psf/black)
+[![Package Manager](https://img.shields.io/badge/package%20manager-uv-blue.svg)](https://github.com/astral-sh/uv)
+[![GitHub Issues](https://img.shields.io/github/issues/InzGIBA/ReWOG)](https://github.com/InzGIBA/ReWOG/issues)
+[![GitHub Stars](https://img.shields.io/github/stars/InzGIBA/ReWOG)](https://github.com/InzGIBA/ReWOG/stargazers)
+
+</div>
+
+## Overview
+
+WOG Dump automates the full path from the game's servers to usable 3D data: weapon catalog, per-asset decryption keys, encrypted downloads, XOR decryption, Unity unpacking and scene export. It targets the current `query2026` protocol (game `2.2.3t6`, Unity 6) and was verified live against the production API in November 2026.
+
+- **For:** 3D artists, modders, educators and researchers studying weapon assembly and Unity asset pipelines
+- **Input:** your game-account credentials (or a captured client session) and the weapons you want
+- **Output:** decrypted Unity bundles, extracted models and textures (OBJ, PNG, TGA), glTF scenes in assembled or disassembled poses, an offline HTML viewer, STL/USD/USDZ/FBX export, print-ready parts and turntable videos
+- **Scope:** personal, educational and research use, extracted assets remain the property of Noble Empire Corp. (see [License](#license))
+
+> **What's new:** this release adds disassembly states and animated step-by-step builds, a self-contained HTML viewer with part annotations, STL/USD/USDZ/FBX export, print preparation, turntable and clip videos, the `catalog` command, a local web UI, CLI localization (Russian), a protocol compatibility probe, Docker images, a Blender addon and third-party extractor plugins. Full history: [CHANGELOG.md](CHANGELOG.md).
+
+## Features
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="assets/feature-01-dark.svg">
+  <img alt="Full pipeline, one command from catalog to decrypted assets" src="assets/feature-01-light.svg" width="32%">
+</picture>
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="assets/feature-02-dark.svg">
+  <img alt="Blender-ready scenes, game hierarchy, materials and lighting" src="assets/feature-02-light.svg" width="32%">
+</picture>
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="assets/feature-03-dark.svg">
+  <img alt="Private by design, your own account login, keys stay in SQLite" src="assets/feature-03-light.svg" width="32%">
+</picture>
+
+- **Full pipeline**: one command goes from weapon catalog to keys, download, decryption and unpacking. Downloads run in parallel, respect rate limits and resume after interruptions.
+- **Blender-ready scenes**: `build-scene` rebuilds the assembled weapon exactly like in game: part hierarchy and positions, game materials with textures, camera and studio lighting, real-world scale. UI arrows, cutaway meshes and VFX are classified and skipped unless you ask for them with `--extras`.
+- **Disassembly states**: `--state field-strip` puts parts where the game itself puts them after removal, `--state exploded` pushes them apart along removal directions, `--state parts` lays everything out in a grid. `--assembly-steps` writes a step-by-step build, and `--animated` adds one glTF animation placing part after part.
+- **Offline HTML viewer**: `--viewer` embeds the scene and the three.js runtime into one `viewer.html`: open it in any browser, click parts to highlight them, read annotations with part sizes. No Blender, no internet, no install.
+- **Animations**: `--animations` embeds the bundle's operate animation (fire, reload, safety) as real glTF animation tracks.
+- **Export formats**: `--format stl,usd,usdz,fbx` converts a built scene: binary STL for slicers (units baked in), USD/USDZ for AR with preview materials, FBX through headless Blender.
+- **Print preparation**: `print-export` repairs and checks every part with trimesh, reports watertight status per part and writes millimeter-true STLs.
+- **Previews and video**: `render` turns a built scene into transparent turntable PNGs plus a GIF, `--video` encodes an orbit MP4 or one animation clip, all through headless Blender.
+- **Catalog**: `catalog` lists every weapon with its pipeline status and sizes, filters by name and stage, and emits a stable JSON schema other tools build on.
+- **Web UI**: `serve` opens a local page with the same catalog, a 3D viewer per weapon and stage buttons with live logs.
+- **Protocol probe**: `info --protocol-probe` answers "did I break something or did the game update" in one run: endpoint reachability, anonymous query, authenticated key query, weapon list, client version. Any failure exits with code 2.
+- **Plugins**: third-party packages register extra Unity-type extractors through entry points, no fork needed (see [docs/plugins.md](docs/plugins.md)).
+- **Localization**: `--locale ru` switches CLI messages to Russian, unknown locales fall back to English silently.
+- **Private by design**: log in with your own game account (`login` / `register`) or a captured session. Credentials, sessions, keys and the weapon list live in a per-user SQLite database with owner-only permissions, no secrets ship with the repository.
+
+## Quick start
+
+### Requirements
+
+- Python 3.12+
+- [uv](https://github.com/astral-sh/uv) (recommended) or pip
+- A game account: create one with `wog-dump register` or use your existing email/password
+- Internet connection and ~10–20 GB of free disk space for a full extraction
+- Optional: [AssetStudio](https://github.com/Perfare/AssetStudio) for browsing raw Unity bundles manually
+- Optional: Blender, for preview renders, videos and FBX export
+
+### Install
+
+From [PyPI](https://pypi.org/project/rewog/):
+
+```bash
+pip install rewog
+
+# USD/USDZ export support:
+pip install "rewog[usd]"
+# local web UI:
+pip install "rewog[web]"
+# print preparation:
+pip install "rewog[print]"
+```
+
+From source (for development):
+
+```bash
+git clone https://github.com/InzGIBA/ReWOG
+cd ReWOG
+
+# with uv (install it via https://astral.sh/uv or `pip install uv`)
+uv pip install -e .
+
+# or with plain pip
+pip install -e .
+```
+
+### Run your first extraction
+
+```bash
+# 1. Create a game account and log in (once; or `wog-dump login` for an existing one)
+wog-dump register
+
+# 2. Everything: weapon list, keys, download, decrypt, unpack, normal maps
+wog-dump full-pipeline --update-keys --convert-normals
+
+# 3. Rebuild one weapon as a Blender-ready scene
+wog-dump build-scene ak47
+```
+
+Data lands under `runtime/`:
+
+```text
+runtime/
+├── encrypted/       # raw encrypted Unity3D bundles
+├── decrypted/       # decrypted bundles
+├── unpacked/        # extracted models (OBJ) and textures (PNG, TGA)
+└── scenes/ak47/     # ak47.glb + blender_setup.py + scene.json + textures/
+```
+
+Open `runtime/scenes/ak47/ak47.glb` in Blender (`File > Import > glTF 2.0`), or run the generated setup script for a configured scene with collections, hidden extras and a saved `.blend`:
+
+```bash
+blender --background --python runtime/scenes/ak47/blender_setup.py
+```
+
+### Then try this
+
+```bash
+# Disassembly poses, straight from the game's own removal data
+wog-dump build-scene ak47 --state field-strip
+wog-dump build-scene ak47 --state exploded --explode-distance 0.5
+
+# A step-by-step build plus one animated assembly GLB
+wog-dump build-scene ak47 --assembly-steps 5 --animated
+
+# Show it to someone without Blender
+wog-dump build-scene ak47 --viewer --annotate
+
+# Print a part
+wog-dump print-export ak47 --part bolt
+
+# Turntable previews and an orbit video
+wog-dump render ak47
+wog-dump render ak47 --video --duration 8
+
+# What do I have, and how do I share this page?
+wog-dump catalog
+wog-dump serve
+```
+
+## Usage
+
+### Step by step
+
+Each pipeline stage is also available as its own command:
+
+```bash
+wog-dump info                          # configuration and status; add --protocol-probe
+wog-dump download-weapons              # fetch the weapon catalog
+wog-dump download-assets --update-keys # download bundles + fresh keys
+wog-dump decrypt-assets                # XOR-decrypt the bundles
+wog-dump unpack-assets                 # extract models and textures
+wog-dump build-scene ak47              # Blender-ready glTF scene
+wog-dump render ak47                   # turntable previews; --video for MP4
+wog-dump print-export ak47             # print-ready STLs with diagnostics
+wog-dump catalog                       # per-weapon status table
+wog-dump convert-normals ./unpacked --recursive   # optional: fix normal maps
+```
+
+Every command documents itself: `wog-dump --help` and `wog-dump <command> --help`.
+
+### Common options
+
+| Option | Purpose | Example |
+| --- | --- | --- |
+| `--weapons` | Limit a command to specific weapons | `--weapons "ak74,m4a1,glock17"` |
+| `--update-keys` | Fetch fresh decryption keys first | `wog-dump download-assets --update-keys` |
+| `--check-only` | Preview pending downloads without fetching | `wog-dump download-assets --check-only` |
+| `--validate` | Verify decrypted files after decryption | `wog-dump decrypt-assets --validate` |
+| `--extras` | Include UI arrows, cutaway meshes and VFX in a scene | `wog-dump build-scene ak47 --extras all` |
+| `--state` | Disassembly pose: `field-strip`, `exploded`, `parts` | `wog-dump build-scene ak47 --state exploded` |
+| `--assembly-steps` / `--animated` | Step-by-step build, add a placing animation | `wog-dump build-scene ak47 --assembly-steps 5 --animated` |
+| `--animations` | Embed the operate animation in the GLB | `wog-dump build-scene ak47 --animations` |
+| `--viewer` / `--annotate` | Self-contained HTML viewer, add part markers | `wog-dump build-scene ak47 --viewer --annotate` |
+| `--format` | Extra formats: `stl`, `usd`, `usdz`, `fbx` | `wog-dump build-scene ak47 --format stl,usdz --stl-units mm` |
+| `--video` / `--clip` | Orbit MP4 or one animation clip | `wog-dump render ak47 --video --clip "Take 001"` |
+| `--part` / `--merge` | Print single parts or one combined layout | `wog-dump print-export ak47 --merge` |
+| `--locale` | Message language (`ru` ships a catalog) | `wog-dump --locale ru catalog` |
+| `--no-progress` | Disable progress bars (also automatic for piped output) | `wog-dump --no-progress full-pipeline` |
+| `--max-threads` | Worker threads (global option, default 4) | `wog-dump --max-threads 16 full-pipeline` |
+| `--verbose` / `--debug` | Increase logging detail | `wog-dump --debug full-pipeline` |
+
+### Scene output
+
+`build-scene` writes everything you need into `runtime/scenes/<weapon>/`:
+
+```text
+<weapon>.glb        # full scene: hierarchy, materials, camera, studio lights
+blender_setup.py    # one-click Blender import + collections + .blend save
+scene.json          # manifest: state, placements, counts, skipped objects, parts
+viewer.html         # offline viewer (with --viewer, annotations with --annotate)
+textures/           # source PNG textures (also embedded in the GLB)
+previews/           # turntable PNGs + preview.gif (from wog-dump render)
+renders/            # orbit / clip MP4s (from wog-dump render --video)
+print/              # STLs + print_report.json (from wog-dump print-export)
+```
+
+Non-assembled states go to sibling folders: `<weapon>-field-strip/`, `<weapon>-exploded/`, `<weapon>-parts/`, and `<weapon>-steps/` for step builds.
+
+### Cache management
+
+```bash
+wog-dump cache --migrate         # import legacy weapons.txt / keys.txt
+wog-dump cache --show-cache      # detailed cache statistics
+wog-dump cache --validate-assets # check downloads exist and are non-empty
+```
+
+### Web UI
+
+A local web UI over the same pipeline: catalog with statuses, a 3D viewer per weapon and stage buttons with live logs. Needs the web extra, binds 127.0.0.1 with a per-start token URL.
+
+```bash
+pip install "rewog[web]"
+wog-dump serve
+```
+
+### Docker
+
+No local Python needed, all state lives in a named volume mounted at `/data`:
+
+```bash
+docker run --rm -it -v wog-data:/data ghcr.io/inzgiba/rewog:latest catalog
+docker run --rm -it -v wog-data:/data ghcr.io/inzgiba/rewog:latest full-pipeline --update-keys
+docker compose run --rm wog catalog   # from the repo, via docker-compose.yml
+```
+
+Images publish to GHCR on release tags (`latest` plus semantic versions), pull requests build the image without pushing.
+
+### Using as a Python library
+
+```python
+from wog_dump.core.catalog import build_catalog
+from wog_dump.core.config import get_config
+from wog_dump.core.download import DownloadManager
+from wog_dump.core.decrypt import KeyManager, AssetDecryptor
+
+config = get_config()
+
+with DownloadManager(config) as downloader:
+    successful, failed = downloader.download_assets(["ak74", "m4a1"])
+
+key_manager = KeyManager(config)
+keys = key_manager.load_keys()
+
+decryptor = AssetDecryptor(config)
+decrypted_files, failed_assets = decryptor.decrypt_all_assets(keys)
+
+# Catalog status without the CLI
+for entry in build_catalog(config):
+    if entry.scene:
+        print(entry.name, entry.size_bytes)
+```
+
+More library entry points: `core.export.convert_format` (GLB to STL/USD/FBX), `core.render.RenderManager` (previews and video), `core.viewer.render_viewer_html` (offline viewer), `core.probe.ProtocolProbe` (compatibility check). The API reference pages live in the docs site.
+
+## Configuration
+
+Settings come from a gitignored `.env` in the repository root (see [`.env.example`](.env.example)) or from the environment. Credentials, sessions, keys and the weapon list are stored in a per-user SQLite database, never in the repository.
+
+| Setting | Required | Default | Description |
+| --- | --- | --- | --- |
+| `WOG_ACCOUNT_EMAIL` / `WOG_ACCOUNT_PASSWORD` | No | — | Game account for automatic login (alternative to a captured session) |
+| `WOG_AUTH_ID` / `WOG_AUTH_SESSION` | No | — | Captured client session from your own traffic ([guide](docs/mitm-capture.md)) |
+| `WOG_DEVICE_ID` | No | generated | Device id sent to the API |
+| `WOG_DB_PATH` | No | OS user data dir | Location of the per-user SQLite database |
+| `WOG_API_BASE_URL` | No | `https://eu1.ultimate-disassembly.com/v/query2026.php` | Key API endpoint |
+| `WOG_DATA_BASE_URL` | No | `https://data1eu.ultimate-disassembly.com/uni2018` | Asset download server |
+| `WOG_GAME_VERSION` | No | `2.2.3t6` | Client version string validated by the server |
+| `WOG_UNITY_VERSION` | No | `6000.0.84f1` | Unity version string |
+| `WOG_LANG` | No | `en` | Language code sent with login queries |
+| `WOG_LOCALE` | No | `en` | CLI message language (`ru` ships a catalog) |
+| `WOG_NO_PROGRESS` | No | unset | Set to disable progress bars (same as `--no-progress`) |
+| `WOG_BLENDER_PATH` | No | found on PATH | Blender binary for previews, videos and FBX |
+| `WOG_API_REQUEST_DELAY` | No | `0.25` | Seconds between key-API requests (raise on 429) |
+| `WOG_REQUEST_DELAY` | No | `0.1` | Seconds between asset downloads (raise on 429) |
+| `WOG_MAX_THREADS` | No | `4` | Worker threads (1–16) |
+| `WOG_LOG_LEVEL` | No | `INFO` | Log file verbosity (`DEBUG`/`INFO`/`WARNING`/`ERROR`) |
+| `WOG_LOG_DIR` | No | next to the database | Log directory |
+
+In-depth references:
+
+- **[docs/configuration.md](docs/configuration.md)**: every environment variable, `.env` setup, rate limiting, resumable downloads
+- **[docs/architecture.md](docs/architecture.md)**: how the modules fit together, the extraction pipeline
+- **[docs/database.md](docs/database.md)**: where keys and credentials live, schema, migration from pre-2.4 files
+- **[docs/mitm-capture.md](docs/mitm-capture.md)**: capturing keys and identity from your own game traffic
+- **[docs/plugins.md](docs/plugins.md)**: writing third-party extractor plugins
+- **[docs/research-disassembly-data.md](docs/research-disassembly-data.md)**: where the disassembly poses come from
+- **[docs/benchmarks-download.md](docs/benchmarks-download.md)**: download transport benchmark and decisions
+
+## Development
+
+```bash
+git clone https://github.com/InzGIBA/ReWOG
+cd ReWOG
+uv pip install -e ".[dev]"       # or: pip install -e ".[dev]"
+```
+
+### Checks
+
+```bash
+pytest                          # all tests
+pytest --cov=wog_dump           # with coverage (gate: 85 percent, see .coveragerc)
+pytest -m live                  # against the real servers (needs auth in .env)
+
+black src/ tests/               # formatting
+isort src/ tests/
+mypy src/                       # type checking
+flake8 src/ tests/              # linting
+mkdocs serve                    # docs site preview
+```
+
+### Project structure
+
+<details>
+<summary>Directory map</summary>
+
+```text
+ReWOG/
+├── src/wog_dump/          # Main package (source layout)
+│   ├── core/              # config, http, api, auth, database, keys, paths,
+│   │                      # download, decrypt, unpack, scene, scene_states,
+│   │                      # scene_steps, anim, transforms, glb, export, viewer,
+│   │                      # render, printprep, catalog, probe, key_import, webapp
+│   ├── resources/         # Blender scripts, viewer runtime and templates
+│   ├── utils/             # logging, normal maps, i18n, progress
+│   └── cli/               # Click commands: download, decrypt, unpack, scene,
+│                          # render, print-export, catalog, pipeline, auth,
+│                          # cache, info, serve, convert
+├── tests/                 # unit/ + integration/ (CLI end-to-end, real bundles)
+├── docs/                  # guides, architecture, plugins, benchmarks, API reference
+├── blender-addon/         # Blender 4.2+ extension over the CLI
+├── examples/              # example extractor plugin
+├── scripts/               # addon zip, locale compiler, benchmark and audit tools
+└── pyproject.toml         # PEP 621 packaging
+```
+
+</details>
+
+## FAQ
+
+### General
+
+**Do I need to own the game?**
+The tool downloads public asset files from the game's servers. Ownership is not required. We still recommend owning the game to support the developers.
+
+**What formats does WOG Dump export?**
+Blender-ready glTF 2.0 scenes (`build-scene`), OBJ models, PNG/TGA textures, converted normal maps, binary STL (plain or print-prepared), USD and USDZ packages, FBX through Blender, and self-contained HTML viewers.
+
+**How do I get a disassembled weapon?**
+Use a state: `wog-dump build-scene ak47 --state field-strip` places parts exactly where the game puts them after removal. `--state exploded` spreads parts along removal directions, `--state parts` lays everything out in a grid. `--assembly-steps 5 --animated` adds a step-by-step build and one placing animation.
+
+**Can I show a scene to someone without Blender?**
+Yes: `wog-dump build-scene ak47 --viewer` produces one `viewer.html` file. Open it in any browser, click parts to highlight them, read sizes in the annotation cards. Share the file directly, it needs no internet.
+
+**Which operating systems are supported?**
+Windows, macOS and Linux. The tool is pure Python (no C dependencies since v2).
+
+**How much disk space do I need?**
+Encrypted ~2–5 GB, decrypted ~2–5 GB, extracted ~3–8 GB. Plan for **10–20 GB** free.
+
+### Troubleshooting
+
+**Everything broke after a game update**
+Run `wog-dump info --protocol-probe` first. It checks endpoint reachability, the anonymous query, the authenticated key query, the weapon list asset and your client version, and tells you whether the problem is local or the game protocol moved. Any FAIL exits with code 2, report drifts with the [protocol drift template](https://github.com/InzGIBA/ReWOG/issues/new?template=protocol_drift.md).
+
+**`No game account configured` when fetching keys**
+The key API needs authentication. Run `wog-dump register` (new account), `wog-dump login` (existing one), or put `WOG_ACCOUNT_EMAIL`/`WOG_ACCOUNT_PASSWORD`, or a captured `WOG_AUTH_ID`/`WOG_AUTH_SESSION`, into `.env` (see [docs/mitm-capture.md](docs/mitm-capture.md)). Check what is configured with `wog-dump cache`.
+
+**`Authentication failed (result=100)`**
+The API rejected the credentials. Verify the email/password pair in the game client itself, then `wog-dump login` again. A captured session expires sometimes. Capture a fresh one or switch to account login.
+
+**`Session rejected (result=1000)`**
+The stored session expired. WOG Dump re-logins automatically, if the error persists, run `wog-dump logout && wog-dump login`.
+
+**`429` / rate-limit errors**
+Requests are too frequent. Raise the throttles in `.env`: `WOG_API_REQUEST_DELAY=2.0` (key API) and `WOG_REQUEST_DELAY=0.5` (downloads).
+
+**`No weapon list found. Run 'download-weapons' first.`**
+Run `wog-dump download-weapons`. Coming from a pre-2.4 installation with `runtime/weapons.txt`? Import it once with `wog-dump cache --migrate`.
+
+**`No decryption keys found. Use --update-keys to fetch them.`**
+Run `wog-dump decrypt-assets --update-keys` (auth must be configured).
+
+**Key API stopped working after a game update**
+The client version strings are validated server-side. Update them in `.env` to match the current client (find the values in the game's installation or a fresh capture), e.g. `WOG_GAME_VERSION=2.2.3u9` and `WOG_UNITY_VERSION=6000.0.84f1`.
+
+**Interrupted download: do I have to start over?**
+No. Partial downloads are kept as `runtime/assets/*.tmp` and resumed via HTTP `Range` requests on the next run. If a `.tmp` file refuses to go away, delete the file to force a fresh download.
+
+**The tool seems stuck or slow**
+Check your internet connection, reduce the thread count (`wog-dump --max-threads 2 download-assets`), enable `--verbose` (or `--debug`), and remember that downloads are throttled by design (see `WOG_REQUEST_DELAY`).
+
+**Previews or videos say "Blender not found"**
+Install Blender, or point `WOG_BLENDER_PATH` in `.env` at the binary. Renders use CPU Cycles, so no GPU is required.
+
+## Blender addon
+
+A native Blender extension (4.2+) over the same CLI: browse the catalog in a sidebar panel, build missing scenes and import the GLB without a terminal. Install the zip from a release, enable it in preferences, set the runtime directory. See [blender-addon/README.md](blender-addon/README.md).
+
+## Contributing
+
+Issues and pull requests are welcome: bug fixes, features, documentation, tests, plugins and localization all help. For larger changes, open an issue first to discuss the approach.
+
+1. Fork and clone the repository, then `uv pip install -e ".[dev]"`.
+2. Create a feature branch and make a focused change.
+3. Add or update relevant tests and docs, run `pytest`, `black src/ tests/` and `mkdocs build --strict`.
+4. Open a pull request.
+
+- [Contributing Guidelines](CONTRIBUTING.md): the detailed contribution process
+- [Issue Tracker](https://github.com/InzGIBA/ReWOG/issues): bug reports and feature requests
+- [Discussions](https://github.com/InzGIBA/ReWOG/discussions): questions and general help
+- [Code of Conduct](CODE_OF_CONDUCT.md): community standards
+
+## Support
+
+Where to get help, in the order we recommend:
+
+1. The [FAQ](#faq) above
+2. **[SUPPORT.md](SUPPORT.md)**: diagnostics and common solutions
+3. **[GitHub Issues](https://github.com/InzGIBA/ReWOG/issues)**: bug reports and feature requests (public, searchable)
+4. **[GitHub Discussions](https://github.com/InzGIBA/ReWOG/discussions)**: questions and general help
+
+Please use the public channels so answers remain useful to others. For security-sensitive reports only, email the maintainer directly: [inzgiba@gmail.com](mailto:inzgiba@gmail.com).
+
+## License
+
+Released under the MIT License, see [LICENSE](LICENSE).
+
+**Legal disclaimer.** This tool is intended for educational and research purposes only. Extracted assets remain the intellectual property of Noble Empire Corp., ensure compliance with the game's Terms of Service, use extracted content only for personal, educational or research purposes, and do not redistribute game assets or use them commercially. The authors and contributors are not responsible for any misuse of this software or violation of terms of service. For questions about asset usage rights, contact Noble Empire Corp. directly.
+
+## Acknowledgements
+
+- [DeadZoneGarry](https://github.com/DeadZoneLuna): original decryption research
+- [Noble Empire Corp.](https://noble-empire.com/news.php): the game and its assets
+- [three.js](https://threejs.org) contributors: the viewer runtime (MIT, vendored)
+- Contributors to the original WOG Dump project

rewog-3.0.0.dist-info/RECORD

@@ -0,0 +1,70 @@
+wog_dump/__init__.py,sha256=1a4aZgR9jdXDTCRmwC-2hPDq6QY1Gi38Eg2R3cIb7uE,781
+wog_dump/cli/__init__.py,sha256=bJtcNJltyvgvYYTd9bC7Wz5mU7fYO3vgdVy4M5LgnDk,43
+wog_dump/cli/auth.py,sha256=Ha0Yb7VX9LC6CDnGtIES870YKXegnVtNGoGo1QUlH-Q,4110
+wog_dump/cli/cache.py,sha256=su8V5dZ3D2FoW0J17HXH1247FPbMskOfn-fo_oClDes,4550
+wog_dump/cli/catalog.py,sha256=FP3AIgdLeDCb-YTdCDuNgnFrqa6ntQ2YvPaM3F52SRo,4865
+wog_dump/cli/convert.py,sha256=Jz3rU8H5Tcgie2k6qQqq2Zfjcb42TZi1PFFH-TqOE9g,2090
+wog_dump/cli/decrypt.py,sha256=wgYOmfXvaoiPZ__CtOgWD7hG81Bg5eCrr_2uHri6p18,3950
+wog_dump/cli/download.py,sha256=xWt71CfZPtrdca2EdaPDMR08MfX1qhK5TjZEm0mtDW0,8195
+wog_dump/cli/errors.py,sha256=rRCo2W3qD740QUrLvOFwTSfrxrqh3bA3ygk38vzBwBk,2151
+wog_dump/cli/info.py,sha256=yemsp_fc-NNSo03k1DmlOdjlhkQ1AS48VZRaFT7WUQ4,6579
+wog_dump/cli/main.py,sha256=3jE90lSm4HMfKdAodQ2DADOOGSM6kLNOXoyOMckr3aM,8112
+wog_dump/cli/pipeline.py,sha256=GoDldlCUFm11f3-rBDRr3sSyzXNMsWcg4r0em-Hwv68,5640
+wog_dump/cli/print_export.py,sha256=ZEmrNqxvqyv4vRhNuN1DF1QG5IYfj0I5PdEFq6gGO78,3374
+wog_dump/cli/render.py,sha256=X9Y1xTZrkl6EwDknQqNch5eI_gp0JD_p1ehe3lpzdus,5527
+wog_dump/cli/scene.py,sha256=N-PglLToPjQXq3qNVnEIptCB5N5O211ZY19EmTLknig,7690
+wog_dump/cli/serve.py,sha256=s2nfXTYgP-FAvWDNA0j2ljHwD0JygjR9lUh6fMoUnnA,1740
+wog_dump/cli/unpack.py,sha256=K7LsUCmDZXt1daUyBtLlPN0e11zULGAsC7F9jH3GeYY,3605
+wog_dump/core/__init__.py,sha256=7q7bKOOY6kFOoh6JiK7jnKkxNIPLe1HGa48mCYPs1ao,39
+wog_dump/core/anim.py,sha256=4TVXYa8gI93H3vBkovYYbDHo9K6ruvR8uecveJfqHKw,3338
+wog_dump/core/api.py,sha256=ztmgYVlrsWHptV8yyliUquOmchn7PjxGDG2g7fnBk6g,5378
+wog_dump/core/auth.py,sha256=d25fUFOpKkAcibxJNbZyfHmMUrf0H6f2ifcU2LQidWE,18380
+wog_dump/core/catalog.py,sha256=MEA4GoVC5kR8aeLMzxZxZp55gSp620N6kYsmPZ7dIag,3783
+wog_dump/core/config.py,sha256=-4ywxrhWrM-2Z-y8pw4iwSCCIEUZ1-u2_25ogBaMn_g,12362
+wog_dump/core/database.py,sha256=efKoDKCyII2wDNuzi8apt5fSrex3Ael0RG410t94QS4,14302
+wog_dump/core/decrypt.py,sha256=H932uDdNPHg4C14elHBsbkm1n1QJ2_dyunRkTTu19bE,11457
+wog_dump/core/download.py,sha256=4yzvUh_2_UVhRzYfyBA5-SYlS4k8rY9T0pIwNI3spPk,26678
+wog_dump/core/export.py,sha256=96e5kX_dMI0ubRBzsXCw7DnS1iGbjwxHxdWVODPulmw,22724
+wog_dump/core/glb.py,sha256=RT8QQiLtNiMD3n9xqlWA2yRxYFZYrbaMIRmGxu0fwAo,23191
+wog_dump/core/http.py,sha256=4-GkvDBHS2V7DmjXPW5x1OeinGRo8oLUkiY_wSE-tZc,2295
+wog_dump/core/key_import.py,sha256=b_JNbsIP62zdrRJMG0firexr7WRu_Mge9nyCCY8CLjo,17288
+wog_dump/core/keys.py,sha256=1QeyumIwQEZdevDNE9nBOl5P3Y96zb2BXSIRMwkKDgs,10981
+wog_dump/core/paths.py,sha256=OEnytNA1zCuughbIrKGAOpRafc-et8APIdyMw_tNY_8,2346
+wog_dump/core/printprep.py,sha256=tzoXklZ8i7RQ1SJDKGw6kfJvpCt25W6i_bJnlSiO8To,8085
+wog_dump/core/probe.py,sha256=k45LiJm90UWD8xdj35xwFp3TG31xybL_ELYAnTG6WI8,7042
+wog_dump/core/render.py,sha256=um9yG8kmDjiOiUzzlTeAVdmczlzRxyaCvSgcpaBrK-k,11514
+wog_dump/core/scene.py,sha256=R6-SD2nPtgUP8iUYAMsCzSfBDvckxNrNiScpFe2Znmw,52271
+wog_dump/core/scene_states.py,sha256=NzmbWUBP6J0lkIUGMKcQDKriXjMSFWaLddBEPe8m0yw,15123
+wog_dump/core/scene_steps.py,sha256=Mnh8832qwX4Mz490QfTkkxhsqyL7p6yWKaHE2wduLQo,2547
+wog_dump/core/transforms.py,sha256=Rl-8Pt6hz8572wABqf1YOKXDjgFEO13XOQMbjpB-Ogw,5879
+wog_dump/core/unpack.py,sha256=mEVzzruR6N1bEdZEZysuC8bxbb0VpxJ34jdDd0HqA04,30852
+wog_dump/core/viewer.py,sha256=VUYf8bSqgLIEAabCnkhv6pokd-8CWJMs5sbsjV2Gx4w,4479
+wog_dump/core/webapp/__init__.py,sha256=hTrsRlGqlEu68dhnoDNk1yBCPGhheh3quslkNchGAgs,47
+wog_dump/core/webapp/app.py,sha256=ATBDSUCYNXb6HYelun7Oy0Ppq8nXzFJK6d3bMN7ceIk,7825
+wog_dump/core/webapp/static/app.js,sha256=OfPJbgvOczJg3kZr29n3usvQYO62CfNz4GqvOhoUcFc,1958
+wog_dump/core/webapp/static/index.html,sha256=0YCXIrGtwTRrI4lpSpjnowJyr6kS5rE-nHo_rzKekOI,932
+wog_dump/core/webapp/static/weapon-view.js,sha256=1gXk4TXiZtIeSFf0Fh30zc844uMpoXrLL8yWIq20fKU,4115
+wog_dump/core/webapp/static/weapon.html,sha256=ZXUSJYdSJLD0qUVhueMyU64ME_Jh3SPLpy30Um3Sjlo,1557
+wog_dump/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+wog_dump/resources/blender_setup.py,sha256=qMgJYhUqAWGzFUDZP2ie4zsxEQ-A5dCRepowoSbKbjc,5928
+wog_dump/resources/render_turntable.py,sha256=bL3C2Jmyo0SukhrozALG2LyxAGnltwhGKXUQAwXdXgc,3636
+wog_dump/resources/render_video.py,sha256=jSRcC1-L2x4oR3n3Xa4ZT4H2RqjXSvvL9qTuE8BoyWs,4147
+wog_dump/resources/locales/ru/LC_MESSAGES/wog_dump.po,sha256=G65Rlia-BOuT9MOY-xGyvW9xE6MhhjENpBH1Ub8crQA,1874
+wog_dump/resources/viewer/template.html,sha256=gxj5y45BqtFHC_QaLI5hE3wt11caGuO1AhPRVVElq8E,2565
+wog_dump/resources/viewer/viewer.js,sha256=IEReM6r4uvgn2cnlJ2PHFVhuOlwp47LSzdth7VO-7io,10309
+wog_dump/resources/viewer/vendor/LICENSE,sha256=TECh72JFC4V8OyqvKUk2MEzVUtll-82dMtTFvPS6RFQ,1081
+wog_dump/resources/viewer/vendor/PATCHES.md,sha256=u87vHCSlDC7OayLZdgHEO0t9BlW51zAYRis6-bJRT7Q,341
+wog_dump/resources/viewer/vendor/three.module.min.js,sha256=CP11RdE9LH-2WraRUwqALa_v1jhZZQGFTyZ9D7E8Oec,691648
+wog_dump/resources/viewer/vendor/addons/controls/OrbitControls.js,sha256=gO-q3qT4pjamX7C9CL_vYvPZOgu5Ti51APIxdsXAf04,32134
+wog_dump/resources/viewer/vendor/addons/loaders/GLTFLoader.js,sha256=xlpn3k17--VgfmggrvIVE061FGWXd6uWh2uwXIMn854,110283
+wog_dump/resources/viewer/vendor/addons/utils/BufferGeometryUtils.js,sha256=wlt5MOVw6exWFzzTuGbsjS4QAWYw2zk377Q52vHO2_Y,31768
+wog_dump/utils/__init__.py,sha256=_TXdRCmm21A8nrpHR43hZ3Ps-WVRJr8l--q8lGUgf_A,38
+wog_dump/utils/i18n.py,sha256=SyoBkCpSbz4yNk3BsM6uZuhb2-6hwA8GbHB-aG7cRlM,2481
+wog_dump/utils/logging.py,sha256=hqHqR9jtlOWvire1_ogayN2RgmmjZPfZbUmjZrjS-8k,20046
+wog_dump/utils/normal_map.py,sha256=F-k37iDPS4qGA0mJ8PgzjkGfe9slX2uY0FD3dDii898,12135
+wog_dump/utils/progress.py,sha256=63GOnc2AacIU0LMhml1QQz3L_v4xMjku51yyog3cgn8,3009
+rewog-3.0.0.dist-info/METADATA,sha256=YVmt_ys8x1P-juYSuBDZ7AyHJ3dueN-nB1fE9CjDQlw,28499
+rewog-3.0.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+rewog-3.0.0.dist-info/entry_points.txt,sha256=VPyFfxaWRM6AIWX9n5kas14m6EY8MKL30GjQA8p1GLg,109
+rewog-3.0.0.dist-info/licenses/LICENSE,sha256=ApViGy1oBKE28DGEzMMLLYVPScOJINuy8UyoalAEkMU,1063
+rewog-3.0.0.dist-info/RECORD,,

rewog-3.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

rewog-3.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+wog-convert-normals = wog_dump.utils.normal_map:cli_main
+wog-dump = wog_dump.cli.main:main

rewog-3.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 InzGIBA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wog_dump/__init__.py

@@ -0,0 +1,27 @@
+"""WOG Dump - Enhanced tool for extracting 3D models from World of Guns: Gun Disassembly.
+
+This package provides a complete pipeline for downloading, decrypting, and unpacking
+3D gun models from World of Guns: Gun Disassembly with modern Python features,
+comprehensive error handling, and performance monitoring.
+"""
+
+from __future__ import annotations
+
+__version__ = "3.0.0"
+__author__ = "hampta, inzgiba"
+__email__ = "inzgiba@gmail.com"
+__license__ = "MIT"
+__description__ = (
+    "Enhanced tool for extracting 3D models from World of Guns: Gun Disassembly"
+)
+
+# Version info tuple for programmatic access
+VERSION_INFO = tuple(int(x) for x in __version__.split("."))
+
+__all__ = [
+    "__version__",
+    "__author__",
+    "__email__",
+    "__description__",
+    "VERSION_INFO",
+]

wog_dump/cli/__init__.py

@@ -0,0 +1 @@
+"""Command-line interface for WOG Dump."""