Index

• 🚀 Usage
• ❓ FAQ
• ✨ Formats Support
• 📝 Game Formats
• 🔧 Compile
• 📖 Library
• 📋 Changelog

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.)

See also

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

💻 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")

See also

📚 Complete Library API reference →

🔗 Links

• ❓ 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.