Index

• 🚀 Usage
• ❓ FAQ
• ✨ Formats Support
• 🎮 Game Formats
• 🔧 Compile
• 📖 Library

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	.obj .glb .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 →

See also

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

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

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

IExploitableMan · Sarioga · Hazart

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