Nightshade UV Editor 2.0.7 (maya script)

Nightshade UV Editor offers extended utility to Maya's native UV Texture Editor

Screenshot_one_2 Zoom

License Type:


File ID:


File Size:

4 MB

Created / Updated:

Sep 11, 2012 / Oct 24, 2015


Martin Dahlin   More free downloads from this user See users marketplace items See this users portfolio Send a Private Message


mac, windows




2012, 2013, 2014, 2015, 2016


Align, Stack, Nightshade, snapshot, td, gather, Layout, mapping, normalize, UVTextureEditor, unfold, stitch, match, straighten, randomize, distribute, orient, editor, uv

:: ABOUT ::

Nightshade UV Editor extends the default functionality of Maya's native UV Texture Editor by adding scripts that greatly speed up the time it takes doing UV-related work.

:: LATEST ::


Hotfix applied:
-Fixed a really nasty bug which caused Orient Shells to often fail when orienting shells.


-NSUV is now split up into a free version and a pro version! A license for NSUV Pro is now required for professional (commercial) use.
-New UI: The UI has been updated with a new, more logical layout.
-4K resolution support added. UI and icons scale accordingly to the UI-scale setting under Maya's preferences.
-New feature: Distribute shells. Distribute shells side-by-side with or without spacing, or towards a target.
-New feature: UV Set Order Manager. Manually set the primary, secondary, n:th UV set.
-New feature: Fetch Texel Density (from face selction). Value is pasted into the TD/units field.
-New feature: Cycle the pivot position of the selected shell(s) through the bounding box corners.
-New feature: Cycle the pivot position of the selected shell(s) through the UV range corners.
-New feature: Calculate angle. Gets the angle of two selected UV's by calculating the inverse tangent.
-New: Relative Rotate. Right-clicking the rotate buttons will rotate shells around their own pivot points.
-New: Added a NSUV menu at the top which contains things like an FAQ, tips/tricks and a basic workflow guide. A must-read for aspiring 3D Artists!
-New: Faster and more intelligent startup script.
-Creating a shelf button can now be done automagically via the NSUV menu.
-The function createShells() has been optimized and is now approx 200 times faster!! Affects all heavy-work tools in NSUV!
-Additionally, orientShells() has been optimized and is now an additional 15 times faster on top of that.
-It is now possible to lock the NSUV window size (lock icon - bottom right corner).
-Unitize UV's has been added as a button to the UI under the Arrange frame.
-Pre-processing of shells no longer runs multiple times when stacking or aligning shells.
-Match UV's now properly counts down instead of up.
-Straighten UV's no longer fails when only one UV edge loop is selected.
-Fixed Gather Shells not working on a UV selection.
-Fixed an issue with Pixels/Units (under Texel Density) only using one decimal when calculating the TD.
-Marking menu has been tweaked. Smooth UV's is back where it always has been!
-All display toggles (shaded view, shell borders, etc) are now stored between sessions in NSUV.
-Normalize UV's now works on any selection (mesh, face, edge, vertex, uv).
-Fixed a selection issue with the feature "Select Unmapped Faces".
-Fixed a bug with the Orient shells -UI.
-Fixed a bug with the Create UV Set -feature.
-The pinning and iteration options under Unfold UV's are now applied to the Unfold U/V button as well
-Improved readability for the Calculate Pixel Distance UI.
-The Find Unmapped Faces -icon has been moved to the Project UV's -group.
-The Find Unmapped Faces now has a proper selection check as well as a dialog when no unmapped faces was found.
-A third variable has been added for the UV Manipulator.
-Revamped progress bars. All data-heavy operations have a progressWindow, and they should no longer get stuck being all white.
-Set Working Units (for the TD features) is now located on the Set TD button (right click!)
-The Orient Shells -settings window has been removed as it's no longer needed.
-Guido Neumann's "Calculate UV stats" is no longer included with NSUV for legal reasons.


