https://github.com/qirashi/dvpl_go
Dvpl converter to Go Lang. (The fastest and most convenient dvpl converter)
https://github.com/qirashi/dvpl_go
dava dvpl go lz4 tanksblitz tb wotb wotblitz zlib
Last synced: 7 days ago
JSON representation
Dvpl converter to Go Lang. (The fastest and most convenient dvpl converter)
- Host: GitHub
- URL: https://github.com/qirashi/dvpl_go
- Owner: qirashi
- License: apache-2.0
- Created: 2025-03-26T05:34:04.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2026-02-19T08:49:36.000Z (24 days ago)
- Last Synced: 2026-02-19T11:43:48.940Z (23 days ago)
- Topics: dava, dvpl, go, lz4, tanksblitz, tb, wotb, wotblitz, zlib
- Language: Go
- Homepage: https://t.me/qirashi_squad
- Size: 360 KB
- Stars: 14
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Notice: NOTICE
Awesome Lists containing this project
README
[](https://github.com/qirashi/dvpl_go/blob/main/LICENSE )
# dvpl_go [RU] | [EN](README_EN.md)
> [!NOTE]
> Конвертер использует библиотеку [lz4](https://github.com/lz4/lz4) для повышения скорости и качества сжатия.
> Формат имеет ограничения по размеру сжимаемых данных!
## Как использовать?
> [!TIP]
> [Гайд по использованию конвертера на Русском](.readme/how_to_use.md)
> [A guide to using the converter in English](.readme/how_to_use_en.md)
## Поддерживаемые типы сжатия
> [!NOTE]
> | Тип | Название | Описание |
> |------|----------|------------------------------------------|
> | 0 | none | Сжатие полностью отсутствует. |
> | 1 | lz4hc | Более сильное и медленное чем lz4. |
> | 2 | lz4 | Менее сильное и более быстрое чем lz4hc. |
## Переменные Cреды
В переменных среды могут храниться 2 настройки конвертера `DVPL_MAX_WORKERS` и `DVPL_COMPRESS_TYPE` для указания кол-ва параллельно работающих процессов и тип сжатия соответсвенно.
- `DVPL_MAX_WORKERS` — Максимальное количество параллельных обработчиков. (В случае слишком большого кол-ва, ограничится)
- `DVPL_COMPRESS_TYPE` — Указывает уровень сжатия от 0 до 2. (В случае не существующего типа, будет ошибка)
Как задать:
1. **Создать вручную**
- Нажать `Win+R`.
- Выполнить `SystemPropertiesAdvanced`.
- Открыть `Переменные среды...` и создать соответсвующие переменные.
2. **Через команндную строку**
- `Пуск` → `cmd` → `правой кнопкой` → `Запуск от имени администратора`
- Вставь одну из команд:
* Для одного пользователя:
```cmd
setx DVPL_MAX_WORKERS 4
setx DVPL_COMPRESS_TYPE 1
```
* Для всех пользователей (с админом):
```cmd
setx DVPL_MAX_WORKERS 4 /M
setx DVPL_COMPRESS_TYPE 1 /M
```
## CMD
```cmd
R:\Github\dvpl_go\out>dvpl.exe -h
dvpl_go 2.0.0 x64 | Copyright (c) 2026 Qirashi
Usage: dvpl [options]
[Options]:
-c Compress .dvpl files.
-compress int
Compression type: 0 (none), 1 (lz4hc), 2 (lz4) | (default 1)
-d Decompress .dvpl files.
-filter string
List of file patterns to include. ("*.sc2,*.scg")
-forced-compress
Force compression even if the result is larger than the original.
-i string
Input path. (file or directory)
-ignore string
List of file patterns to ignore. ("*.exe,*.dll")
-ignore-compress string
List of file patterns for which compression should be disabled. ("*.webp")
-keep-original
Keep original files.
-m int
Maximum number of parallel workers (12). Minimum 1, recommended 2 | (default 2)
-o string
Output path. (file or directory)
-skip-crc
CRC can be ignored when unpacking or packing.
Examples:
Compress : dvpl -c -i ./in_dir -o ./out_dir
Decompress : dvpl -d -i ./in_dir -o ./out_dir
Ignore : dvpl -c -i ./in_dir -ignore "*.exe,*.dll"
Filter : dvpl -d -i ./in_dir -o ./out_dir -filter "*.sc2,*.scg"
No compress: dvpl -c -i ./in_dir -ignore-compress "*.webp"
Compression: dvpl -c -i ./in_dir -compress 2
```
### Описание команд
- `-c` — Сжатие в `.dvpl`.
- `-d` — Распаковка `.dvpl`.
- `-i` — Входная директория или файл.
- `-o` — Выходная директория или файл.
- `-keep-original` — Сохранять оригинальный файл при распаковке или сжатии.
- `-compress` — Указывает уровень сжатия от 0 до 2.
- `0` — `none`
- `1` — `lz4hc`
- `2` — `lz4`
- `-ignore` — Список шаблонов файлов, которые стоит игнорировать. (Файлы и расширения не будут обработаны)
- `-ignore-compress` — Список шаблонов файлов, которые принудительно будут сжаты в 0 тип. (Например `*.webp`)
- `-filter` — Список файлов шаблонов, которые будут обработаны. (Только файлы и расширения, которые будут обработаны, обратный от `-ignore`)
- Например вам нужно распаковыать в отдельную папку только `*.webp` и `*.txt`.
- Это будет выглядеть так: `dvpl -d -i ./in -o ./out -filter "*.webp,*.txt" -keep-original -m 4`
#### Символы подстановки для фильтров:
- `*` — любое количество символов (кроме `/`).
- `?` — один символ.
- `[abc]` — один из указанных символов.
#### Примеры:
- `*.exe` — игнорировать все `.exe` файлы.
- `file?.log` — игнорировать файлы вида `file1.log`, `file2.log`.
- `folder/*.txt` — игнорировать все `.txt` файлы в папке `folder`.
- `data[1-3].csv` — игнорировать файлы `data1.csv`, `data2.csv`, `data3.csv`.
- `image_[xyz].png` — игнорировать файлы `image_x.png`, `image_y.png`, `image_z.png`.
- `-m` - Максимальное количество параллельных обработчиков (workers).
- По умолчанию: 2 (однопоточный режим)
- Оптимальное значение: 2-4 (зависит от CPU)
- При указании значений > максимума автоматически корректируется.
- Максимальное кол-во зависит от ядер и потоков процессора.
- `-skip-crc` - При распаковке CRC будет проигнорирован.
## Сравнение скорости работы
### Этот конвертер на GoLang с многопотоком (2 workers) (lz4hc)
```
Начало: 16:4:43.85
Конец: 16:5:2.78
-----------------
Всего: 0 ч 0 мин 18.93 сек
Вес: 1,15 ГБ (1 244 843 076 байт)
```
### Другой конвертер на NodeJS (lz4hc)
```
Начало: 15:59:13.41
Конец: 16:0:10.19
-----------------
Всего: 0 ч 0 мин 56.78 сек
Вес: 1,15 ГБ (1 243 007 962 байт)
```
### Другой конвертер на GoLang (lz4)
```
Начало: 16:18:37.28
Конец: 16:18:43.51
-----------------
Всего: 0 ч 0 мин 6.23 сек
Вес: 2,81 ГБ (3 020 488 406 байт)
```
## Итоги
Данный конвертер является оптимальным вариантом сжатия и скорости. Он позволяет выбрать уровень сжатия, что сказывается на скорости. В режиме сжатия `lz4hc` он обгоняет своих одноклассников по скорости и не уступает в качестве. Другой конвертер на Go использовал `lz4`, что сжимает хуже, но быстрее. Этот же конвертер работает быстро и поддерживает все основные доступные методы.