STF Blender

Squirrel Transfer Format - Modular 3D Interchange-Format
Intended for (not only) games-development use-cases.

WIP implementation for Blender 4.5+. Do not use productively!

🌰 User Guide 🌰 Report Issues 🌰 STF Documentation

---

Please open issues for any bugs or misbehavior you notice. Feel free to open issues for feature requests.

Installation

Follow the steps on docs.stfform.at!

Alternatively you can also manually install the .zip from the latest release.

Tip

Also install the Slot Link extension if you want to import/export animations.

Extend STF

You can easily implement your own resources as a separate Blender extension, and have this importer & exporter detect them!
Get started from this template!

Development Setup

• After cloning, change into the repo dir and run:

   git submodule update --init

• Have an up to date version of Blender installed.
• Either:
  • Use bpydev.py included in this repository.
    Run python bpydev.py -h for more info.
  • Use VSCode with the recommended extensions.
    The most important one is Blender VS Code.
• Create a Python 3.14 venv in the repo directory.
• Inside the venv run:

   pip install -r requirements.txt

Contributing

Human made contributions via pull-requests are very welcome.

See CONTRIBUTING.md for guidelines.

License

All source-code in this repository, except when noted in individual files and/or directories, is licensed under either:

• MIT License (LICENSE-MIT or https://opensource.org/license/MIT)
• Apache License, Version 2.0 (LICENSE-APACHE2 or http://www.apache.org/licenses/LICENSE-2.0)