Skip to content

bucanero/apollo-lib

Repository files navigation

Apollo Save Tool Core library (PS2/PS3/PS4/PSP/PS Vita)

Downloads Release License macOS Linux binaries Windows binaries Twitter

This library and command-line tools implement a save-data patch engine that supports Save Wizard/Game Genie codes and Bruteforce Save Data scripts.

The library is cross-platform and is required to build:

Supported Code formats

  • Save Wizard / Game Genie
  • Bruteforce Save Data scripts

Save Wizard / Game Genie

  • Code Type 0: Standard 1 Byte Write
  • Code Type 1: Standard 2 Byte Write
  • Code Type 2: Standard 4 Byte Write
  • Code Type 3: Increase / Decrease Write
  • Code Type 4: Multi-Write (Repeater)
  • Code Type 5: Copy and Paste
  • Code Type 6: Special Mega-code
  • Code Type 7: No More / No Less than Write
  • Code Type 8: Forward Byte Search (Set Pointer)
  • Code Type 9: Pointer Manipulator: (Set/Move Pointer)
  • Code Type A: Mass Write
  • Code Type B: Backward Byte Search (Set Pointer)
  • Code Type C: Address Byte Search (Set Pointer)
  • Code Type D: 2 Byte Test Commands (Code Skipper)

Bruteforce Save Data (BSD)

  • Commands: set, write, search, insert, delete, copy, decrypt, encrypt, endian_swap, compress, decompress
  • Hashes: crc16, crc32, crc32big, crc64_iso, crc64_ecma, md2, md4, md5, md5_xor, sha1, sha256, sha384, sha512, hmac_sha1, sha1_xor64, adler16, adler32, checksum32, sdbm, fnv1, add, wadd, dwadd, qwadd, wadd_le, dwadd_le, wsub, force_crc32, murmur3_32, jhash, jenkins_oaat, lookup3_little2
  • Custom hashes: eachecksum, ffx_checksum, ff13_checksum, deadrising_checksum, kh25_checksum, khcom_checksum, mgs2_checksum, sw4_checksum, toz_checksum, tiara2_checksum, castlevania_checksum, rockstar_checksum
  • Encryption: aes_ecb, aes_cbc, des_ecb, des3_cbc, blowfish_ecb, camellia_ecb
  • Custom encryption: diablo3, dw8xl, silent_hill3, nfs_undercover, ffxiii, borderlands3, mgs_pw, mgs_base64, mgs, mgs5_tpp, monster_hunter, rgg_studio

Apollo savepatch archive

You can find .savepatch files for many PlayStation games in the apollo-patches repository.

CLI Tools

Apollo command-line tools are useful for code creators and developers, to test SW codes and BSD scripts locally on a computer.

parser

The parser command-line tool reads a .savepatch file, and provide a numbered list of detected cheat patches.

Apollo .savepatch parser v0.1.0 - (c) 2021 by Bucanero

USAGE: ./parser filename.savepatch

patcher

The patcher command-line tool reads a .savepatch file and a comma-separated list of patches, and apply the selected cheat codes to the target file.

Apollo cheat patcher v0.1.0 - (c) 2022 by Bucanero

USAGE: ./patcher file.savepatch <1,2,7,..,18> target.file

patcher-bigendian

patcher-bigendian is provided to apply patches on PS3 (big-endian) save-game data files.

Credits

Acknowledgments

Dependencies

This library requires:

License

Apollo Save Tool library - Copyright (C) 2020-2024 Damian Parrino

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.