sc-file
🇬🇧 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 |
[!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.exein File Explorer. - Command line: run
scfile.exe --helpfor 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
📚Documentation: sc-file.readthedocs.io❓Questions? Check FAQ or contact me🐛Found a bug? Open an issue💻Download executable: Latest release🔧Compile from source: Build guide
🤝 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0aacd86d940749cd88fcc98028d24b329f152d47e2c33d888387bd90b2c64128
|
|
| MD5 |
48e1a35430012750f918fb6cce9e93f9
|
|
| BLAKE2b-256 |
35a0afabbec10d458b0f1385a3664a29c800663a565cdd49733a6a2608199b38
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
dd2874da34c657c7fab0f116f634680c5ca5ac056dc4497e79b4ad009ded8418
|
|
| MD5 |
4717733cfd2ffd7c4e871cca1e48f828
|
|
| BLAKE2b-256 |
c5a34c208581d557f777a5741d4a295c9f20f960bb43ebdec3e9af43c28a4976
|