Utility & Library for decoding stalcraft assets


Keywords
stalcraft
License
MIT
Install
pip install sc-file==3.0.0

Documentation

sc-file

icon

Pypi License Docs Build Issues

RU

Overview

scfile is a utility and library for parsing and 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
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 .obj, .glb, .dae, .ms3d
🧱 Texture .ol .dds
πŸ–ΌοΈ Image .mic .png
πŸ“¦ Archive .texarr .zip

More about Formats Support…

πŸš€ Quick Start

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.