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 |
| 📄 Document | itemnames.dat, common,prefs, sd0-4 |
→ | .json |
🚀 Usage
Download executable
Choose a build on the Releases page:
- Windows:
Setup(recommended) orPortable - Linux:
Portable
Portable builds unpack themselves to temp directory on every launch.
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.
1 maintainer
Metadata
1 maintainer
Release files for sc-file 6.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sc_file-6.2.1.tar.gz | 255.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sc_file-6.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 568.2 kB
Release files / sc_file-6.2.1.tar.gz
| Download URL | sc_file-6.2.1.tar.gz |
|---|---|
| Size | 255.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
55a3455444aa996c87e021c5118d163d62fd5261b3328e642650757419048633
|
|
BLAKE2b-256 checksum How to use checksums |
f5f6938d5ebdec83f922f879e8cd303faa5683a0cc1f72169a2f2d5b0a0f6dbd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","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}
|
Release files / sc_file-6.2.1-py3-none-any.whl
| Download URL | sc_file-6.2.1-py3-none-any.whl |
|---|---|
| Size | 313.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
786f48ad2ecc4ca59395eb60e773270e5fd958b0dbbf0d82f708734ee8b5c65f
|
|
BLAKE2b-256 checksum How to use checksums |
851a214e09f2e7ea6577bb6e2bc9b20d674632ea9a02155e5f77614a032495f3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","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}
|
