https://github.com/pagonia-land/plpaker
Packing Tool for Pioneers of Pagonia
https://github.com/pagonia-land/plpaker
modding modding-games modding-tools packing pagonia patching pioneers-of-pagonia unpacking
Last synced: 3 days ago
JSON representation
Packing Tool for Pioneers of Pagonia
- Host: GitHub
- URL: https://github.com/pagonia-land/plpaker
- Owner: pagonia-land
- License: mit
- Created: 2024-02-08T21:01:40.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-06-19T12:46:41.000Z (almost 2 years ago)
- Last Synced: 2024-06-19T18:57:19.192Z (almost 2 years ago)
- Topics: modding, modding-games, modding-tools, packing, pagonia, patching, pioneers-of-pagonia, unpacking
- Language: C++
- Homepage: https://Pagonia.Land
- Size: 24.4 KB
- Stars: 5
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Pagonia Land Paker
Packing Tool for [Pioneers of Pagonia](https://pioneersofpagonia.com/)
> [!WARNING]
> **This repository is archived and no longer maintained.**
>
> This repository contains the original standalone implementation of **Pagonia Land Paker**.
>
> Development has moved to the actively maintained version in the [Pagonia Land](https://pagonia.land) project:
>
> 👉 https://github.com/pagonia-land/Pagonia-Land/tree/main/tools/pagonia-paker
>
> The new implementation provides additional functionality and will receive all future updates.
> This project is not affiliated in any way with Envision Entertainment GmbH
---
**PLPaker** is a console application that is best used with PowerShell.
Here is an example: `.\plpaker.exe unpack .\core.pak`
*Always use absolute or relative paths*
```bash
usage: plpaker [] []
commands:
list [] # Parse pak file and write pakinfo.json
unpack [] # Unpack pak file into the folder
pack [] # Pack new pak file based on pakinfo.json
compress # Compress a file
decompress # Decompress a file
patch # Repack pak file with files to be replaced
options:
-c | --compress # Unpack/Pack compressed files
-d | --decompress # Unpack/Pack decompressed files
If no options are specified, all options are active, otherwise only the set ones.
parameters:
-s | --start # Start index: -s=38
-e | --end # End index: -e=1602
-f | --filter # Name filter: -f=gold
All parameters work on unpack and pack commands.
```
## Download
- Latest version: https://dl.pagonia.land/plpaker.zip
- MD5: https://dl.pagonia.land/plpaker.md5
- Readme: https://dl.pagonia.land/plpaker
Need help? - Please feel free to ask us on [Discord](https://Pagonia.Land/)
## How to Make a Simple Mod
Please make a backup of the original pak file or simply copy it to the folder where this tool is located.
1. `.\plpaker.exe unpack .\core.pak .\mod -f=system.ini`
2. **Adjust game camera and speed:** `mod\system.ini`
3. `.\plpaker.exe patch .\core.pak .\mod.pak .\mod\system.ini`
4. Replace `core.pak` in game folder with `mod.pak`
## Build
```bash
mkdir build
cd build
```
```bash
# debug
cmake ..
cmake --build . --parallel
```
And for an optimized version:
```bash
# release
cmake -D CMAKE_BUILD_TYPE=Release ..
cmake --build . --config Release --parallel
```
## Requirements
* **C++23** compatible compiler
* [CMake](https://cmake.org/) **3.26+**
# Third-Party
* [argh](https://github.com/adishavit/argh) Â **Argh! A minimalist argument handler** Â *3-clause BSD*
* [zlib](https://github.com/madler/zlib) Â **A massively spiffy yet delicately unobtrusive compression library** Â *zlib*
* [json](https://github.com/nlohmann/json) Â **JSON for Modern C++** Â *MIT*
## Collaborate
Use the [issue tracker](https://github.com/pagonia-land/plpaker/issues) to report any bug or compatibility issue.
If you want to **contribute**, we suggest the following:
1. Fork the [official repository](https://github.com/pagonia-land/plpaker/fork)
2. Apply your changes to your fork
3. Submit a [pull request](https://github.com/pagonia-land/plpaker/pulls) describing the changes you have made
## Disclaimer
YOU USE MODS AT YOUR OWN RISK!
By installing Mods for Pioneers of Pagonia, you are changing the official game files and modifying your game experience from the original intended product developed and published by Envision Entertainment GmbH. Keep in mind that they won't be able to provide any official technical support for your game. Changing the files of your game can create bugs, cause instability of the game client or even damage your save file. This means that if anything goes wrong after applying Mods (like black screens or game crashes) the EE support team will not be able to help you until you reset all the changes.
## Credits
[Pioneers of Pagonia](https://pioneersofpagonia.com/) is a trademark of [Envision Entertainment GmbH](https://www.envision-entertainment.de/)
Copyright (c) 2024 - [Pagonia Land](https://pagonia.land/) and [contributors](https://github.com/pagonia-land/plpaker/graphs/contributors)
*Modding community project by [Lava Block](https://lava-block.com/)*