-Advanced UV manipulator: Less typing, more options.
-Structured and logical user-interface with 4k resolution support.
-Powerful new marking menu.
-Extended UV projection tools, such as normal-based mapping.
-New snapshot window. Create 2:1 ratio UV snapshots with ease.
-Orient shells: Orients shells straight.
-Orient edge: Orient shell(s) around a UV/edge selection.
-Stack shells: Stack shells on top of each other.
-Match shells: Match UV's to their closest neighbors.
-Straighten shell: Straighten edge loop and unfold shell around it.
-Straighten UV's: Straighten all edge loops in a UV selection.
-Stitch Together: Move & Sew like in 3D Studio Max (Stitch selected).
-Randomize shells: Randomize shells individually.
-Distribute shells side-by-side with three different modes.
-Push/Move UV's so that they line up (max, min, average U or V).
-Align shells to min, max or average U or V.
-Snap shells to the UV range bounds (eight directions +center).
-Snap shells A to B: Connects two shells via two UV's.
-Spread shells: Unstangles and unstacks your shells neatly.
-Gather shells: Offset back shells that are outside the 0->1 range.
-Unfold UV's along U/V only with the click of a button.
-Custom Unfold/Relax UI's with extended options.
-Normalize shells: Normalize along U, V, UV or UV with stretch.
-Layout UV's along a U or V -strip.
-Integrated UV Set Editor: Native functionality fully implemented.
-UV Set Order Manager: Manually override the UV set order
-Texel density control: Scales shells to the same texel density.
-Fetch texel density from face selection.
-Rotate, scale, transform and flip shells around custom pivots.
-Relative rotate/scale: Rotate/scale shells around their own pivots.
-Cycle pivot point position around the four corners of the selection bounding box or the UV range bounds.
-Measure the distance between two UV coords: in pixels or units.
-Calculate angle between two UV coords.
-Checkbox for the "Retain component spacing" -option.
-Buttons for Copy, Paste and Delete UV's.
-Buttons for pinning UV's (Maya 2016 and later only).
-Button for Unitize UV's.
-NSUV top menu with a workflow guide as well as tips and tricks.
-Cycle edge colors: Change color on selected edges.


The free version of Nightshade UV Editor (intended for NON-COMMERCIAL use) is licensed under Creative CommonsAttribution-NoDerivatives 4.0 International (CC BY-ND 4.0).

For the legal version of that license including a human-readable format of that license, please visit Creative Commons official website.

For COMMERCIAL use of Nightshade UV Editor - such as for freelance work or in a studio/production environment - you are required to purchase the pro version available on this page!
One license = One person

Link to NSUV Free (non-commercial version):


NOTE that Nightshade UV Editor is only compatible with Autodesk Maya 2012 and later (32/64 bit - Mac and Windows). Support for Maya 2011 and earlier has been discontinued and will not be re-implemented. Older versions of NSUV can be handed out on request though. NSUV for LT is impossible due to it’s lack of Python support.

1) Unzip the files from the zip file to your Maya user script directory. This directory is NOT the same as your installation directory. Path to this directory:Windows: C:\Users\ %USER \Documents\maya\ %MAYA VERSION \ Mac: /users/ %USER /Library/Preferences/Autodesk/maya/ %VERSION /scriptsMake sure you copy everything! (Two folders: prefs and scripts)

2) Start up/Restart Maya and in there write the following in the command line or the script editor in order to load up NSUV: import NSUV Make sure that you enter the command as Python!

3) A shelf button can be added to the currently active shelf via the NSUV menu.

4) Please note that files from an older installation of NSUV might interfere with the functionality of NSUV 2.0 - so make sure that you delete those files from the Maya user script directory prior to installing.


(This is a list of features that are currently on my todo-list - These are features that will be included, or which I want to include and need to investigate further. Please do not post any of the below as a feature request. Thanks.)
-Atlas toolbox
-Transfer attributes: UV's (On the Propagate UV's -button. Clones UV set to all selected meshes)
-Offset stacked shells one unit away-Render offset UV's

:: FAQ ::

Q: Will NSUV interfere with other UV Editors that I use?
A: No, it shouldn't! NSUV does not modify any native files! Additionally NSUV comes with a button for quickly switching to the native editor if/when you need it.NOTE: if your studio is using in-house scripts/tools hacked into the native Maya Editor, then you need to edit some rows in for sourcing a custom script.More instructions are located in under the function defaultEditor().

