This Blender add-on adds support for the MDL file format used by Neverwinter Nights for 3D models.
This document refers to NeverBlender v2.8 and its supported Blender Version 2.83 and 2.93.
Note that as of May 2023, NeverBlender is only supported in Blender versions up to v3.3. The latest release (3.4) is not supported. Check the NeverBlender vault page for a full list of compatible versions of Blender.
Displacement Mode ¶
This setting determines how NWNs heightmaps are used in Blenders Materials. They can either be used as Bump Maps (faster, always visible) or Displacement Maps (slower, not visible unless the mesh has a subdivision surface modifier). This settings has no effect on exported models.
Dummy Settings ¶
This settings determines how Dummies (NWNs version of Emtpies) are displayed in Blender. They mark special locations for the engine, e.g. Spell VFX targets. As there can be quite a lot of them, you may want to lower their size.
Placement of models, when importing multiple models
- Spiral: Places models in a spiral pattern
- Line: Models are exporting in a straight line with 10 units distance (10 meters in NWN)
Mesh Validation ¶
Uses Blenders mesh validation on imported Meshes. While this ensures the meshes are avlid it also removes two sided faces, i.e. two faces using the same set of vertices.
Specify which colors from the MDL are imported. Theengine itself, doesn't actually use all of them:
- 1.69 uses Diffuse and Ambient (also true for models without renderhint in NWN:EE)
- New Shaders in NWN:EE only use Diffuse (requires a renderhint)
External Decompiler ¶
NeverBlender can only load ASCII MDL files. In order to enable loading of Binary MDLs, you'll need to specify an external compiler. When a binary MDL file is detected NeverBlender will run the decompile command and load the generated ascii MDL. The following decompilers are available:
- CleanModels EE: Most up to date and fully supports the new features in the EE. You need to select the command line version cleanmodels-cli.
- NwnMdlComp EE: Partially updated to support some of the new features of the EE. You can download the latest version from here: https://forums.beamdog.com/discussion/comment/974481/#Comment_974481 or Direct Link. Be aware that it doesn't support all new parameters of the EE (missing support for normals and tangents). Windows only.
- NwnMdlComp: Old version, pre EE. Does not support any features of the EE. Windows only, requires the registry keys of the pre-EE Installation to work properly (Deluxe or Platinum Edition or physical disks). Not recommended.
In order to add a decompiler:
- Tick the checkbox:
- Select the
pathto the downloaded binary/executable.
- Next click on the small
circling arrow buttonin the field below to auto generate the command used to call the compiler. This command is platform dependent and can be generated for CleanModels and NwnMdlComp (On Linux systems, it will add wine, when using a Windows exe)
Specify how to reference diffuse Texture in MDLs.
Whether to use wirecolor. When enabled Blender objects color will be used to hold wirecolor. This is ignored by NWN.
Binary Smoothing Groups ¶
Smoothing groups will be exported as powers of two.
Export Metadata ¶
Unused at the Moment.
MTR Export ¶
Control whether to export MTR files at all and how to reference them in exported ASCII mdl files.