Skip to main content

Creating a Custom WMO for Epsilon

Guide by NORTE.m2 · Version 5.0


Notice

This guide starts from the point where you already have a 3D model built in Blender. You can learn how to create one here: Blender Basics for WMO Creation

If you don't have much experience with Blender, I recommend reading that guide first before diving into this one.


Requirements​

Install both WBS and Useful Shortcuts in Blender as normal addons. [Help] [Video]


WMO Directory​

Once your model is ready in Blender, enable the following option to activate WMO creation mode:

Enable WMO in Blender

In the directory path field, enter the directory of the original WoW WMO you're going to replace when creating the patch.

Example:

If the WMO you're replacing is world/wmo/brokenisles/suramar/7sr_hub_statue.wmo, the directory path should be:

world/wmo/brokenisles/suramar

(In other words, just remove the filename: /7sr_hub_statue.wmo)

Directory path example


WMO Type​

Once you've enabled the step above, several groups will be automatically created:

Automatically generated groups

Place your 3D model in the appropriate category. Each category represents a WMO type.

WMO categories

(In this case outdoor since it's an exterior-only WMO.)

  • INTERIOR WMOs require portals to work correctly (see WMO with Interior section). They have their own lighting that can be customized.
  • EXTERIOR WMOs don't require portals; their lighting comes from the world environment.

In-game rendering​

This tab shows the available flags for how the model renders.

They're not required, but can be useful in specific situations.

Rendering flags


Generating materials​

WMO panel - Generate Materials

In the WMO addon panel (1), click Generate Materials (2).

Can't see the panel?

If the panel isn't visible, open it by pressing N or clicking the small arrow at the top.

After this step, all your materials will have disappeared from the object. That's normal!

Assigning in-game materials​

Notice

There are 2 approaches for this. The manual one, and the automatic one using WoW: Useful Shortcuts. I recommend jumping to the second one.

METHOD 1: Manual​

I recommend reading this section to understand how it works, but not using it in practice. It's slow, tedious, error-prone, and inefficient. Use the second method instead.

Recover materials

To get them visible again: in the materials tab (1), select your material (2), and under Texture (3) choose the original texture it had before (4).

Repeat for each material one by one.

Tip

Do this step and the next one in parallel to go faster.

WoW materials

Each material needs to be linked to the .blp file from WoW that it will use.

Material path field

In the path field, enter the BLP path. For example:

dungeons/textures/6hu_garrison/6hu_garrison_armorystone.blp

Full path example

Repeat for every material, assigning each one its target file inside WoW.


METHOD 2: Automatic​

This method uses the WoW: Useful Shortcuts Blender addon. It will save you an enormous amount of work.

At this point, all materials will be showing as black in the viewport. Open the addon panel (press N if it's not visible) and click [Fill WMO Textures].

Example

The addon will automatically fill in the paths for all textures in the project, as long as two conditions are met:


  1. The material name matches its image name.

You can use the [Name material after its Image] button and it will do this automatically for every material in the project.

Note

We're working with textures extracted from WoW, so they'll already be named after their in-game texture. For example: "6hu_stone.png" will be "6hu_stone" in Blender. (The addon ignores the file extension when renaming, so it'll match correctly.) Just make sure the names are consistent.


  1. The texture is in the database.

The addon's built-in database doesn't include every WoW texture — only around 300. You can add your own entries in this field:

Add textures example

Just enter the full path and click the button. It saves permanently. For example: dungeons/textures/dalaran/eb_dalaran_archstone1.blp

Next time it will be available automatically.

You can also add your own custom textures.

What's a Custom texture?

If you're using your own textures to replace existing WoW ones — for example, a high-res texture called Custom_Wall — in the Custom field enter the name: Custom_Wall, and in Path enter the one it replaces: dungeons/wmo/replaced.blp.

From then on, whenever Blender detects a material named Custom_Wall, it will apply that path.


Help! I clicked the button but my textures are still black.​

That's normal. A quick trick to force them to reload is to add collision to the object — it refreshes all textures. In any case, textures appearing black in Blender has no effect on how they look in-game.


Verification​

All textures must have a path assigned. If any are missing one, the exporter will throw an error telling you which ones are affected.

In the materials tab, you can click through each material to check that all of them have a path: Check materials example You should see (in the orange area) a valid path.

What if one doesn't have a path? Most likely the material name doesn't match any texture in the database. Either rename the material to one that does, or add it to the database as explained above. Clicking the addon button again will regenerate all paths automatically.


Other options (not required):

Other material options

Terrain Type defines the footstep sound your character makes when walking on the WMO inside the game.


WMO Collision​

To add collision, click QUICK COLLISION in the addon panel.

Quick Collision button

This generates basic collision based on the shape of the 3D object.

Tip

Leave the default value for now. If the collision doesn't behave correctly in-game, try changing the number. A higher value usually gives better results, though sometimes values like 100 or 200 work better. I'd recommend trying 5000 first, then keep adjusting until something works.


Possible errors​

Watch out!

The UV on the object must be named UVMap, otherwise the exporter will throw an error. You can rename it using the Useful Shortcuts addon button.

UV Map renamed to UVMap

You need a project!

Only required the first time.

Before you can export, you also need to have created a project in the addon. You only need to do this once — the same project works for everything you create going forward. It can be created at any point.

Create project in the addon

Project configuration


Exporting​

Once everything is done, export from the addon panel:

Export button

The exported file will be in version 3.3.5 (Lich King). You'll need to convert it to Shadowlands using the converter.

Place the files Blender exported into the INPUT folder, using the original WMO's filename:

INPUT folder with files Files exported by Blender

Run MultiConverter.exe and the OUTPUT folder will contain 3 files. Use the two .wmo files to create your Epsilon patch. Done!


WMO with Interior​

WMO with interior

Interior and Exterior​

Interior and exterior diagram

Interiors work differently from exteriors. They need to be added as a separate model.

You'll have an interior model sitting inside the exterior model. Place it in the corresponding category: Indoor.

Note

The interior must connect to the exterior — there can't be a gap between the two models.

Watch out

Interior and exterior lighting are treated separately: there will be a visible seam between them.

Portals​

To connect the interior and exterior, you need to place a portal between them.

Note

Without a portal, the interior won't be visible from the outside and vice versa — though the character can still pass between them.

Create a plane at the transition point:

Portal from outside Portal from inside Portal plane in 3D space

Place that plane in the "portals" category and configure it:

Portal configuration

With the portal selected, in the WMO Portal section, set First Group to the exterior object and Second Group to the interior one.

Notes
  • Portals don't need textures. Just assign them a blank material.
  • You can place as many portals as you want (doors, windows, etc.).

Portal configured in the outliner


Lighting in WMOs​

Step 1 — Enable Vertex Color​

Enable Vertex Color in the addon panel.

Watch out

Make sure you have the correct object selected in the top menu before doing this — in this case the interior model.

Step 2 — The Col vertex​

In the Color Attributes tab you'll find a vertex layer called "Col". This is the channel where WMO lighting is painted.

Col vertex in Color Attributes

Note

It should exist by default. If not, click + and create it with these settings: Face corner, Byte color.

Step 3 — Enter Vertex Paint​

Switch to Vertex Paint mode:

Vertex Paint mode menu

Set up flat lighting like this:

Flat lighting configuration

Step 4 — Painting the lights​

Paint panel with numbered controls

  • (1) Set the brush to Add mode.
  • (2) Choose the color to paint — this will be the light color.
  • (3) Adjust the brush radius.
  • Paint the object to define where the lights will appear.
Notes
  • White = white light.
  • Black = the area will be lit naturally by the day/night cycle or by in-game light objects. (Black doesn't mean darkness — it's the default value.)
  • I recommend painting everything black first, then adding light only where you want it.

Example of painted lights

Note

The lighting will appear much softer in-game than it does in Blender.

Step 5 — Enable Unified Rendering​

For the lighting to apply in-game, enable only the "Unified Rendering" option — regardless of what you had enabled before:

Unified Rendering option enabled

The lighting will now work in-game!


Exterior / Interior light transition​

Light transition example

In the Color Attributes tab, create two vertex layers with the following configuration:

Color Attributes with two entries

Each vertex layer configuration

  • The first one should be named: BatchmapTrans
  • The second one: BatchmapInt

So it looks like this:

Final list with BatchmapTrans and BatchmapInt

Switch to Vertex Paint mode (same as steps 3 and 4 above):

Vertex Paint for the transition

Paint the object so that the area around the doorway is white and the interior area is black.

Important

Apply the same painting to both layers: both BatchmapTrans and BatchmapInt.

  • White area → light transition zone.
  • Black area → WMO uses the lighting we painted ourselves.

Done!

Final result of the light transition


Complex WMOs: Subgroups​

WMOs have a face and vertex limit per subgroup:

Limit
Vertices per subgroup65,535
Faces per subgroup65,535

(Edges and triangles don't count toward the limit)

Recommendation

NEVER exceed 50,000 per subgroup. Beyond that, errors will start appearing.

You can check your model's stats here:

Model statistics in Blender

Detailed statistics panel

To go beyond the total limit, WMOs can be split into subgroups. Using wow.export you can find a WMO that already has multiple parts and use it as the base for replacement:

WMO with multiple parts in wow.export

In Blender, each part of the original WMO becomes its own subgroup. The name of each subgroup doesn't matter; these are just named as an example:

Subgroups in the Blender outliner

With 5 subgroups you could have up to 325,000 faces — well beyond the single-group limit.


Appendix: Other documented errors​

Notice

This section is theoretical. The information here may not be fully accurate — it's a collection of findings from experimentation and research.

Faces are sticking through the model incorrectly​

The vertex or face limit for a subgroup has been exceeded.

Limit
Vertices per subgroup65,535
Faces per subgroup65,535

Protruding faces error

Fix: Split the model into parts that each stay under the limit.


Faces are invisible even though the normals are correct​

Invisible faces example 1 Invisible faces example 2

A material also has a maximum number of vertices and faces it can handle, just like a subgroup.

Fix: Split the WMO across multiple materials.


Converter crashes​

Error in the converter console

One of the textures has a space in its path — usually a trailing space after .blp. Remove any extra spaces.