- add the unify asset duplicates script

mamoniem · mamoniem · commit ac1a10fe7656 · 2019-01-24T19:21:31.000+08:00
- update the README file
diff --git a/Assets/UnifyAssetDuplicates.py b/Assets/UnifyAssetDuplicates.py
@@ -0,0 +1,62 @@
+#										_
+#									   (_)
+#  _ __ ___   __ _ _ __ ___   ___  _ __  _  ___ _ __ ___
+# | '_ ` _ \ / _` | '_ ` _ \ / _ \| '_ \| |/ _ \ '_ ` _ \
+# | | | | | | (_| | | | | | | (_) | | | | |  __/ | | | | |
+# |_| |_| |_|\__,_|_| |_| |_|\___/|_| |_|_|\___|_| |_| |_|
+#					www.mamoniem.com
+#					  www.ue4u.xyz
+#Copyright 2019 Muhammad A.Moniem (@_mamoniem). All Rights Reserved.
+#
+
+import unreal
+
+workingPath = "/Game/"
+
+@unreal.uclass()
+class EditorUtil(unreal.GlobalEditorUtilityBase):
+    pass
+
+@unreal.uclass()
+class GetEditorAssetLibrary(unreal.EditorAssetLibrary):
+    pass
+
+editorUtil = EditorUtil()
+editorAssetLib = GetEditorAssetLibrary()
+
+selectedAssets = editorUtil.get_selected_assets()
+selectedAsset = selectedAssets[0]
+
+selectedAssetName = selectedAsset.get_name()
+selectedAssetPath = selectedAsset.get_path_name()
+
+allAssets = editorAssetLib.list_assets(workingPath, True, False)
+allAssetsCount = len(allAssets)
+
+assetsMatching = []
+
+with unreal.ScopedSlowTask(allAssetsCount, selectedAssetPath) as slowTask:
+    slowTask.make_dialog(True)
+    for asset in allAssets:
+        _assetData = editorAssetLib.find_asset_data(asset)
+        _assetName = _assetData.get_asset().get_name()
+
+        if (_assetName == selectedAssetName):
+            if (asset != selectedAssetPath):
+                print ">>> There is a duplicate found for the asset %s located at %s" % (_assetName, asset)
+                _assetLoaded = editorAssetLib.load_asset(asset)
+                assetsMatching.append(_assetData.get_asset())
+        if slowTask.should_cancel():
+            break
+        slowTask.enter_progress_frame(1, asset)
+
+
+if (len(assetsMatching) != 0):
+    editorAssetLib.consolidate_assets(selectedAsset, assetsMatching)
+    print ">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>"
+    print ">>> The unifing process completed for %d assets" % len(assetsMatching)
+    print ">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>"
+else:
+    print ">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>"
+    print ">>> There were no duplicates found for the selected asset"
+    print ">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>"
diff --git a/README.md b/README.md
@@ -20,6 +20,7 @@ Don't forget to follow this repo, [YouTube](http://www.youtube.com/channel/UCBBc
 
 - **[ReportUnusedAssets.py](https://github.com/mamoniem/UnrealEditorPythonScripts/blob/master/Assets/ReportUnusedAssets.py)** Running this script will look through all the project folders, and add to the log the assets that were found not in a use, or in another word, the assets that have no dependency with any other project files.
 - **[DeleteUnusedAssets.py](https://github.com/mamoniem/UnrealEditorPythonScripts/blob/master/Assets/DeleteUnusedAssets.py)** Running this script will look through all the project folders, and delete the assets that were found not in a use, or in another word, the assets that have no dependency with any other project files. Note that, running this script won't show a confirmation message or accepting dialogue box, it will force delete the assets right a way, so make sure to evaluate the change before submitting to your repo.
+- **[UnifyAssetDuplicates.py](https://github.com/mamoniem/UnrealEditorPythonScripts/blob/master/Assets/UnifyAssetDuplicates.py)** Run on a selected single asset in order to look through the project for similar assets with the same name, and will remove all of them, and replace all their references with the selected one. This is a very common case if for example have added several packs or assets to the project and you will end up with several files (textures, materials or such) that have the same exact name and parameters *(add Paragon characters for example to a single project could result that)*, but a unique version coming from each imported pack; and there it come the usage of that script in unifying them.
 
 ## Materials ##
 - **[CreateInstancesOfSelectedMaterial.py](https://github.com/mamoniem/UnrealEditorPythonScripts/blob/master/Materials/CreateInstancesOfSelectedMaterial.py)** Run on a selected single or multiple Material file(s) in order to generate material instances of it/them. The number of the final generated instances count can be set within the script before running, by changing the value of the variable *totalRequiredInstances*
