About this project

brarchive-extractor is a command-line tool written in TypeScript designed to process Minecraft Bedrock resource files. It handles the extraction of individual or batched .brarchive files and can convert MCB binary documents into JSON format by utilizing provided schemas. Schemas can be sourced from Mojang's official repositories, exported from BDS using bds-docs, or exported from the client using ll-client-schema-exporter. The tool is installed as a short alias, brax, and requires Node.js 20 or newer. It includes validation for archive bounds, path traversal, output conflicts, and trailing MCB data. The CLI supports various options for directory scanning, output management, and conflict resolution, allowing users to extract files in place, overwrite existing content, or generate detailed reports on processing failures and conflicts.