2025-07-01

2026-03-17 14:30:01 -06:00
parent f9a22056dd
commit 62b5978595
4579 changed files with 1257472 additions and 0 deletions
@@ -0,0 +1,51 @@
+# Raincloud's Bulk Scene Tools
+
+A couple Blender tools to help me automate some tedious tasks in scene optimization.
+
+## Features
+
+- Bulk Data Remap
+- Bulk Viewport Display
+- Automatic update checking and one-click updates from GitHub releases
+
+Officially supports Blender 4.4.1, but may still work on older versions.
+
+## Installation
+
+1. Download the addon (zip file)
+2. In Blender, go to Edit > Preferences > Add-ons
+3. Click "Install..." and select the downloaded zip file, or click and drag if it allows.
+4. Ensure addon is enabled.
+
+## Usage
+
+1. Open blender file/scene to optimize
+2. Open side panel > Edit tab > Bulk Scene Tools
+3. Data remapper: Select data types to remap. Currently supports Images, Materials, and Fonts. Select to exclude data type from remapping.
+4. View amount of duplicates and use the dropdown menus to select which duplicate groups to exclude from remapping.
+5. Remap. This action is undo-able!
+6. If remapping has successfully remapped to your liking, Purge Unused Data so that the Viewport Display function has less materials to calculate, unless you are applying it only to selected objects.
+7. Recommend activating Solid viewport shading mode so you can see what the Material Viewport function is doing. Change color from Material to Texture if you prefer; the function should find the diffuse texture if one exists.
+8. Apply material calculation to selected objects if preferred.
+9. Manually set display color for objects that couldn't be calculated, or weren't calculated to your preference.
+
+## Workflow for unpacking and organizing all textures
+
+1. Pack all images (File > external data > pack resources, or BST > Bulk Path Management > Workflow > Pack)
+2. Rename all image (datablocks) as preferred (can be easily done within the Bulk Operations dropdown, but I also recommend the Simple Renaming extension available from the Blender community)
+3. Remap all image paths as preferred (Bulk Operations)
+4. Bulk Path Management > Save All (If selected, will save selected, if none are selected, will save all images in file)
+5. Remove pack
+
+### Updating the addon
+
+The addon will automatically check for updates when Blender starts. You can also:
+
+1. Go to Edit > Preferences > Add-ons
+2. Find "Raincloud's Bulk Scene Tools" in the list
+3. In the addon preferences, click "Check Now" to check for updates
+4. If an update is available, click "Install Update" to download and install it
+
+## Author
+
+- **RaincloudTheDragon**