MaxScript Tests

This repo mainly focuses on the workflow setup for 3ds Max and Visual Studio Code. The MaxScripts are just used for testing various capabilities of 3ds Max. Because 3ds Max runs only on Windows following documentation is for Windows only.

Requirements

Besides 3ds Max please download/install:

1. Visual Studio Code
2. Dot Net SDK
3. Language MaxScript * Optional

Setup

1. Clone the repo and store it on your hard drive
2. Open folder (this cloned repo) from VS Code
3. Open any file and run Tasks: Run Task (Ctrl+Shift+P) > Build Release. The Terminal will open and the build will start. Wait for it to finish.
4. Copy the initialize_COM_server.ms MaxScript file into the 3ds Max startup scripts folder. The default for that is: %localappdata%\autodesk\3dsmax\scripts\startup

Executing scripts

From the VS Code select Tasks: Run Task (Ctrl+Shift+P) > Execute Script in 3ds Max.

Distributing scripts

For the script distribution it is required to have:

1. Node.js
2. Gulp.js

If Node.js is installed go to the project root folder and install all dependencies for the project by typing the following command inside the Terminal:

npm install

To start the build process make sure that you are in the project root folder and then type the following command inside the Terminal:

gulp

or just double-click the distributeProject.bat file.

The gulpfile.js and encryptScript.ms files are already configured to automatically encrypt all scripts that are stored inside the src folder and deliver them into the dist folder when the build process is complete.

Note: If there is an error with the command line "3dsmax is not recognized as internal or external command" you would need to add the environment variable. To fix this please follow these steps:

1. Open the Start Search, type in "env", and choose "Edit the system environment variables".
2. Click the Environment Variables… button.

3. Under the User Variables find and select the Path variable.

4. Click the Edit button.

5. When new window opens click the New button.

6. Type the path of the 3ds root folder, typically: "c:\Program Files\Autodesk\3ds Max version number". This path will depend on which 3ds max version is installed.

List of MaxScripts

• Curbs
• Enable/Disable
• Delete Empty Layers
• My Rollout
• Select Valid Groups