Skip to content

MarkusMaal/FlipnicBinExtractor

Repository files navigation

Flipnic Game Data Extractor

This tool allows you to extract data from .BIN files using a properietary format. Despite being proprietary, the TOC format is not too difficult to understand.

NOTE: If you want faster extraction performance, please use FlipnicFileTools instead. Keep in mind it doesn't support "from-scratch" repacking yet, only single file replacement is currently available (for safety reasons).

image

TOC explained

  • TOC is divided into 64 byte chunks, each chunk begins with the filename (up to 60 characters) and ends with 4 pointer bytes.
  • Each pointer is addressed by 2048 bytes (0x800).
  • The first file in TOC is always "*Top Of CD Data", which identifies the beginning of the data stream.
  • The last file is always "*End Of CD Data", which is the end offset of the .BIN file.
  • Folders are identified by "\" at the end of the filename
  • Folders cannot contain subfolders
  • Each folder also has the same 64-byte chunk structure, but there is no first file identifying the start of data stream
  • The last file in every folder is "*End Of Mem Data", identifying the end offset of the folder
  • Each pointer is addressed by 1 byte (0x1), but to get the actual location you need to add the folder offset to the pointer value
  • Same filenames are allowed

Command line usage

  • To extract data, use the following syntax: FlipnicBinExtractor /e [source] [destination]
  • To list directory, use the following syntax: FlipnicBinExtractor /l [source]
  • To data to a subfolder, use the following syntax: FlipnicBinExtractor /f [source] [destination]
  • For full repacking, use the following syntax: FlipnicBinExtractor /c [source] [destination]

Examples

  • FlipnicBinExtractor /e RES.BIN Extracted
  • FlipnicBinExtractor /e FONT.BIN FONT
  • FlipnicBinExtractor /l RES.BIN
  • FlipnicBinExtractor /f BOSS1 BOSS1\A
  • FlipnicBinExtractor /c FONT FONT.BIN

VGMToolBox settings

These settings can be used in VGMToolBox (VGMToolbox > Misc. Tools > Extraction Tools > Generic > Virtual File System Extractor) for extracting BIN files (note that this will only work if the BIN file has no subfolders, you will need to use my tool for more advanced extraction purposes):

  • Header Size or File Count > Header Ends at Offset <offset of the last "*End Of CD Data" file>
  • File Record Information > File Records begin at offset 0 and each record has size 0x40
  • Individual File Offset > File Offset is at Offset 60 and has size 4 and byte order Little Endian
    • and do calculation (use $V to represent the value at the offset) $V*2048
  • Individual File Length > Use File Offsets to determine File Lengths
  • Individual File Name Location/Offset > File Name is Included in the Individual File Record at Offset 0
  • Individual File Name Size > Has Static Size 59

About

This command-line tool allows you to extract data from .BIN container files in proprietary format used in Flipnic(TM).

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages