A Godot script to generate mesh libraries with custom thumbnails. This is a @tool script, when the script is attached to a GridMap a mesh library can be generated in the editor with the "Generate Mesh Library" button in the inspector. This mesh library is assigned to the GridMap and can optionally also be saved to a file.

Thumbnails are generated in the editor using the specified primary camera in the current scene. An override camera can also be specified on a per mesh instance basis by adding a Camera3D as a child. Any nodes inside the scene SubViewport will be rendered to the thumbnail, this allows for a custom ground plane to be rendered, etc. Thumbnails can also not be rendered at all, this reduces the library file size in cases where the thumbnail is not needed.

When merging with an existing mesh library two behaviors are available. The default Godot editor behavior where an exact match is required; or close match, where spaces are skipped and capitalization is ignored. Additionally when merging, missing items can be marked by replacing their mesh with a marker mesh. And/or item ID's can be reused for new items if their source is no longer present.

Generator Properties

Scene Tree Setup

Example Thumbnails
With Best Darn Grid Shader ground plane and missing items marked will billboard plane.

GDScript source code: Download