sc-file
🇬🇧 English | 🇷🇺 Русский
Overview
scfile is a utility 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 .dae .ms3d .fbx |
| 🧱 Texture | .ol |
→ | .dds |
| 🖼️ Image | .mic |
→ | .png |
| 🗃️ TextureArray | .texarr |
→ | .zip |
| 🗺 Region | .mdat |
→ | .mca |
| ⚙️ NBT* | ... |
→ | .json |
* NBT refers to specific files (itemnames.dat, prefs, sd0, etc.)
[!IMPORTANT]
Reverse conversion (standard→game) is not available.
📚 See FAQ for details →
🚀 Installation
Three ways to get started: download, install, or compile.
📚 Usage guide and CLI options →
💻 Download executable
Standalone scfile.exe available on Releases page.
No Python required.
Usage:
- 🖥️ GUI: launch
scfile.exewithout arguments to open graphical interface - 📥 Drag & Drop: drag file onto
scfile.exe - 🖱️ Open With: set as default app for supported formats
- 📟 Command Line:
scfile.exe --help
Command example:scfile.exe model.mcsb -F glb --skeleton
Options in example:-Fpicks model format,--skeletonextracts model armature.
🐍 Install Python package
Install:
pip install sc-file # library + cli
pip install sc-file[gui] # library + cli + gui
Usage:
- 📖 Python library: See Library section
- 🖥️ GUI via package:
scfile - 📟 CLI via package:
scfile --help
🔧 Compile from source
Build from source code using the compile guide.
For developers, contributors, or custom builds.
📖 Library
Install latest version:
pip install sc-file -U
Usage example:
from scfile import convert, formats, Options
# Simple conversion (auto detect format by file suffix)
# User options to control parsing and export settings
convert.auto("model.mcsb", options=Options(skeleton=True))
# Advanced control (manual decoding and data inspection)
# Context manager ensures proper resource cleanup
with formats.mcsb.McsbDecoder("model.mcsb") as mcsb:
# Access parsed scene data: meshes, bones, etc
data = mcsb.decode()
print(f"Meshes: {[mesh.name for mesh in data.scene.meshes]}")
print(f"Materials: {[mesh.material for mesh in data.scene.meshes]}")
print(f"Bones: {[bone.name for bone in data.scene.skeleton.bones]}")
# Export to a specific standard format
mcsb.to_obj().save("output.obj")
🔗 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.
1 maintainer
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-5.2.0.tar.gz.
File metadata
- Download URL: sc_file-5.2.0.tar.gz
- Upload date:
- Size: 204.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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 |
682538cc952b459a502f1ce6d513e2a27afe7306df2a81317bb0bffb6664c501
|
|
| MD5 |
00eb8585e9a0cdb60698a9d54682ba5e
|
|
| BLAKE2b-256 |
7f3c19c7e09e9f819dda38656787610bf3f84568ba21e8c8da60b7698a3d0c51
|
File details
Details for the file sc_file-5.2.0-py3-none-any.whl.
File metadata
- Download URL: sc_file-5.2.0-py3-none-any.whl
- Upload date:
- Size: 240.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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 |
1d7ac552e230d3ac75e9372d646cd365e93d8d13be7bb4287b25d7246fac4813
|
|
| MD5 |
e75f72ce1f3c053e8ad55f6dae356065
|
|
| BLAKE2b-256 |
50ab3ebb550364423cb64011d70d410a08ece7c6e186bf811f1c6eea7baa862f
|
