sssekai_blender_io

Blender asset importer for Project SEKAI (JP: プロジェクトセカイカラフルステージ！ feat.初音ミク) asset bundles.

Tested on Blender 4.0.3, 4.2.0 Alpha, 4.2.0 LTS, 4.3.0 Alpha

Importer Features

Textures
Character Toon Material (via SekaiShaderStandalone)
Static/Skinned Meshes
Armatures
Articulations (Scene rebuilt with Empty object and static meshes)
Physics (WIP. Limited support for Rigidbodies, Colliders, and Spring Bones)
Animations (Armatures, Articulations, BlendShape, Camera. From live_pv and streaming_live assets)

Supported Languages

PRs are welcome for additions.

You can find the translation file here.
The script used to generate the translation file is here. Run this in the root of this repo, with any Python 3.8+ interpreter to update the translation file. Exisiting translations will be preserved.

You can find your language code by entering bpy.app.translations.locale in the Blender Python console.

Currently supported languages and maintainers:

English (en_US, mos9527)
简体中文 (zh_HANS, mos9527)

Installing & Updating

Install the dependencies

Navigate to your Blender installation path, and find the Python interperter of your version. (e.g. C:\Program Files (x86)\Steam\steamapps\common\Blender\4.0\python\bin\python.exe)
- ...and no, managing your Blender installation with Steam isn't recommended.
- (For Windows) It is recommended, however,to use the portable ZIP package instead of the MSI installer for your blender installation to avoid file permission issues
In its working directory (i.e. ...\python\bin), run the following (in a command prompt. In Windows you can press Shift+Mouse Right Click to open up a new Terminal/Powershell Prompt)
```
.\python -m ensurepip
.\python -m pip install --no-user -U sssekai 
```
- Make sure the scripts are deployed to your Blender instance.

Run .\python.exe -m pip show sssekai and look for the Location field. It should be in your Blender's Python Scripts directory.

Name: sssekai
Version: 0.4.4
Summary: Project SEKAI Asset Utility / PJSK 资源下载 + Live2D, Spine, USM 提取
Home-page: https://github.com/mos9527/sssekai
Author: greats3an
Author-email: greats3an@gmail.com
License:
Location: C:\Program Files (x86)\Steam\steamapps\common\Blender\4.2\python\Lib\site-packages
Requires: coloredlogs, msgpack, pycryptodome, python-json-logger, requests, tqdm, unitypy, wannacri
Required-by:

If Location mismatched

Specifying --no-user can help to avoid this issue
This is most commonly introduced when the script deployed to the user installation directory, such as C:\Users\mos9527\AppData\Roaming\Python\Python311, due to permission issues
- On Windows - this could happen if your Blender instance is installed via the offical MSI installer and installing it in the Program Files directory. Without admin rights, the script will be installed in the user directory - which cannot be accessed by Blender.
Uninstall sssekai, and its dependencies
- This could be tricky. However, if the package are installed in the user directory, you can simply delete the entire user directory (C:\Users\mos9527\AppData\Roaming\Python\Python311 in the example)
- Or, to uninstall it one by one:
```
.\python -m pip freeze sssekai > ~\sssekai.txt
.\python -m pip uninstall -r ~\sssekai.txt
```
  You may want to expand ~ to your actual user directory.
With a elevated shell (e.g. Win + X -> Terminal/Powershell (Admin)), navigate to your Blender Python path again, and reinstall with .\python -m pip install -U sssekai
Install the addon
- Download this repo as zip
- In Blender, go to Edit > Preferences > Add-ons > Install... and select the zip file you just downloaded.
- The addon should appear in the 3D Viewport sidebar (N key) under the tab SSSekai

Documentation

See the wiki page!

Notes

The plugin is observed to work with other Unity games as well. But such compatibility is not guaranteed, and WILL NOT receive support from the author in full capacity.

License

MIT

mos9527 / sssekai_blender_io

readme