sc-file 4.2.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 .mcsa .mcvd	→	.glb .obj .dae .ms3d
🧱 Texture	.ol	→	.dds
🖼️ Image	.mic	→	.png
📦 Archive	.texarr	→	.zip
⚙️ Data	NBT*	→	.json

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

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

[!TIP]
📚 Detailed formats support →

🚀 Quick Start

Three ways to get started: download, install, or compile.

1. 💻 Download executable

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

Usage:

• 📥 Drag & Drop: drag file onto scfile.exe
  What is drag and drop?
• 🖱️ Open With: set as default app for supported formats
  How to set default app (Windows)?
• 📟 Command Line: scfile.exe --help
  What is command line interface?
  Example: scfile.exe model.mcsb -F glb --skeleton
  Options: -F picks model format, --skeleton extracts armature.

2. 🐍 Install Python package

Install:

pip install sc-file

Usage:

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

3. 🔧 Compile from source

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

[!TIP]
📚 Usage guide and CLI options →

📖 Library

Install latest version:

pip install sc-file -U

Usage example:

from scfile import convert, formats, UserOptions

# Simple conversion (auto detect format by file suffix)
# User options to control parsing and export settings
convert.auto("model.mcsb", options=UserOptions(parse_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
    scene = mcsb.decode().scene
    print(f"Model total vertices: {sum(m.count.vertices for m in scene.meshes)}")

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

[!TIP]
📚 Complete Library API reference →

🔗 Links

• 📚 Documentation: sc-file.readthedocs.io (usage, cli params, formats, api)
• ❓ 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
IExploitableMan · Sarioga · Hazart

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