Contribute to the codebase
Bug fixes, Blender compatibility reports, tests, documentation — all work happens in the public BlastFX repository.
Where help is needed
Blender compatibility reports
Blender 5.2 LTS is the tested target. Newer builds are untested — reports on how they behave are welcome.
Headless / CLI workflow hardening
Development covers install, dev loop, coding rules and the test matrix — see DEVELOPMENT.md below.
Geometry Nodes debris & Asset Browser integration
Planned for Milestone 7 — design and implementation work starts from the open milestone list.
How to start
- Read DEVELOPMENT.md — install, dev loop, coding rules and the test matrix.
- Pick an existing issue or open a new one at the repository.
- Use the example scenes as a baseline: the repository ships test_small, test_medium, test_large and test_large_event under examples/ — open one, press Bake Simulation, and render.
- Code is GNU GPL-3.0-or-later — see LICENSE.txt in the repository.
Codebase documentation
- ARCHITECTURE.md system layers, identity model, cache identity
- PHYSICS.md physics pipeline, SI units, realism tiers, preset profiles
- DEVELOPMENT.md install, dev loop, coding rules, test matrix
- HISTORY.md milestone status and open roadmap
Compatibility reports matter most right now: newer Blender builds are untested, and every report on real behaviour sharpens the 5.2 LTS baseline.