https://github.com/atom0s/dravex
Dungeon Runners Asset Viewer and Extractor
https://github.com/atom0s/dravex
Last synced: about 1 month ago
JSON representation
Dungeon Runners Asset Viewer and Extractor
- Host: GitHub
- URL: https://github.com/atom0s/dravex
- Owner: atom0s
- License: agpl-3.0
- Created: 2022-11-07T23:29:53.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-12-14T23:54:44.000Z (over 3 years ago)
- Last Synced: 2025-12-30T10:06:17.917Z (5 months ago)
- Language: C
- Size: 1.49 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# dravex
**dravex**, short for `Dungeon Runners Asset Viewer and Extractor`, is an asset viewer and extractor tool for the now-discontinued MMORPG, Dungeon Runners. **dravex** allows you to open and parse the games `game.pki` and `game.pkg` files which contains the games various data files such as textures, fonts, objects, map information, configurations, and more.
**dravex** supports the following client versions:
- **v118**
- **v666**
_**Note:** dravex supports these two main client versions, however, support for any other version is most likely valid and works as-is without needing to edit anything in dravex. If you have a client version that is not listed here, please contact atom0s directly to have it validated and/or have support added if need be!_
## Donations & Sponsorships
**dravex** is released completely free of charge. You can say thanks by donating or via sponsorships.
* **GitHub Sponsor:** https://github.com/sponsors/atom0s
* **Patreon Sponsor:** https://patreon.com/atom0s
* **PayPal Donation:** https://www.paypal.me/atom0s
## Credits
**dravex** is coded in C++ (making use of newer C++17/20 features) by @atom0s
The following tools are used to make **dravex**:
* **Visual Studio Code (Insiders)**: https://code.visualstudio.com/insiders/
* **C/C++ Extension**
* **CMake Extension**
* **CMake Tools Extension**
* **CMake**: https://cmake.org/
* **vcpkg**: https://vcpkg.io/en/index.html
The following third-party libraries are used to make **dravex**:
* **Direct3D9**: https://learn.microsoft.com/en-us/windows/win32/direct3d9/dx9-graphics
* **ImGui**: https://github.com/ocornut/imgui
* **imgui_colortexteditor**: https://github.com/BalazsJako/ImGuiColorTextEdit
* **imgui_fontawesome**: https://github.com/juliettef/IconFontCppHeaders
* **imgui_memoryeditor**: https://github.com/ocornut/imgui_club
* **zlib**: https://www.zlib.net/
* **miniaudio**: https://miniaud.io/index.html
* **stb_vorbis**: https://github.com/nothings/stb
Credits to the following for additional resources:
* **Agave Font**: https://github.com/blobject/agave
* **FontAwesome**: https://fontawesome.com/ _(For their icon fonts.)_
* **max.icons**: Icon used for the project.
## Building dravex
**dravex** is built using **VSCode**, **CMake** and **vcpkg** as the main tooling. For third-party libraries that are maintained outside of this repository, **vcpkg** is generally used. This includes things such as `zlib`.
You will need to install the various requirements for this project with the following commands:
```
vcpkg install zlib
```
Because of issues with some versions of Windows, Powershell and vcpkg, you may need to adjust/tweak paths for your system.
You can find overrides for working with zlib and vcpkg inside of the `CMakeLists.txt` file near the top of the file:
```
# Define the toolchain to use vcpkg..
set(CMAKE_TOOLCHAIN_FILE "Z:/SourceCode/deps/vcpkg/scripts/buildsystems/vcpkg.cmake" CACHE STRING "Vcpkg toolchain file")
set(Z_VCPKG_BUILTIN_POWERSHELL_PATH "C:/Program Files/Powershell/7/pwsh.exe")
```
_This is currently setup to match my personal build environment and system setup due to said bugs._
Once you have all requirements and such installed and configured, you can use the VSCode CMake toolbar at the bottom of the window to select the desired build, presets, and targets to build **dravex**.
## License
**dravex** is licensed under [GNU AGPL v3](https://github.com/atom0s/dravex/blob/main/LICENSE)
Please be sure you understand the license before making use of **dravex**. This is `AGPL`, not standard `GPL`.
## Legal
**dravex** is developed solely for educational purposes, with the intent of research into data storage, compression, and MMORPG technologies.
We (contributors) do not claim ownership of any copyright content related to, or associated with, `Dungeon Runners`.
```
© 2008 NC Interactive, Inc. All rights reserved.
```
Please note; the reverse engineering done by this repository and its contributors is entirely 'clean room'. We **DO NOT** have or use any leaked source code or other unpublished material. By contributing to this repository, you agree to the following:
- You are not employeed by NCSoft, NC Interactive, any partner/subsidiary, or have been previously, in any capacity.
- You do not and have never had any leaked material related to `Dungeon Runners` in any manner.
- You do not and have never referenced any leaked or otherwise unreleased material related to `Dungeon Runners` in any manner.
We **DO NOT** claim ownership of any material or information gathered through the means of reverse engineering the client and its files for this purpose.
## Screenshots
Below are some screenshots of **dravex**:
