sc-file

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

scfile is a program 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 / .fbx
🌀 Animation	.mcvd + .mcsb, .mcal + .mcsb	→	.glb
🧱 Texture	.ol	→	.dds
🗺️ Tiles	pda/*.ol	→	.jpeg / .png
🖼️ Image	.mic	→	.png
🗃️ Archive	.texarr	→	.zip
⛰️ Region	.mdat	→	.mca
📄 Document	itemnames.dat, common, prefs, sd0-4	→	.json

Details about formats →

Important

Reverse conversion (standard to game) is not available.
See FAQ for details →

🚀 Usage

Download executable

Choose a build on the Releases page:

• Windows: Setup (recommended) or Portable
• Linux: Portable

Portable builds unpack themselves to temp directory on every launch.

Usage:

• Graphical interface: launch scfile.exe.
• Drag and drop: drag files or folders onto scfile.exe in File Explorer.
• Command line: run scfile.exe --help for commands and options.

For example:

scfile.exe model.mcsb -F glb --skeleton

This exports the model and its armature to GLB.
See the usage guide for other options.

Install the Python package

pip install sc-file
pip install sc-file[gui]  # extra graphical interface

The base package includes only library and CLI.

Compile from source

See the build guide for development, contributions, and custom builds.

📖 Library

Install or update the package:

pip install sc-file -U

Usage example:

from scfile import convert, formats, Options

# Detect the source format and convert it
convert.auto("model.mcsb", options=Options(skeleton=True))

# Use an explicit conversion and output path
convert.mcsb_to_obj("model.mcsb", "output/model.obj")

# Decode a known format and inspect its data
with formats.McsbDecoder("model.mcsb") as mcsb:
    model = mcsb.decode()

print([mesh.name for mesh in model.scene.meshes])
print([bone.name for bone in model.scene.skeleton.bones])

Complete library documentation →

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