Relink Bitmaps


Download Relink Bitmaps v2.10

Friends, head over to the Autodesk App Store and give me an honest review please.  If you do, send me your request code and your reviewer name for a free license.  Any review, positive or negative, is valid for this offer.

As featured in 3D World – August 2011

(Self-installing .mzp file, just run this script via:  “Maxscript->Run script”)

 Note: The file when downloaded should be “Relink Bitmaps v2.##.mzp” (NOT ZIP, IExplorer makes it a Zip file)
INSTALLATION:  In 3dsMax, goto MAXScript -> Run Script, and run the file you downloaded above “Relink Bitmaps v2.##.mzp


This tool is available to the community for free, but I kindly request if you see the value in time this tool saves you, that you donate whatever you can to help me pay off student loans.  Every donation helps immensely.  I do however understand that we’re all in this mess somehow and I understand if you aren’t able to donate at this time.  To donate simply click the “Donate!” button on the script.  I am suggesting $10 for an individual, but whatever you can spare will insure the future development of this script and updates.

Tested thoroughly with (32-bit and 64-bit):   Max 9-2017

2.10 Changelog

  • Added support for FStorm Render – Bitmaps/Lights/Proxies, thanks to Nikita Gushchin!
  • Fixed the “$directory not recognized” error
  • [NEW] Option to automatically search the Max scene directory

2.09 Changelog

    • CoronaBitmap / CoronaProxy / CoronaLight support added (this didn’t get added to 2.08 even though I meant it to).
    • Changed the functionality of the read-only browse (because I didn’t like how I did it last verison)
    • Fixed the stupid error with the “RemindMe=” bug that users experienced when they pressed “Remind Me in a week”
    • Octane render is still impossible for me to support at the moment, they handled filenames strangely.  Contact them if you want support added, my forum name on their forums is colinsenner.

2.08 Changelog

  • Corona Render Fully supported
  • Browse buttons are Read-only share friendly
  • Attempted to support Octane Render, but the way they are exposing their custom map types like Image_Texture are not in line with any other plugin I’ve seen, if you want Octane support, it’d be best to contact them on their forums or email directly to help me resolve the issue, they were unhelpful when I attempted to contact them to resolve this.  My forum name on Octane forums is colinsenner.


  • All 3dsmax supported Bitmap Texture types
  • (new) Relinks Mental Ray Proxy files
  • (new) Relinks VRay Proxies (.vrmesh)
  • (new) Relinks VRayHDRI files
  • (new) Relinks IES files (including VRayIES files)
  • (new) Automatically checks for script updates and new versions
  • 250% speed increase from previous versions
  • Command-line mode available for automating repetative tasks (see documentation below)
  • Configurable default user options saving button clicks and wasted time

Just a quick thank you to Christopher Grant at Scriptspot, and the users who have shared their time and ideas (and donations) to make this script better:   brittnell, hongxu, fajar and others!

As always, thank you for everything and be well,



[FIXED version 2.10]
 $directory not recognized:  errors

A: The problem is there’s a ‘$’ token in one of your paths.  Windows allows a directory to contain a ‘$’ token like this:   c:\3d\models\couch$\couch.max.  The problem is max doesn’t allow this because it’s a reserved keyword.  The quick fix is to open the Max Asset Tracking and remove all paths (“Strip Path”) for all directories with a ‘$’ in it.  I’ll fix this next update.

Q: Every time I open 3dsmax a message saying “Relink bitmaps is now installed….”.

A: To fix your problem though: search your max root folder for “” and delete it. That should fix everything.  This is because it wasn’t installed as an .mzp file.  The script file should be named “Relink Bitmaps v#.#.mzp”. Some browsers rename .mzp to .zip (annoyingly). If you in max do Maxscript->RunScript and pick the .mzp file, it’ll install everywhere correctly.



To reset the configuration .ini file in the Listener window (Maxscript->MAXScript Listener) type and hit [enter]:


To reset the position of the Relink Bitmap’s dialog window (in case it gets stuck off screen) type:


If you want to run the function ‘sceneRelinkBitmaps’ from your script you just need to detect if two .mse files are where they should be, run the following first, then you can call sceneRelinkBitmaps without the user opening Relink Bitmaps

