MagicaVoxel importer with extensions++ 1.2 3D Tools 4.0 Community

Submitted by user violgamba; MIT; 2023-01-04

This plugin lets you use MagicaVoxel VOX files in Godot. Once the plugin is downloaded and enabled in your project (in Project->Project Settings->Plugins) any VOX files in your project folders will show up in Godot and can be used as either Meshes or MeshLibraries, depending on their import settings.

This plugin is a fork of https://godotengine.org/asset-library/asset/341. This means it has all the features of that plugin. However, it includes many new features. Enough that I decided to submit it as its own asset. If and when CloneDeath accepts the new features into his add-on, I will remove this one.

New features added include:

HIDING LAYERS IN MAGICAVOXEL REMOVES THEIR VOXELS IN GODOT

This allows for toggling optional objects in MagicaVoxel, such as clothing and weapons.

MAGICAVOXEL VOXELS ARE RENDERED IN LAYER ORDER IN GODOT

MagicaVoxel VOX files are now shown with the latest layers "on top" of earlier layers. This lets the user decide which voxels take precedence and is useful when adding tight features where an extra voxel would be inappropriate, such as for facial expressions or tight clothing.

AN OPTION HAS BEEN ADDED TO ONLY RENDER THE FIRST MAGICAVOXEL KEYFRAME IN GODOT

MagicaVoxel allows for creating multiple keyframes of voxels. If each keyframe represents a separate pose then it can look strange when they are all rendered together in Godot. This option fixes that by only showing voxels from the first keyframe. It is on by default.

CAN NOW ACCESS MULTIPLE MAGICAVOXEL KEYFRAMES

This is the big one. MagicaVoxel allows for the creation of keyframes for animations. A new importer has been added for MagicaVoxel VOX files (it's selectable in the "Import" tab). The new importer is called "MagicaVoxel MeshLibrary" and represents a MagicaVoxel VOX file as a MeshLibrary with one mesh for each keyframe. The original importer is still available and is used by default. It is called "MagicaVoxel Mesh" and loads a MagicaVoxel VOX file as a single, static Mesh.

A NEW NODE-TYPE HAS BEEN ADDED TO EASILY ANIMATE KEYFRAMED MAGICAVOXEL VOX FILES

Once all keyframes are in a MeshLibrary (using the new importer), this new node-type, "FramedMeshInstance", lets you easily animate them. It takes the MeshLibrary and an an integer called "Current Frame". "Current Frame" lets you select which keyframe is display. You can set it in the inspector or with an AnimationPlayer to animate the VOX sprite.

NOTE: If you modify a VOX file, and its associated MeshLibrary doesn't fully update, try reloading the scene (menu Scene->Reload Saved Scene).