sc-file 5.1.0

Utility & Library for decoding stalcraft assets

sc-file

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

Overview

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.

✨ Supported Formats

Type	Game formats	→	Standard formats
🧊 Model	.mcsb .efkmodel	→	.obj .glb .dae .ms3d .fbx
🧱 Texture	.ol	→	.dds
🖼️ Image	.mic	→	.png
🗃️ TextureArray	.texarr	→	.zip
🗺 Region	.mdat	→	.mca
⚙️ NBT*	...	→	.json

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

📚 Detailed formats support →

[!IMPORTANT]
Reverse conversion (standard → game) is not available.
📚 See FAQ for details →

🚀 Installation

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

💻 Download executable

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 Python package

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

🔧 Compile from source

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

📖 Library

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 →

🔗 Links

• 📚 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

🤝 Acknowledgments

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

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