Quixel Bridge and 3ds Max Assistant

[Mohammadreza Mohseni]

Resolve Quixel Bridge and 3ds Max Connection Issues with MaxBridge Assistant

Hi everyone,

If you've been facing issues connecting Quixel Bridge with the newer versions of 3ds Max (2024, 2025), you're not alone. These problems stem from compatibility gaps in the official plugin, particularly with 3ds Max 2025's updated Python API and menu creation methods.

To help, I've created MaxBridge Assistant – a small, open-source tool designed to make fixing these issues as simple as possible. All the code is available for review on GitHub. The app is portable, easy to use, and automates what would otherwise be a tedious manual process.

What the Assistant Does:
Ensures compatibility for 3ds Max 2025 while supporting older versions.
Updates necessary files automatically without manual edits.
Replaces outdated components in Quixel Bridge with updated ones.

How to Use:

1️⃣ Download the app (no installation required).
2️⃣ Select your Megascans Library Folder.
3️⃣ Choose the 3ds Max versions you want to connect.
4️⃣ Click "Start Setup" and let the app handle everything!

For those who prefer full control, I've also included clear manual instructions in the GitHub repository.

👉 Learn More and Get the Tool Here
​https://github.com/mohseni-mr/MaxBridge-Assistant

Open Source and Community Support

This project is entirely open source, so feel free to explore, review, or modify the code to suit your needs. If you find it useful, I’d really appreciate it if you could give the repository a ⭐ on GitHub – it helps others discover the solution and keeps the community strong.

​Here’s a quick look at the app:


I hope this helps save you time and frustration. If you run into any issues or have suggestions, feel free to reach out. Let’s keep our workflows smooth and productive! 😊

[romullus]

Thank you for this tool, i'm sure many will appreciate it! I wonder if it could help with situation when user has few different Max versions installed and Bridge is exporting to a wrong one? I had this issue myself and i remember having quite a trouble fixing it on my own.

[Mohammadreza Mohseni]

Thank you for this tool, i'm sure many will appreciate it! I wonder if it could help with situation when user has few different Max versions installed and Bridge is exporting to a wrong one? I had this issue myself and i remember having quite a trouble fixing it on my own.

you are welcome,

I did not specifially test this but i test it with 3ds max 2025 / 2024 / 2022 and 2021 on one system and all worked fine. but i did not test with opening multiple instance of 3ds Max to check this. give the api quixel use with one port, it is very likely this would happen if multiple instance of diffrent version are being open at same time. but it is possible to set diffrent ports for diffrent version of 3ds max to fix this. i did not do that in my provided solution yet (I did not aware of this till you mentioned it, I always use one version) but I will surely look into to it and if could solve it i will provide an update soon.

[romullus]

To be clear, i'm not asking about situation when several different version Max instances are opened - i wouldn't reasonably expect that to work reliably. I have Max 2023 and 2024 on my PC and i want to have Bridge plugin on 2024, since that's the version i'm working with most of the time, but the Bridge installed it only on Max 2023 and there was no easy way to make it like i want. If your tool can handle this situation already, that's all that i need. I didn't tested your tool yet, since i have my issue sorted, but i certainly keeping it for the future because it doesn't look that Quixel is willing to pull their finger out of their ass anytime soon.

[arqrenderz]

LEGEND !!
Many thx from the it department :)
It department and artist roles as usual in a small company :)

[Mohammadreza Mohseni]

To be clear, i'm not asking about situation when several different version Max instances are opened - i wouldn't reasonably expect that to work reliably. I have Max 2023 and 2024 on my PC and i want to have Bridge plugin on 2024, since that's the version i'm working with most of the time, but the Bridge installed it only on Max 2023 and there was no easy way to make it like i want. If your tool can handle this situation already, that's all that i need. I didn't tested your tool yet, since i have my issue sorted, but i certainly keeping it for the future because it doesn't look that Quixel is willing to pull their finger out of their ass anytime soon.

I have updated the app to ensure this sitution well handled. the app remove the connection for any version that you did not select on the app and install only for thoes you select.

[Mohammadreza Mohseni]

LEGEND !!
Many thx from the it department :)
It department and artist roles as usual in a small company :)