Q: Why does NSUV cost money now all of a sudden?
A: Two reasons: NSUV development takes up a lot of my free time and as we all know it, time equals money. The second reason is that NSUV helps other making more money (by speeding up their workflow). Therefore it is only fair that I get something back for offering a tool which provides other game developers to make money/save time. NSUV is still 100% free for students, amateurs and unemployed game developers working on their portfolios. Personal non-commercial projects does not require the Pro version of NSUV, and never will! I've been a poor student myself so I know the importance of good, free tools.

Q: I donated money in the past when NSUV was 100% free. Do I need to purchase the pro version?
A: No. If you you previously donated money to NSUV while it was 100% free, you got yourself a lifetime license of NSUV Pro automagically.

Q: What are the differences between NSUV and NSUV Pro?
A: As of now, only the license. Both versions have the same features. However, NSUV Pro is required for commercial use.

Q: Does Nightshade UV Editor work for my version of Maya?
A: As of now, v2.0 works for all versions from 2012 to 2016 - for both 32 and 64 bit versions of Windows (tested and verified) as well as Macintosh (untested). Maya LT support is impossible because Autodesk does not think Maya LT should have Python interpreter. Older versions of NSUV (running MEL - which work for Maya LT) can be handed out on request. The last version running on MEL was 1.4.1.

Q: I can only run NSUV once - nothing happens when I run it a second time. Why?
A: After opening up Maya and running "import NSUV" without the quotation marks, you NEED to create a shelf button via the NSUV menu. You can NOT create a shelf button with just the code "import NSUV".

Q: How do I flip shells vertically?
A: Right-click the Flip UV's icon. Keep in mind that many icons in NSUV have double functionality like this. Other examples are Unfold Along U/V and Normalize Along U/V.

Q: Unfolding doesn't work properly, what is wrong?
A: By default the Unfold feature runs using the Unfold3D -method introduced in Maya 2015. Right-click the Unfold icon and change the method to "Quick" to make it behave like the Unfold along U/V -only feature.

Q: How do I use variables for the manipulator and texel density fields?
A: Right-click an icon to WRITE a value and left-click it to READ a stored value.

Q: How do I copy a UV Set with the integrated UV Set Editor?
A: Click and hold the button on the copy icon. A popup menu will appear.

Q: How do I do a planar projection or access the planar projection options?
A: Click and hold the button on the copy icon. A popup menu will appear.

Q: How do I rename a UV set?
A: Double-click it in the UV set list.

Q: NSUV is taking up too much screen space, how can I make it smaller?
A: The window is scalable and the frames and icon groups can all be collapsed (hidden).

Q: Where are the U and V input fields?
A: NSUV only has one general-purpose field. Use it for both U and V manipulations.

Q: Running Straighten shell doesn't work, what's wrong?
A: Make sure that you have a legal selection active, such as no edges shared by two shells. See the manual for details.

Q: Icons are missing! How do I get them back?
A: You forgot to copy the prefs -folder from the NSUV zip file.

Q: How do I reset all settings in NSUV?
A: Close down the NSUV window, then open up the script editor (Python tab) and execute this:

NOTE: that the window sizes and positions are not reset. Those settings are stored in a file native to Maya called windowPrefs.mel located in the Maya user script directory under the "prefs" folder!

Q: NSUV crashes during import, what is wrong?
A: You may have a broken Maya installation. Try running the row below and if that crashes Maya as well, you have a broken installation or a pirate copy:import math

Q: My question isn't answered here, where can I send it?
A: See below.


You can contact me directly via Creative Crash or via my portfolio website(Google: Martin Dahlin 3D Artist).

:: MISC ::

If you like this tool then make sure to check out my other creations here on Creative Crash.

Please use the Bug System to report any bugs.
Please use the Feature Requests to give me ideas.
Please use the Support Forum to ask any questions.
Please rate my product in the Review section.

People who have favorited this file