🇬🇧 English | 🇷🇺 Русский

scfile is a utility and library for converting proprietary Stalcraft assets formats to standard ones.

This is an unofficial project and is not affiliated with EXBO.

* NBT refers to specific files (itemnames.dat, prefs, sd0, etc.)

📚 Detailed formats support →

Three ways to get started: download, install, or compile.
📚 Usage guide and CLI options →

Standalone scfile.exe available on Releases page.
No Python required.

Usage:

• 🖥️ GUI: launch scfile.exe without arguments to open graphical interface
• 📥 Drag & Drop: drag file onto scfile.exe
• 🖱️ Open With: set as default app for supported formats
• 📟 Command Line: scfile.exe --help
  Command example: scfile.exe model.mcsb -F glb --skeleton
  Options in example: -F picks model format, --skeleton extracts model armature.

Install:

pip install sc-file        # library + cli
pip install sc-file[gui]   # library + cli + gui

Usage:

• 📖 Python library: See Library section
• 🖥️ GUI via package: scfile
• 📟 CLI via package: scfile --help

Build from source code using the compile guide.
For developers, contributors, or custom builds.

Install latest version:

pip install sc-file -U

Usage example:

from scfile import convert, formats, Options

# Simple conversion (auto detect format by file suffix)
# User options to control parsing and export settings
convert.auto("model.mcsb", options=Options(skeleton=True))

# Advanced control (manual decoding and data inspection)
# Context manager ensures proper resource cleanup
with formats.mcsb.McsbDecoder("model.mcsb") as mcsb:
    # Access parsed scene data: meshes, bones, etc
    data = mcsb.decode()
    print(f"Meshes: {[mesh.name for mesh in data.scene.meshes]}")
    print(f"Materials: {[mesh.material for mesh in data.scene.meshes]}")
    print(f"Bones: {[bone.name for bone in data.scene.skeleton.bones]}")

    # Export to a specific standard format
    mcsb.to_obj().save("output.obj")

📚 Complete Library API reference →

• 📚 Documentation: sc-file.readthedocs.io
• ❓ Questions? Check FAQ or contact me
• 🐛 Found a bug? Open an issue
• 💻 Download executable: Latest release
• 🔧 Compile from source: Build guide

kommunist2021 · Art3mLapa · n1kodim · TeamDima · BoJIwEbNuK7
IExploitableMan · tuneyadecc · Hazart

Thanks to everyone who reported issues, shared findings, or contributed ideas.