G2/lbee-utils
1
0
Fork 0
mirror of https://github.com/G2-Games/lbee-utils.git synced 2025-04-12 03:42:53 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions
A small collection of utilities for exporting and importing assets from Little Busters! English Edition
171 commits 4 branches 8 tags 2.3 MiB
Rust 93.6%
Typst 6.4%
Find a file
G2-Games 3e4b51cad5 Fixed libasound2 installation
2025-03-10 12:21:11 -05:00
.github/workflows Fixed libasound2 installation 2025-03-10 12:21:11 -05:00
cz Applied clippy suggestions, ran cargo fmt 2024-11-14 13:04:15 -06:00
documents Added typst version of spec in place of ODT 2024-09-11 03:15:22 -05:00
luca_pak Added rather unfortunate audio playback to pak explorer 2025-03-08 23:36:31 -06:00
luca_script Updated version, changed to Rust 2024 2025-03-10 12:18:20 -05:00
pak_explorer Updated version, changed to Rust 2024 2025-03-10 12:18:20 -05:00
utils Applied clippy suggestions, ran cargo fmt 2024-11-14 13:04:15 -06:00
.gitignore Added gitignore for pdf files 2024-09-16 12:32:58 -05:00
Cargo.toml Added preliminary script parsing 2024-11-16 04:29:43 -06:00
README.md Updated readme 2024-11-15 21:51:43 -06:00

README.md

Lbee-Utils

A small collection of utilities for exporting and importing assets from games made with LUCA System by Prototype Ltd.

Tested on the following games:

  • Little Busters! English Edition (2017)
  • LOOPERS (2023)
  • Harmonia Full HD Edition (2024)
  • Kanon (2024)
  • planetarian ~Snow Globe~ (Nintendo Switch) (2024)

Please test on your own games and open an issue if something isn't working.

Acknowledgments

The implementation of compresssion and decompression of CZ1, CZ2, CZ3, and CZ4 was derived from LuckSystem. The implementation for decompression of CZ1, CZ3, and CZ4 was originally derived from GARbro, but no longer is.

This project would not have been possible without the work of these previous projects!

Licensing

The libraries are licensed under the MIT License which allows for easy integration into existing projects. The applications and programs are licensed under the GPLv3. Please read the licences before deciding how to use this project in your own, thank you!

Features

These decoders and encoders are structured as libraries first and tools second. It's possible to use them as a base to build other applications.

CZ Images

Completely accurate CZ# file decoding and encoding. Read more about that here:

https://g2games.dev/blog/2024/06/28/the-cz-image-formats/

PAK Archives

Partial implementation of PAK files, enough to extract data from most I've encountered, and replace data as long as decoding is successful. Any extra metadata can't be changed as of yet, however.

Programs

lbee-utils

Small command line tools for modifying CZ images and PAK archives.

To install with Cargo:

cargo install --git https://github.com/G2-Games/lbee-utils lbee-utils

Otherwise, download the binaries from the Releases page here.

PAK Explorer

This is a basic explorer application for PAK files which allows you to see their contents, replace the contents, extract files, and save them again.

While this is a useful tool for just viewing and extracting the contents of a PAK file, it is recommended to use the command line tools for doing anything important as they offer many more options and allow for batch operations on many files at once.

image

To install with Cargo:

cargo install --git https://github.com/G2-Games/lbee-utils pak_explorer

Otherwise, download the binaries from the Releases page here.