sc-file 4.1.2

Utility & Library for decoding stalcraft assets

sc-file

Overview

scfile is a utility and library for converting stalcraft assets (such as models and textures), into standard formats.

this project is unofficial and not related to stalcraft devs. all trademarks and assets belong to their respective owners.

📚 Documentation: sc-file.readthedocs.io
Usage / FAQ / Game Formats / Formats Support / Compile Guide / Library API Reference

🗂️ Supported game formats: .mcsb, .mcsa, .mcvd, .ol, .mic, .texarr.
More about Game Formats...

💻 Executable utility scfile.exe can be downloaded from Releases page or compiled from source
More about Usage...

❓ Why reverse encoding into game formats is unsupported?
And other common questions are answered on FAQ page.

🛠️ Supported Formats

Type	Source	Output
🧊 Model	.mcsb, .mcsa, .mcvd	.glb, .obj, .dae, .ms3d
🧱 Texture	.ol	.dds
🖼️ Image	.mic	.png
📦 Archive	.texarr	.zip

More about Formats Support…

🚀 Usage

• Easiest way is Drag & Drop. Just drag and drop your files onto scfile.exe.
• Set scfile.exe as the default application for the required file types.
• Via terminal as CLI for specifying parameters.
• As Python library for complex tasks.

Command example:

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

More about Usage...

📖 Library

To install library for coding, use following command:

pip install sc-file -U

Simple usage example:

from scfile import UserOptions, convert

# Optional convert settings
options = UserOptions(parse_skeleton=True)

# Specific format to format
convert.mcsb_to_obj(source="path/to/model.mcsb", options=options)

# Or auto detect by file suffix
convert.auto(source="path/to/model.mcsb", options=options)

More details about Library...

🤝 Acknowledgments

• kommunist2021 – file structure research.
• Art3mLapa – advice, bug reports, contribution.
• n1kodim – advice, contribution.
• IExploitableMan – contribution.
• Sarioga – feedback, bug reports.
• Hazart – bug reports.