How to install:

After purchasing you will get Easy-PBR-Hook.zip. Don't unzip it!

Launch Blender, go to Edit->Preferences->Add-ons->Install..., choose Easy PBR Hook zip-archive and activate plugin.

In case you don't see Easy PBR Hook in list of available add-ons, check if Community add-ons enabled and you're in Material section

 Now, in your Material Properties you have Easy PBR Hook Panel.

Basic usage:

Go to the material tab of your model, select/create a material you want to set up. Paste or select a path to the texture folder.

If you have multiple materials for one mesh and textures a stored in one folder you can use "Set Shared Path" button. Selected path will be copied to other materials of this mesh 

If there are multiple texture sets in said folder you can use the Keyword field to determine which texture set will be used.

Note: Easy PBR Hook is looking through folder file to file (not sorted) and if one texture was found, all other textures of this type will be ignored

Note: Assign Textures button is unavailable if Path field is empty but Keyword field is advanced feature and you can leave this field empty if you don't want to use it

How to use keyword:

Imagine we have a folder with these textures:

In this case, Easy PBR Hook can make some mistakes. To make it work properly you can enter keywords that will help PBR Hook find exact textures.

Note: This field is non-case sensitive

If you want to ignore some files you can add '-' in the beginning of the keyword. You can use as much ignore keywords as you want.

Note: You can add whitespace between keywords. blabla -abc and blabla-abc are the same

Possible options listed below

Note: It will be empty if it was empty before

How to use texture naming conventions:

We used our experience to collect the most popular naming conventions for every type of supported еучегкуы. If you use another style or you downloaded/bought a pack of textures with another naming convention we created a tool to easy update naming convention table.

Go to "Texture naming convention" and you will see this window:

There's a list of supported naming conventions you can modify as you wish. You can delete everything and put prefered suffixes into it, or you can just append some new words.

Note: You must separate words by comma, otherwise it can cause unexpected behaviour

When you're done you need to set "Update" mode.

You have two options here:

1. "Local" means you update naming convention table for current project only. When you will start new project, you will see default naming convention table.
2. "Global" means you overwrite a file containing a naming convention table Easy PBR Hook uses. Next time you'll start a project, texture naming convention table will contain your new conventions

Note: "Global" update calls "Local" update first automatically

Also, you have an ability to export/import your naming convention table and even go back to defaults.

When you want to Export it, you need to click "Export" button and select a folder and a filename for export. When you click "Ok" there will be a file "your_filename".json that contains all of your Local naming convention.

Note: Don't forget to update your table before exporting it

Import workflow is the same. You need to click "Import" button and select a .json file in a folder. After clicking "Ok" you will see updated naming convention table (if you shose a proper file). Import function updates your Local naming convention.

Note: Select invalid .json file may cause errors; Selecting non-json file will cause warning message

"Restoring Defaults" is a wrap on Import function so it also updates your Local naming convention.

Assigning textures and Working with Easy PBR Hook:

When you setup Path field (and Keyword field if you need to) Assign Textures button is available. This button makes all magic we worked for. Also, you will see "Simplify" checkbox. Checked state means you don't wanna tweak material parameters using math nodes. 

Note: If you will change Path or Keyword field your material will be reset. In this case you will need to click "Assign Textures" button and setup you material again

Now you can see little difference in design of the Easy PBR Hook panel so we will discuss this changes below:

• "Reload Material" button causes rebuilding of your material with same behavior as when you press "Assign Textures" button but there's a difference: it doesn't load image if it's already in a blendfile
• "Update Images" button causes only updating of already existing images. It's really helpful if all you need is just replace old textures with a new

Note: New images must have the same name as old

• "Mode" section describes the current pipeline. Here you can see which textures are used in your material. At the end of the line you can see "Automatic" that means this pipeline was created by Easy PBR Hook
• "Change Pipeline" button allows you to change pipeline (if you have not only one). When you click on this button you will see the list of available pipelines Easy PBR Hook found in your textures. Once you changed pipeline you can see "Mode" is changed to "Manual".
• "Found Textures" subpanel is a place where you can see all textures Easy PBR Hook loaded for your material using your Path, Keywords and Naming convention table. It helps you to check if all of your textures are loaded. If not - check your settings and namings.

Note: If everything seems to be OK but you still have some problems - notify me using my e-mail, describe your problem and include zip/rar-archive with your textures. I will help you and fix this bug (if it's my fault)

• "Texture Properties" subpanel gives you an ability to post-setup your material. Here you'll find an ability to tweak parameters of material depending on found textures.

This properties won't be shown if you checked "Simplify" material

• "Texture Coordinates" subpanel allows you to control coordinates of textures using "Mapping" node. This node is connected to every Image Texture node. You can change location, rotation and scale
• "Detail Map Coordinates" subpanel is the same as "Texture Coordinates" but it's connected to Detail Mask only. 
• "Opacity Mode" subpanel is shown if you have Opacity texture map in your pipeline. This subpanel can help you with setup of opacity mode. You have three options here. Default is "Opaque", and also you have "Fade" and "Cutout". Changing "Opacity mode" in this subpanel will change Opacity Mode in Principled BSDF settings so you don't need to change it manually. If you set mode to "Cutout" you will get an ability to set the value of "Alpha Threshold" parameter. If Opacity Mode is set to "Fade" you can switch Alpha Mode beetween "Straught" and "Channel Packed" and change value of "Opacity" parameter.