VPKEdit
VPKEdit is an open source MIT-licensed tool that can create, extract from, preview the contents of and write to several pack file formats.
## Installing
Please read [this file](https://github.com/craftablescience/VPKEdit/blob/main/INSTALL.md) for step-by-step installation instructions. VPKEdit is available for Windows 7+ and
macOS (arm64), and has been packaged for multiple Linux distributions.
## Features
- Supported file formats:
| Format | Description | Create | Read | Write |
|----------|--------------------------------------------------------|:------:|:----:|:-----:|
| 007 | Asset pack (007 - Nightfire) | ❌ | ✅ | ❌ |
| APK | Axiom PacK file (Fairy Tale Busters) | ✅ | ✅ | ✅ |
| BEE_PACK | BEE2.4 Package | ✅ | ✅ | ✅ |
| BMZ | Bonus Map Zip (Source Engine) | ✅ | ✅ | ✅ |
| BSP | Source 1 Map | N/A | ✅ | ✅ |
| FGP | File group (PS3, The Orange Box) | ✅ | ✅ | ✅ |
| FPX | VPK modification (Tactical Intervention) | ✅ | ✅ | ✅ |
| GCF | Game Cache File (Pre-SteamPipe Steam games) | ❌ | ✅ | ❌ |
| GMA | Garry's Mod Addon | ❌ | ✅ | ✅ |
| HOG | Unknown acronym (Descent) | ❌ | ✅ | ❌ |
| OL | Worldcraft Object Library | ❌ | ✅ | ❌ |
| ORE | Unknown acronym (Narbacular Drop) | ❌ | ✅ | ❌ |
| PAK | PAcK file (Quake I&II, original Half-Life, HROT, etc.) | ✅ | ✅ | ✅ |
| PCK | Godot PaCK file (Standalone or embedded) | ✅ | ✅ | ✅ |
| PK3 | PacK v3 (Quake III, RTCW, W:ET) | ✅ | ✅ | ✅ |
| PK4 | PacK v4 (Quake IV, Doom 3) | ✅ | ✅ | ✅ |
| PKZ | PacK file (Quake II RTX) | ✅ | ✅ | ✅ |
| SIN | SiN pack file (SiN 1998) | ❌ | ✅ | ✅ |
| VPK | Valve PacK file (Source Engine) | ✅ | ✅ | ✅ |
| VPK | Vampire PacK file (V:TMB) | ✅ | ✅ | ✅ |
| VPP | Volition Pack file (Red Faction, Saints Row) | ❌ | ✅ | ❌ |
| WAD | Where's All the Data (GoldSrc Engine) | ✅ | ✅ | ✅ |
| XZP | Xbox ZiP (Xbox Half-Life 2) | ❌ | ✅ | ❌ |
| ZIP | ZIP file | ✅ | ✅ | ✅ |
- Preview files contained within the pack file without extracting them:
- Audio
- Text files (any encoding)
- KeyValues files (text files with syntax highlighting)
- Images
- Source 1 Textures
- Prop lightmaps
- Troika textures
- Valve textures for both PC and console
- Source 1 Models
- Source 1 DMX files (particles, SFM sessions, etc.)
- Create pack files of any version from scratch or an existing folder
- Add and remove files and folders from writable pack files
- Directly edit text files within writable pack files
- Extract files and folders from readable pack files
- Switch version of existing VPKs
- Native Linux builds
- Packaged for Arch, Debian, Fedora, NixOS; standalone builds available
- User interface translated to the following languages ([support the translation effort here](https://poeditor.com/join/project/yxR9MLc9X2)):
🇧🇦 🇨🇳 🇭🇷 🇳🇱 🇩🇪 🇮🇹 🇯🇵 🇰🇷 🇵🇱 🇧🇷 🇷🇺 🇸🇮 🇪🇸 🇸🇪 🇻🇳
Please read [this file](https://github.com/craftablescience/VPKEdit/blob/main/CONTROLS.md) to see all keyboard shortcuts.
A separate application with no external dependencies (`vpkeditcli`) provides a command-line interface.
> [!NOTE]
> If you need to edit files for a Source 2 game, consider using [Source 2 Viewer](https://s2v.app) instead.
> This application targets GoldSrc and Source 1, and will not parse any Source 2 filetypes.
## Planned Features
See [the open issues on this repository marked as an enhancement](https://github.com/craftablescience/VPKEdit/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement).
## Contributing
This project accepts a wide range of contributions, mostly code and translations. Code contributions are done through this GitHub repository.
Translations are open to everyone, only requiring a free POEditor account, and are hosted at https://poeditor.com/join/project/yxR9MLc9X2.
Any contributors will be added to the credits in the form of a text file shipped with the CLI application and a popup in the GUI application.
## Backend
This tool is powered by a collection of open-source C++20 Source engine parsers called [sourcepp](https://sourcepp.org).
## Star History
