sc-file

sc-file#

scfile is a program 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, .efkmodel

→

.obj, .glb, .fbx

🌀 Animation
.mcvd + .mcsb,
.mcal + .mcsb

→

.glb

🧱 Texture

.ol

→

.dds

🗺️ Tiles

pda/*.ol

→

.jpeg, .png

🖼️ Image

.mic

→

.png

🗃️ Archive

.texarr

→

.zip

⛰️ Region

.mdat

→

.mca

⚙️ NBT
itemnames.dat common
prefs sd0-4

→

.json

Details about formats →

Important

Reverse conversion (standard → game) is not available.
See FAQ for details →

🚀 Usage#

Download executable#

Download scfile.exe from the Releases page.

Usage:

  • Graphical interface: launch scfile.exe.

  • Drag and drop: drag files or folders onto scfile.exe in File Explorer.

  • Command line: run scfile.exe --help for commands and options.

For example#
scfile.exe model.mcsb -F glb --skeleton
This exports the model and its armature to GLB.
Usage guide for other options.

Install the Python package#

pip install sc-file
pip install sc-file[gui]  # extra graphical interface

The base package includes only library and CLI.

Compile from source#

See the build guide for development, contributions, and custom builds.

📖 Library#

Install or update the package:

pip install sc-file -U

Usage example:

from scfile import convert, formats, Options

# Detect the source format and convert it
convert.auto("model.mcsb", options=Options(skeleton=True))

# Use an explicit conversion and output path
convert.mcsb_to_obj("model.mcsb", "output/model.obj")

# Decode a known format and inspect its data
with formats.McsbDecoder("model.mcsb") as mcsb:
    model = mcsb.decode()

print([mesh.name for mesh in model.scene.meshes])
print([bone.name for bone in model.scene.skeleton.bones])

Complete library documentation →

🤝 Acknowledgments#

kommunist2021 · Art3mLapa · n1kodim · TeamDima · BoJIwEbNuK7
IExploitableMan · tuneyadecc · Hazart

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