Skip to main content

sc-file

sc-file

PyPI License Docs Tests Build Issues

🇬🇧 English | 🇷🇺 Русский

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 (standardgame) 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.
See the 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 →

🔗 Links

🤝 Acknowledgments

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

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sc_file-6.1.0.tar.gz (234.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sc_file-6.1.0-py3-none-any.whl (282.9 kB view details)

Uploaded Python 3

File details

Details for the file sc_file-6.1.0.tar.gz.

File metadata

  • Download URL: sc_file-6.1.0.tar.gz
  • Upload date:
  • Size: 234.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for sc_file-6.1.0.tar.gz
Algorithm Hash digest
SHA256 0aacd86d940749cd88fcc98028d24b329f152d47e2c33d888387bd90b2c64128
MD5 48e1a35430012750f918fb6cce9e93f9
BLAKE2b-256 35a0afabbec10d458b0f1385a3664a29c800663a565cdd49733a6a2608199b38

See more details on using hashes here.

File details

Details for the file sc_file-6.1.0-py3-none-any.whl.

File metadata

  • Download URL: sc_file-6.1.0-py3-none-any.whl
  • Upload date:
  • Size: 282.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for sc_file-6.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 dd2874da34c657c7fab0f116f634680c5ca5ac056dc4497e79b4ad009ded8418
MD5 4717733cfd2ffd7c4e871cca1e48f828
BLAKE2b-256 c5a34c208581d557f777a5741d4a295c9f20f960bb43ebdec3e9af43c28a4976

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

6.1.0 This release

2 files

6.0.0

2 files

5.2.1

2 files

5.2.0

2 files

5.1.1

2 files

5.1.0

2 files

5.0.1

2 files

5.0.0

2 files

4.4.1

2 files

4.4.0

2 files

4.3.0

2 files

4.2.1

2 files

4.2.0

2 files

4.1.2

2 files

4.1.1

2 files

4.1.0

2 files

4.0.1

2 files

4.0.0

2 files

3.6.1

2 files

3.6.0

2 files

3.5.4

2 files

3.5.3

2 files

3.5.2

2 files

3.5.1

2 files

3.5.0

2 files

3.4.1

2 files

3.4.0

2 files

3.3.1

2 files

3.2.0

2 files

3.1.1

2 files

3.1.0

2 files

3.0.7

2 files

3.0.6

2 files

3.0.5

2 files

3.0.4

2 files

3.0.3

2 files

3.0.2

2 files

3.0.1

2 files

3.0.0

2 files

2.0.0

2 files

1.5.1

2 files

1.3.3

2 files

1.3.2

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page