What is MeshMaker?

MeshMaker is a Windows-based Unreal and Unreal Tournament editing tool that makes converting UnrealEd brushes (or, more precisely, prefabs) to decoration actors a matter of seconds.

Have a look at the MeshMaker walkthrough to find out how it works.

Why Meshes?

Meshes (or, for our intents and purposes, decoration actors) have some advantages over brushes where it comes to detail work:

First and foremost, the engine can render much more raw mesh faces than brush polys. For comparison, an average player model (which is a mesh) has about 600 to 1200 faces, and the engine has no problems rendering scenes with many players in close view. That means that meshes can be much more detailed than anything you could create from regular detail brushes without a noticable slowdown.
Because meshes aren't part of the BSP tree, they never cause BSP holes or hall-of-mirror effects. When designing a prefab that's supposed to be converted to a mesh, you don't have to bother with grid alignment; same applies for placing meshes in your map.
The engine uses vertex lighting on meshes (as opposed to lightmaps on brushes). That's not necessarily an advantage since lightmaps are much more sophisticated than vertex lighting, but vertex lighting makes meshes appear smoother than brushes. Try that with a sphere, for instance.
Decoration actors are much more versatile when it comes to interactivity in maps: With just a simple property change, you can make them pushable, floating on water, destructible, revolving and more.

But it's not all sunshine, of course. The advantages mentioned above come at a cost:

Although meshes are rendered vastly faster than brushes, part of that advantage is sacrificed to the fact that meshes are always rendered as a whole when they're visible (as opposed to brushes whose individual surfaces are only rendered when they're in view). In virtually all cases it's still a big performance gain, though.
Meshes only support an upright collision cylinder, while brushes have per-poly collision.
The vertex lighting mentioned above is much less sophisticated than lightmaps. On the other hand, the difference is most obvious on large-scale objects which aren't suited for mesh conversion anyway, and occasionally the smoother vertex lighting even is a desired effect.
Not more than eight individual textures are supported per mesh, and textures can't be tiled on mesh faces as they can on brush surfaces. (MeshMaker automatically adjusts texture alignment to work around that limitation.)

Download and Installation

MeshMaker is available for download as an automatic Umod installer and a simple Zip archive. Both versions contain the same files; they just differ in installation convenience.

	FilePlanet		Umod installer		(502 kB)		Zip archive		(505 kB)
	Link-M (Germany)		Umod installer				Zip archive

A note for webmasters: Please don't link to the individual downloads themselves; link to this page instead. The download locations might be changed or removed without prior notice.

Conversion Details

The converted prefabs retain their original size and orientation. Same applies to most static surface properties: Translucent, modulated, masked, unlit, two-sided, and non-smoothed. Mirror surfaces aren't supported by meshes, but MeshMaker converts mirror surfaces to environment-mapped mesh faces; it's a nifty effect, try it out.

Common Pitfalls and Limitations

Prefabs must be completely textured. Prefabs with untextured surfaces can't be converted.
Meshes don't support more than eight individual textures (per mesh). Prefabs using more than eight textures can't be converted.
Textures can't be tiled on mesh faces. MeshMaker will automatically adjust texture alignment to the closest possible representation of the original prefab's texturing.
UnrealEd's software rendering mode has major problems displaying meshes; if your converted prefabs appear distorted in UnrealEd, don't worry and jump into the game to actually judge their looks. If the decorations seem to be strangely greenish, unselect them.

If something doesn't work for you that should work for you, it might be a bug. If you find a bug or some strange behavior that you suspect to be a bug, send me an email at mychaeel@planetunreal.com. Please try to provide as much information as possible; bug reports to the effect of "it doesn't work and you suck" are worthless and will be discarded.

Same applies to suggestions. I'm open for any suggestions you might have; I can't promise that I'll implement every suggested feature, but I'll definitely consider it.

Copyright and Acknowledgements

Kudos go to the following individuals and organizations: Antonio Balcazar, whose excellent (and free) Delphi unit for Unreal package access saved me an insane amount of research and coding; David Townsend from Legend Entertainment for publishing the source code of the 3ds2unr tool, which provided me with vital information about Unreal's mesh format; Exodus-R from the BeyondUnreal Editing forums for publishing a thorough listing of possible face flags in Unreal meshes; and last but not least my beta testers, ElBundee and WillySurvive.

Oh, and really last but definitely not least the nice folks from BeyondUnreal's Editing forums that offered kind encouragement when I asked whether a tool like MeshMaker might be useful.