Map Theme

The map theme is a custom resource that has arrays for each mesh of the block, and some configurations.

Meshes

Any meshes you put in the map theme has to match the block dimensions, or they’ll be displaced. You can check that in blender from the "item" panel.

The origin point must be centered, but any displacement should be “inside the block” so it doesn’t clip, specially for walls.

Floor with displacement example:

For the back face culling, floors normals should look up, ceilings down, and walls front.

To export the meshes I recommend using the “save to file” option at the advanced import settings, when selecting a mesh.

Properties

no_wall_out

Don't use outside walls

wall_in_out_same

Makes the outside wall use the inside wall array, making them use the same mesh.

scale_wall_out

Outside walls are a scaled a bit more to avoid gaps, this options enables it. Can cause clipping.

The best option is to add diagonal corners in the mesh that are a little bigger than the block size. They should only be visible when two walls form a corner.

open_ceil

Only place ceilings when there is a floor above, else you will see the sky.

Collections

An array where you put scenes with decorations or custom scenes as children, that you can place with the Tilemap.

They work similarly to mesh libraries, you make a 3D scene and add all your custom objects as children. To place them, the object must have a name matching a custom data layer from the Tileset of type int, with the index added at the end, after an underscore.

Take into account that the indexing starts from 1, so the default 0 value on the Tileset means “don’t place anything”. You can add multiple collections so it’s easier to organize them