Skip to content

onejeuu/sc-file

Repository files navigation

sc-file

icon

Pypi License Docs Tests Build Issues

RU

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

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.

About

Utility & Library for decoding stalcraft assets

Topics

Resources

License

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •  

Languages