Replaces a selection of objects with a new object, or randomly from a set of objects.
Run the UI version of the script. Select some objects you want replaced. Set the script to "Single Object" Replacer Type, click the "Pick The Obj To Replace With" button. Click the object you want the other objects to be replaced with. Now that object's name appears as your Single Object Replacer. Hit "Do" and your selected objects will be replaced by that object. Choose "SelectionSet" instead of Single Object and choose a Selection set from the list (assuming you already have some selection sets in your scene), hit "Do" and your current selection will be randomly replaced by an object from your chosen Selection Set.
v 1.01 Added ability to retain the parent of the objects you're replacing.
v 1.02 Fixed a few issues that may stop objects from aligning properly.
v 1.03 Now if you select a group as your replacer, the script won't wig out.
v 1.04 You can now copy the selectionsets and layers of your objects.
v 1.05 Fixed a bug I introduced last version that stopped the selection set function from working.
v 1.06 Added a new mode to select multiple items.
v 1.07 Fixed a bug when trying to remove objects from a blank replacer list.
v 1.08 Replaced the Close button with a Help button. Use the X button to Close the Floater.
v 1.09 Now retains child info as well.
v 1.10 Now retains Display Properties.
SoulburnScripts is a collection of scripts that I've written for my personal artwork at home. Some of their concepts are based on scripts I wrote during my time at Blur Studio and released publically as BlurScripts (however the SoulburnScripts have been completely rewritten from scratch, giving them more features and better functionality), others are totally new concepts. Thanks to the blur folk for giving me the inspiration to learn how to code.
Feel free to install and use these scripts, however, I can't be held responsible for any problems that arise from their use. I will try and fix bugs or add features that people want, but I have limited free time and so can only promise to do my best. Thanks.
All the scripts come packaged into a single zip file of interconnected scripts, SoulCollection_v0xx.zip, which includes all the scripts in the rest of the table below. Please download the most recent zip file only, and extract then into your 3dsmax root directory, for example, c:\3dsmax. Make sure you have recurse subdirectories on (it's also called "Use Folder Names" in more recent copies of winzip). The zip will then install a bunch of files and directories...
* c:\3dsmax\help\SoulburnScriptsTutorials.txt: Quick tutorials for the scripts.
* c:\3dsmax\scripts\SoulburnScripts\images: This contains images required by the scripts.
* c:\3dsmax\scripts\SoulburnScripts\lib: This contains libraries of functions required by the scripts.
* c:\3dsmax\scripts\SoulburnScripts\presets: This contains presets for the scripts, which you can save by hitting the "SaveDef" button on any of the UI versions of the scripts. Don't edit any of these files unless you know what you're doing.
* c:\3dsmax\scripts\SoulburnScripts\scripts: The scripts.
* c:\3dsmax\ui\icons: Adds a bunch of icons, they all start with the word "SoulburnScripts_".
* c:\3dsmax\ui\macroscripts: the SoulburnScripts.mcr file.
To uninstall the scripts, just delete all the files mentioned above. To install a new collection, just download the new zip and unzip them again into your 3dsmax directory, saying overwrite current files. Check the "Files To Delete" section below for a list of legacy files that you can safely delete from old installs.
For quick tutorials on how to run these scripts, read the SoulburnScriptsTutorials.txt file in your 3dsmax Help directory.
All of these scripts are run as macroscripts, ie, as buttons, keyboard shortcuts, quad menus, etc, just go to Customize, Customize User Interface, category SoulburnScripts. The SoulburnScripts CANNOT be run by choosinng the "MAXScript" menu and "Run Script" and then a script. You can also use the macroscript called "soulburnScriptsLister" to run any SoulburnScript. All scripts can be run in one of three modes...
* UI Mode. Which brings up a user interface floater that lets you modify parameters before running the script.
* Default Mode. Runs the script using the current default values. To change the default values, open the script first in UI mode, modify the values, hit "SaveDef" to save the defaults, then close and run the script in default mode. Also, if you run any of these scripts as a quad menu, it'll let you access the UI mode by clicking on the mouse icon (with dark click button).
* Argument Mode. This is for maxscripters only, it lets you run the script by supplying it with your own set of values. This lets you integrate these tools into your own tools, or to bypass the default system.
If you encounter any bugs running these scripts, perform the following checklist...
* Try deleting any preset you may have for the malfunctioning script from your c:\3dsmax\scripts\SoulburnScripts\presets directory
* Open the script in question in a text editor and look under the "Known Issues" section to make sure your bug isn't already mentionned as something I'm aware of
* Email me and give me a list of specific steps to reproduce the bug. I'll get back to you as soon as physically possible.
Files To Delete
If you've installed previous SoulCollections, and are now installing a new one, you may wish to check to make sure all of the following previous SoulburnScripts files have been deleted (all assuming your 3dsmax directory is c:\3dsmax)...