mb-sc-tools 0.1.1

Mobile-friendly Supercell .sc decoder and encoder for Python

mb-sc-tools

mb-sc-tools is a Python library and CLI for decoding and encoding Supercell .sc files on phones and desktops.

It supports:

• decoding .sc into PNG textures and data.json
• encoding edited PNGs back into .sc
• SC wrappers with zstd, lzma, and lz4 payloads
• ARM64 phones and desktop systems
• automatic astcenc download on first use for ASTC/KTX textures
• configurable workspace, output paths, backup name, and ASTC encoder path

Install

pip install mb-sc-tools

CLI

mb-sc-tools

Or direct commands:

mb-sc-tools decode /path/to/ui.sc
mb-sc-tools encode /path/to/sc_decoded/ui

More explicit control:

mb-sc-tools decode /path/to/ui.sc \
  --workspace-root /tmp/sc-work \
  --output-dir /tmp/sc-work/custom/ui \
  --source-backup-name source.sc

mb-sc-tools encode /tmp/sc-work/custom/ui \
  --workspace-root /tmp/sc-work \
  --output /tmp/sc-work/sc_encoded/ui.sc

Python API

from pathlib import Path

from mb_sc_tools import (
    DecodeOptions,
    EncodeOptions,
    WorkspaceConfig,
    decode_to_workspace,
    encode_folder,
)

workspace = WorkspaceConfig(root=Path("/tmp/sc-work"))

decoded_dir, data = decode_to_workspace(
    Path("/sdcard/ui.sc"),
    options=DecodeOptions(
        workspace=workspace,
        source_backup_name="source.sc",
    ),
)

encoded_path = encode_folder(
    decoded_dir,
    options=EncodeOptions(
        workspace=workspace,
        output_path=Path("/tmp/sc-work/sc_encoded/ui.sc"),
    ),
)

Output layout

On Android/Termux, if /sdcard/sc exists the tool writes to:

• /sdcard/sc/sc_decoded/<file_stem>/
• /sdcard/sc/sc_encoded/<original_name>.sc

Otherwise it writes to a local ./sc/ workspace.