if doesFileExist ((getDir #userScripts)+"\\Relink Bitmaps\\C_Lib.mse") and doesFileExist ((getDir #userScripts)+"\\Relink Bitmaps\\Relink_Lib.mse") and doesFileExist ((getDir #userScripts)+"\\Relink Bitmaps\\Relink Bitmaps.mse") then ( 
   fileIn ((getDir #userScripts)+"\\Relink Bitmaps\\C_Lib.mse") quiet:true 
   fileIn ((getDir #userScripts)+"\\Relink Bitmaps\\Relink_Lib.mse") quiet:true 
   fileIn ((getDir #userScripts)+"\\Relink Bitmaps\\Relink Bitmaps.mse") quiet:true 
) else (
   MessageBox "Relink Bitmaps files are not in the default installation path.  Try reinstalling."

Relink Bitmaps has the ability to run automatically via the command line, here is the syntax:

sceneRelinkBitmaps searchArr ignoreCase:true ignoreExtension:false recursive:true undoOn:true lowMemory:false allMaps:false
/* sceneRelinkBitmaps – Relinks bitmaps in the current scene
append to returnMissingBitmaps() function for adding more kinds of assets to relink
searchArr: an array of directories to search
ignoreCase: true or false
recursive: true of false
undoOn: true or false
lowMemory: true or false
progress: progressBar link to update progress */

/* sceneRelinkBitmaps – Relinks bitmaps in the current scene
searchArr: an array of directories to search, ie. #(“C:/maps”,”D:/maps”)
ignoreCase: true or false
ignoreExtension: true or false
recursive: true of false
undoOn: true or false
lowMemory: true or false
allMaps: true or false
progress: progressBar link to update progress, will update the .value in this while it relinks */

If you’re having problems with the script run it and in the listener type:

setDebugMode on

and send me the output and what you did so I can track it down for you asap

Previous Changelogs:

New in Version 2.04

  • Added an option to Relink All Bitmaps and not just missing ones.  The checkbox “All Maps” should do the trick.
  • Fixed a bug with the licensing system, if you have requested a license in the past and it wasn’t working, please email [email protected] your new request code (Generated by clicking the “Donate!” button).  Old License files will continue to work, but they now have a new format
  • Command Line support added for “All Maps” feature (check the FAQ at the bottom for syntax)
  • The new version deletes your “Relink Bitmaps.ini” file because new features have been added to it, this is to prevent errors.  Reconfigure manually.
  • Fixed the icon not showing up properly after install (Thanks Artur)

New in Version 2.03

  • Changed the script path to use the user’s local scripts path instead of “C:\Program Files\Autodesk\3dsMax 20##\”, this should eliminate problems with needing administrator rights to install the script.
  • Added the option to ignore the file’s extension allowing you to relink .jpgs to .tifs with ease.  Note: it will use whichever one it finds first.
  • Corrected a bug with the “Find” button which would induce a crash if it was clicked with nothing in it.

New in Version 2.02

  • Added a user requested option to delete all missing maps in a scene
  • Fixed a bug with find a material producing an error

Older Versions:

Relink Bitmaps 2.0
Relink Bitmaps 2.01
Relink Bitmaps 2.02
Relink Bitmaps 2.03
Relink Bitmaps 2.04
Relink Bitmaps 2.05
Relink Bitmaps 2.06
Relink Bitmaps 2.07
Relink Bitmaps 2.08
Relink Bitmaps 2.09



287 thoughts on “Relink Bitmaps

  1. ohtary

    Привет, Коллин! Версия 2.07 работала как надо: открывалась именно та папка, где лежат текстуры. А версия 2.08 открывает всего лишь обзор папок. И надо самостоятельно искать папку с текстурами объекта. Что случилось? Неудобно теперь.

  2. Stephen Sherry

    For the shortcuts to be viewable when you browse for folders yes.

    Also would it be possible to add ‘Delete all missing bitmaps’ to the commandline?

    Thanks in advance.

  3. Loriano

    Hello Colin,
    great and useful, scripts!
    It is possible to add an option to search and replace part of the existing path.
    original link “\\NAS\nas\a_textures\……..”

    replace with:\\K:\a_Texture\


  4. Alberto

    Hello Colin,
    I noticed that the script does not detect files with an extension to uppercase.
    For example .jpg is ok, but .JPG not working.
    Can you implement a solution?

    Thanks, great job

  5. Colin Post author

    Make sure you have “Ignore Case” on. Also: “Ignore extension” would fix this problem as well :). Cheers!

  6. Shekhar

    2.8 is not suporting Corona IES. It doesn’t show missing IES files in the right side window.

    After the file is fixed manually and when computer is changed to a different location, using RB doesn’t reapply the CORONA IES. It leaves as “missing file”. Can you please fix this please.

    Working with Max 2016, Vray 3 and Corona 1.1

  7. Nico

    The Script does not seem to work with the “CoronaBitmap”
    Is it possible to fix this, or am I doing something wrong?

    All the best

  8. Cracanel

    Hello, I just upgraded to version 2.09 and every time i want to relink missing bitmaps, i get this error :
    I mention i did not have this problem with the previous versions. I`ll downgrade until new solutions or updates. Anyway thanks for the wonderful job you are doing.

  9. Julian

    I have the same issue as Joe!

    every time I start max i get 2 messages saying:
    “Relink bitmaps is now installed,….”

    annoying. Any fix for this?

  10. Alex

    Please make re-sizable windows for your script. I have very long file paths and I cannot see it. What makes this script useless to me.

  11. Marco

    hi colin,

    i have many problems with 2.09

    very often the message “directory not recognized” appears. With 2.08 everything works like a charm.

  12. Greg

    Hey Colin

    Great script that a buddy of mine told me about. It seems to work pretty good as I am getting into it. However I notice that I have a few files here that are “missing” in asset tracker but the script is not picking them up.

    Any suggestions? I can send you the screen capture so you can see it.

  13. Rowan

    Hey Colin, love your script, thanks so much for sharing. Quick feature request, could there be a quick button to search the directory in the clipboard? Would save going to “browse” copying all, and pasting then hitting ok and “relink” and just make it a bit smoother.


  14. Pingback: 16 3ds Max plugins you should probably download | 3D Artist - Animation, Models, Inspiration & Advice | 3DArtist Magazine

  15. Pingback: Missing Assets | Indrazulfi

  16. Pingback: 16 plugins for 3ds max you should download |

  17. Rémi

    Hey, thanks again for this great script 😉
    Would it be possible to implement something like an exclusion tag we can add at the end of subfolder names so the script doesn’t browse for maps in them?

    I’d like to use optimized maps for rendering but would like to keep the original files in a subfolder to modify them if needed, so I don’t want the script to link to the big files instead of the reduced ones.


  18. Lnio

    I keep getting the error –

    >> MAXScript Rollout Handler Exception:
    — Runtime error: $directory not recognized: $(kgrhqn,!psfcu84pyw8bqyszbzctg~~60_57.jpg <<

    3ds max 2014


  19. negativesleep

    Awesome script! I’m having some issues getting it to batch using the batchitmax script. Can you provide any insight into how that works?

  20. Sergiu

    Luis, I second that request. Had the same problem recently with the server not accepting D:/network path

    Would be nice to read some advice on this. Had to do all the relinking manually through asset tracking

  21. Victor

    — Runtime error $directory not recognized: $_86.JPG
    All bitmaps except those that are on my W:\ harddrive get this problem.

  22. hrvoje sedlic


    I am using your Relink script for more then a year and all of a sudden I can`t load it. I press the button, but nothing. I have deleted the macro and installed it again, but no luck. Any idea? 3dsmax 2016.

  23. KM

    Hi guys/ Colin,

    I don’t know if there was already a fix for this, but I get a double pop up when I start MAX that notifies that relink bitmaps is installed and how to enable the plugin.
    (mentioned before above by: “Julian says: September 25, 2015 at 7:58 am”)

    It stops MAX from loading the scene, until after I click OK for both the pop-ups.

    Thanks in advance.

  24. shawn mitford

    Hi, i am using the relink missing bitmaps plugin on a huge scene and it cant seem to find alot of bitmaps that are missing but it shows they are missing at file startup and in asset tracker, any idea why so?

  25. Mike

    Hi, great app. its exactly what i need.
    Although one downside is it doesn’t seem to locate autodesk material bitmaps. Which is the main reason we need this script.

  26. John

    I too am receiving the “Runtime error $directory not recognized” error. What is the solution to it please?

  27. Pingback: Render Node Part II – Network, 3ds Max & Backburner – Ikonoform

  28. Pingback: Render Node Part III – Best Practices & Usage – Ikonoform

Leave a Reply

Your email address will not be published. Required fields are marked *