MAXScript Preferences

On the MAXScript panel of the Preference Settings dialog, you set MAXScript and Macro Recorder preferences, enable or disable auto-loading of scripts, set the initial heap size, change font style and size used in the MAXScript editor, and manage all the settings for the Macro Recorder.

Standard menu: Customize menu > Preferences > Preference Settings dialog > MAXScript tab
Enhanced menu: Customize menu > Customization > Preferences > Preference Settings dialog > MAXScript tab

You can also change these settings by editing the [MAXScript] section of the 3dsmax.ini file.

Note: Two paths to support auto-startup scripts are on the Configure User Paths dialog and Configure System Paths dialog: ..\scripts and ..\scripts\startup . If you prefer to start scripts from a different directory, you can change these default directories with the corresponding Customize menu commands.

Choose Help MAXScript Help for details on MAXScript.

Interface

Startup group

You can start scripts automatically in two ways. You can create a file named startup.ms that contains your startup code. MAXScript searches for this file in the scripts directory first, then the 3ds Max root directory, and finally the directories specified in the Windows PATH environment variable. MAXScript stops searching after it finds the first occurrence of startup.ms.

You can also place the script files you want auto-loaded into the \startup directory inside the \scripts directory. MAXScript loads any script file with the file name extension .ms or any encrypted script file with file name extension .mse.

If you have both a startup.ms file and auto-load files in the \startup directory, MAXScript always loads startup.ms first.

Load Startup Scripts: Loads scripts automatically when 3ds Max starts.
Load/Save Scene Scripts: Enables Scene Script loading and saving.
Load/Save Persistent Globals: Enables load and save Persistent Globals.
MAXScript supports a limited form of variables. You declare that a particular global is persistent and the value it contains is always saved to and restored from scene files as they are opened and closed. In this way you can, for example, keep direct references to objects in the scene in variables. Those references will move across scene save and reload.

MAXScript Windows group

Font drop-down list: Choose a font for the MAXScript editor
Font size: Choose a font size for the MAXScript editor.
Auto Open Listener On Output: Opens the Listener if a script sends output to a WindowStream value with no associated window. This would require a MAXScript extension.
Show Path in Editors: When on and editing a script, the script window title bar shows the file name and entire file path. When off, the title bar shows the script file name only.

Runtime group

Use Fast Node Name Lookup

When on, MAXScript indexes scene node names in a cache, resulting in significantly faster resolution of non-wildcard pathname values (for example, $box01) to node values. When off, the scene nodes are enumerated as MAXScript looks for a scene node name that matches the pathname, resulting in slower lookups.

Turn this off if you encounter an incompatibility with an existing script.

Validate Resource File Values

When on and MAXScript reads key/value pairs in a resource (RES) file, it verifies that the value portion is a valid MAXScript value. Enable this switch if you are converting an existing script to use resource files, to verify that the resource file appears to be good.

When off, whatever is specified in the resource file as the value is used in the script. If the resource file contains bad values, you can end up with weird parsing errors that are difficult to figure out.

Once you're finished setting up the resource file, turn this option off. At this point you know the file is good and have finished editing the file, so there's no need to take time validating the file.

Memory group

Initial Heap Allocation (Mbytes): Sets the initial heap allocation.
MAXScript carves its own working memory (called a heap) out of the memory that 3ds Max allocates. You can add to the heap at any time by increasing the value here.

Macro Recorder

Controls in this large group are for recording macros. See Macro Recorder.

Enable Macro Recorder

Enables the Macro Recorder.

3ds Max starts with the macro recorder disabled and a minimized Macro-Recorder pane in the MAXScript listener window.

You can also enable the Macro Recorder by turning on MAXScript Macro Recorder or by turning on Enable in the Macro Recorder menu on the MAXScript Listener toolbar.

This state is stored in the 3dsmax.ini file. Turning it on once keeps it enabled across restarts of 3ds Max.

Code Filters group

Command Panel Switchings: Displays command panel switchings in the code.
Tool Selections: Displays tool selection in the code.
Menu Item Selections: Displays menu selection in the code.

Code Generation group

The Code Generation parameters refer to whether or not the script emitted is made selection-relative, if possible, or if it contains object references. By making the script selection-relative, you can apply the recorded script to a different selection, thereby making it more general. Absolute mode always works on the same objects regardless of the current selection.

Explicit Scene Object Names: Uses scene object names in the code.
Selection-relative Scene Object Names: Makes Scene Object Names relative in the code. Default=on.
Explicit Sub-object Sets: Uses explicit sub-object sets in the code.
Selection-relative Sub-object Sets: Uses selection relative sub-object sets in the code. Default=on.
Absolute Transform Assignments: Uses absolute transforms in the code.
Relative Transform Operations: Uses selection relative transform operations in the code.