Difference between revisions of "Documentation/Tools/SCS Blender Tools/Installation"
< Documentation | Tools | SCS Blender Tools
Jump to navigation
Jump to search
(Blender/Tools compatibility) |
|||
| (5 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | + | {{Note|<br>Blender Version [https://wiki.blender.org/index.php/Dev:Ref/Release_Notes/2.78 2.78] is compatible with Blender Tools V1.11<br>Blender Version [https://wiki.blender.org/index.php/Dev:Ref/Release_Notes/2.79 2.79] is compatible with Blender Tools V1.10 only(!)}} | |
| + | <!-- https://forum.scssoft.com/viewtopic.php?f=162&t=245065&hilit=invalid&start=170#p844784 --> | ||
| − | + | Before installation make sure you have downloaded SCS Blender Tools from the [[Documentation/Tools/SCS Blender Tools/Download|Download]] page or via cloning the [https://github.com/SCSSoftware/BlenderTools GIT repository]. | |
| − | === 1. | + | === 1. Copying Files === |
| − | + | All the files needed for tools installation are contained in a single folder named "addon/io_scs_tools". This folder must be placed in a location, where Blender can find it and read it as an Addon. It is possible to use an installation method, where you can just point Blender to the Addon location (e.g. if you want to run the tools right from GIT repository). | |
| − | + | You can use one the following installation possibilities: | |
| − | + | # '''LOCAL INSTALLATION (recommended):''' Place the folder "addon/io_scs_tools" to your installation of Blender to the location "/<Blender_installation>/<version_number>/scripts/addons/". The Addon will be used only by this particular installation of Blender. | |
| + | # '''GLOBAL INSTALLATION:''' Place the folder "addon/io_scs_tools" in your profile to the location "/<user_profile>/blender/<version_number>/scripts/addons/" (under Windows that would be <tt>%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\<version>\scripts\addons</tt>). Addon will be used by any Blender installation of specified version. | ||
| + | # '''INSTALLATION TO THE USER DIRECTORY:''' In "User Preferences" within "File" section is the "Scripts" item where you can set the path to any Addon location. This way, for example, you can use any Addon directly from data repository and your tools will always be of the current version in all of your Blender installations. It is necessary for the Addon folder to be placed inside a folder named "addons_contrib" and Blender needs to be directed to its parent folder. Therefore the resulting path to the folder Addons should look like "/<folder>/addons_contrib/io_scs_tools", but the path under Scripts will be only "/<folder>". | ||
| + | #: [[File:Blender_custom_location_for_Scripts.png]] | ||
| + | # '''INSTALL FROM FILE:''' Tools can also be installed using the "Install from File..." button, which you can find in "User Preferences" in the "Addons" section on the bottom bar. | ||
| − | + | === 2. Addon Activation === | |
| − | + | Now it is necessary to activate the "SCS Blender Tools" Addon. This can be easily done in the "User Preferences" in the "Addons" section. In the upper left part of the window click on "Testing" button and in the main window, look for the "Import-Export: SCS Tools". You can use search feature to locate the item. Now activate the checkbox on the right side of SCS Tools entry. If the item is missing in your list, press F8 to reload Addons. | |
| − | + | [[File:Blender_enable_SCS_Tools_Addon.png]] | |
| − | |||
| − | |||
| − | |||
| − | [[File: | ||
Revision as of 20:11, 7 June 2018
Note:
Blender Version 2.78 is compatible with Blender Tools V1.11
Blender Version 2.79 is compatible with Blender Tools V1.10 only(!)
Before installation make sure you have downloaded SCS Blender Tools from the Download page or via cloning the GIT repository.
1. Copying Files
All the files needed for tools installation are contained in a single folder named "addon/io_scs_tools". This folder must be placed in a location, where Blender can find it and read it as an Addon. It is possible to use an installation method, where you can just point Blender to the Addon location (e.g. if you want to run the tools right from GIT repository).
You can use one the following installation possibilities:
- LOCAL INSTALLATION (recommended): Place the folder "addon/io_scs_tools" to your installation of Blender to the location "/<Blender_installation>/<version_number>/scripts/addons/". The Addon will be used only by this particular installation of Blender.
- GLOBAL INSTALLATION: Place the folder "addon/io_scs_tools" in your profile to the location "/<user_profile>/blender/<version_number>/scripts/addons/" (under Windows that would be %USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\<version>\scripts\addons). Addon will be used by any Blender installation of specified version.
- INSTALLATION TO THE USER DIRECTORY: In "User Preferences" within "File" section is the "Scripts" item where you can set the path to any Addon location. This way, for example, you can use any Addon directly from data repository and your tools will always be of the current version in all of your Blender installations. It is necessary for the Addon folder to be placed inside a folder named "addons_contrib" and Blender needs to be directed to its parent folder. Therefore the resulting path to the folder Addons should look like "/<folder>/addons_contrib/io_scs_tools", but the path under Scripts will be only "/<folder>".
- INSTALL FROM FILE: Tools can also be installed using the "Install from File..." button, which you can find in "User Preferences" in the "Addons" section on the bottom bar.
2. Addon Activation
Now it is necessary to activate the "SCS Blender Tools" Addon. This can be easily done in the "User Preferences" in the "Addons" section. In the upper left part of the window click on "Testing" button and in the main window, look for the "Import-Export: SCS Tools". You can use search feature to locate the item. Now activate the checkbox on the right side of SCS Tools entry. If the item is missing in your list, press F8 to reload Addons.
