Compatibility
==================

Compatible Blender Version
----------------------------------

- The addon will officially work with the specified Blender version that matches the Blender addon.
- You can find out which version of Blender the addon is compatible with based on the file name.
- It could work on both old and new Blender versions. But as Blender breaks their API very often, it is advisable to get the correct version of Blender that supports the addon under :ref:`File Name`.
- Blender uses semantic versioning, our compatibility match only applies to the major and minor release of Blender, the patch version should work regardless as long as major and minor versions are matched.

Semantic Versioning
-----------------------------

.. image:: https://media.geeksforgeeks.org/wp-content/uploads/semver.webp

TinkerBoi addon uses Semantic Versioning, which means:
  - The 3 digits between each "." means a different thing.
  - The first value indicates a Major Version, this means the addon has receive a major update that may or may not entirely change how the addon works fundamentally.
  - The second value indicates a Minor Version, this usually means the addon has received a new feature or a few minor tweaks to the addon.
  - The third value indicates patches, usually involving bug fixes or extremely minor changes.

.. note::

  - As Blender constantly changes their API on every new release, the addon has a slight chance to break its compatibility with Blender.
  - While it is not advisable and not guranteed to work. Blender addons generally work in multiple different Blender versions, until it no longer supports it anymore.
  - Support will only be provided to match the compatibility of the Blender version and addon. However, bug reports with matching versions will be fixed if requested.

.. _File Name:

File Name Convention
----------------------------------

.. image:: /static/FileNamingConvention_Addon.webp

Viewfinder / TinkerBoi addon will have a specific naming convention.
  - *Example: B4_1_0_Viewfinder-1_7_0.zip*
  - The first part B4_1_0 indicates the official supported Blender version and the Blender version the addon is developed on.
  - The last numbering 1_7_0 indicates the version of the addon.