STF Blender

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

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

🌰 Read the User Guide! 🌰 Report Issues 🌰 STF Documentation

Installation

From Repository (preferred)

Follow the steps on docs.stfform.at!

Manual

Download the latest release
Add it under: Edit → Preferences → Get Extensions → Click on the top right most dropdown → Install from Disk...

---

Tip

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

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

Development Setup

• Have an up to date version of Blender installed.
• Either:
  • Use bpydev.py included in this repository.
  • Use VSCode with the recommended extensions.
    The most important one is Blender VS Code.
• Create a Python 3.13 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)