This repo contains various Python programming examples and tutorials targeting 3ds Max.
All the examples in the tutorials are implemented as pip packages. This is a bit heavy for small things (we provide a setup.py, a LICENSE and everything) but makes things installable and shareable more easily. As soon as something has dependencies on external packages or requires more than one Python file, pip packages become very convenient. Because we think it is a good practice to package 3ds Max Python tools with pip, we provide all our examples in this form.
It is not necessary to install the HowTos: the repo can simply be used as a passive directory of samples and documentation for Python developers.
- Installing the HowTos will add menu items to 3ds Max, and is documented here
- After an update from github it is necessary to rerun install scripts to get everything working as expected
- New with 3dsMax 2025: Plugin Packages in 2025 and Integration With the New Menu System
The samples below are translations of MAXScript How Tos that can be found in the 3ds Max online documentation.
The conversion from MaxScript to Python could have been more mechanical but we chose to implement the Python version in the best Python way known to us. An example of this is that we use PySide (Qt) for the UI as much as possible instead of using more traditional 3ds Max ui mechanisms.
How To?
- Develop a Transform Lock Script transformlock
- Remove all materials removeallmaterials
- Quickly rename selected objects renameselected
- Output Object Data to File speedsheet
- Create a quick video preview quickpreview
- Access the Z-Depth Channel zdepthchannel
- Update a progressbar from a Python thread threadprogressbar
- Create a single instance modal dialog singleinstancedlg
- Add menu items to open documentation pages in the web browser inbrowserhelp
- Integrate a Python Console pyconsole
- Run code on thre main thread mxthread
- Automatically convert maxscript to python mxs2py
- Use socketio from 3dsMax socketioclient
- Drop maxscript code on a rich text window to get a python translation mxstranslate
Python samples can be found in src/samples. These samples may already be in your 3ds Max installation directories.
pystartup provides the maxscript code that, when copied to 3ds Max's startup directory, will automatically launch pip packages with the 3dsMax startup entry point.
The following packages are not really examples but Python tools.
-
menuhook is not meant to be an example (but is still interesting as such!) but as a way of attaching Python functions to 3ds Max menu items. The menuhook package is used by most of the other samples.
-
realoadmod is small tool that will reload all development modules in one operation
-
mxvscode is a small tool that will automatically import debugpy (the VSCode debugging interface) during the startup of 3ds Max and make it accept remote connections. This may slow down the startup of 3ds Max quite a bit and is meant as a developer-only tool.
- install.sh will install pip, install pystartup and pip install all the samples
- uninstall.sh will uninstall what was installed with install.sh
- installstartup.sh will install pip and pystartup and nothing more
- installhowtos.sh will install only the howtos (works in a virtual env)
- checks.sh runs pylint on the code, validates that 3ds Max is named properly, validates that code blocks in markdown always specify the programming language, checks that all links are valid in all markdown files of the repo
- create.sh will generate an empty pip package in the current working directory.