you are welcome.
usually the IT guy can not fix this kind of headaches. so the artist would need to step-up in many situations 😉

[romullus]

To be clear, i'm not asking about situation when several different version Max instances are opened - i wouldn't reasonably expect that to work reliably. I have Max 2023 and 2024 on my PC and i want to have Bridge plugin on 2024, since that's the version i'm working with most of the time, but the Bridge installed it only on Max 2023 and there was no easy way to make it like i want. If your tool can handle this situation already, that's all that i need. I didn't tested your tool yet, since i have my issue sorted, but i certainly keeping it for the future because it doesn't look that Quixel is willing to pull their finger out of their ass anytime soon.

I have updated the app to ensure this sitution well handled. the app remove the connection for any version that you did not select on the app and install only for thoes you select.

Wow, super! Thank you very much!!

[Mohammadreza Mohseni]

​

MaxBridge Assistant v2.0 Released: Major Improvements, PyQt6 Migration, Thread Management Enhancements, and More!​

Hello everyone!
after checking out the issue that pointed out about the 3ds Max problem with windows 11 24h2 and read Changsoo Eun post about it (thanks M.Max for the link), I've update the code significantlly, and use fixing attributes on %localappdata% and many other changes to improve the app. and now it should fix it all.
at least I hope

new update (v2) can be downlaoded from the same link
DOWNLOAD

first post is also valid

Here’s a rundown of the key updates in MaxBridge Assistant v2.0:​
1. Migration to PyQt6
upgraded from PyQt5 to PyQt6, unlocking new features and ensuring better compatibility with modern Python versions.
PyQt6 introduces performance improvements and resolves several issues that were present in the older version, providing a smoother experience.

2. Improved Thread Management
The thread management system has been refactored for better efficiency and stability. I’ve transitioned from a basic QThread model to a more modular approach using QThreadPool and QRunnable.
This allows for better handling of multiple concurrent downloads without impacting the UI performance.

3. Enhanced File and Library Handling
Better file extraction and replacement logic ensures smoother handling of files during the library preparation process.
Files are only redownloaded if necessary, using hash checks to avoid unnecessary re-downloads.
Folder cleanup is now properly handled, preventing old files from causing conflicts.

4. UI and UX Improvements
The user interface has been optimized for better performance and responsiveness, particularly when dealing with high-DPI screens.
The maximize button has been disabled for consistency, ensuring the window size remains fixed and prevents accidental resizing.

5. Local AppData Attribute Checking
AppData folder attributes are now checked and corrected as the first step in the preparation process. This ensures that the folder and file attributes are set correctly, preventing potential issues with permissions.

6. Logic and Error Handling Refinements
I’ve made several improvements in error handling throughout the application, with more detailed logs and better user feedback.
The logic for preparation is now clearer, and the flow is more structured to ensure everything is handled sequentially.

7. New Version Structure
The project now includes both the original version (MaxBridge_Assistant.py) and the new version (MaxBridge_Assistant_v2.py), allowing users to continue using the old version if needed while transitioning to the updated codebase.

8. Bug Fixes and Minor Improvements
Various bugs have been fixed, and several performance optimizations have been made to ensure a smoother experience across all tasks.
​​​

[octavtirziu]

Hi, the download is marked as a virus and deleted by both chrome and edge. Any idea why?

[Mohammadreza Mohseni]

Hi, the download is marked as a virus and deleted by both chrome and edge. Any idea why?

it may cause by nuitka compiling python to exe, because i do not have code signing certificate (as many open-source dev do not have).
the code is open you can directly run the app if you wish using python or compile it yourself you can find compile command on app folder (a bat file)
if you wish to directly run it with python use this:
download the app folder content
go to app directory where there is "requirements_v2.txt" file.
then type cmd in windows explorer addressbar and enter.
then type
pip install -r requirements_v2.txt
after the installation complete (may be take few seconds) run the following command to execute the app:
python MaxBridge_Assistant_v2.py


if you do not want to do it this way. i also provided a manual instruction on github link that tell you which file should goes where it is really easy that way too. just a couple of file copying.
"MANUAL FIX"