An Anukari environment preset is a file with the extension .env.zip, which is a plain zip file that contains two required files (ibl.ktx, skybox.ktx) and one optional file (model.glb). The *.ktx files provide the texture and luminance data for the skybox, and the *.glb file provides a 3D model that will be rendered at 1:1 scale at the origin (see the Vaporwave.env.zip environment for an example). You can look at the Factory environments in the following directories:

The *.ktx files can be generated from any *.hdr or *.exr image file in the equirectangular format. There are many websites that have free skyboxes in this format. To convert the *.hdr or *.exr image file into the *.ktx files that Anukari requires, you can use the free cmgen.exe tool from Google Filament. Download the latest Filament release for your OS and extract the files. In the extracted bin directory there will be an executable called cmgen.exe (Windows), or just cmgen (MacOS). To convert the skybox, the commands look like:

The --size parameter can be used to increase the quality of the skybox, at the expense of larger files. It has to be a power of 2 like 512, 1024, or 2048. Generally 2048 produces very large files with very good quality. The cmgen command will produce two *.ktx files in the Output directory, which you need to rename to exactly ibl.ktx and skybox.ktx. Zip these up and rename the zip file to *.env.zip and then place it in the appropriate UserEnvironments directory, and you'll then be able to load it in Anukari. Make sure the *.ktx files are at the top-level of the *.zip file with no subdirectories:

To include a custom model.glb file, see the section below on how to create *.glb files, and then give the file that exact name and include it in the *.env.zip file that you create.

An Anukari skin preset is a file with the extension .skin.zip, which is a plain zip file that contains all of the 3D model files that Anukari needs in the open glTF 2.0 format. Specifically, the files are in the *.glb binary format. To see a list of all the *.glb files that are required, you can look at the Factory skins in the following directories:

There are many tools you can use to edit the *.glb files, but the simplest starting point is the free Blender tool. Technically you can import the *.glb files directly into Blender via the File > Import > glTF 2.0 menu, but most of Anukari's *.glb files have been compressed using EXT_meshopt_compression which Blender does not yet support. If you really want to import the *.glb, you can do it by using a tool like gltfpack to output the *.glb in a non-compressed format, which you can then import into Blender.

However a much simpler place to start would be with the actual *.blend source files for one of the Factory presets, which have been made available for the Pre-Alpha Classic skin here. This simple skin has everything you need to get started. Be sure to carefully examine the orientation and scale of the 3D models, and note that Anukari's renderer is limited to simple PBR materials. Also, look carefully at the animation timelines. All the animations are done from t=0 to t=1, but some of them (like the oscillator or bow) require that the animation loops, while others (like the mallet) do not.

Once you've made a 3D model, you can export it via Blender's File > Export > glTF 2.0 menu. Be sure to choose the glTF Binary (.glb) output format, and give the skin the right filename for the object it is associated with. Finally, zip up all your *.glb files, making sure that they are at the top-level directory with no nested directories, and rename the zip file to *.skin.zip. Place that file in the appropriate UserSkins directory and then you can load it in Anukari:

Note that Anukari does NOT support all valid glTF 2.0 files. If Anukari is unable to load your model, it will render it as a pink cube. In some cases, Anukari may be able to log information about why it could not load your model. Log files are in these directories:

If your 3D models take a long time to load, or are very large, you can consider using the gltfpack tool to compress the vertices using the -cc option. This can substantially reduce the file sizes and speed up loading.

Yes! Anukari *.ank preset files are represented as Google Protocol Buffers, and the public definitions for those protobufs are available in the anukari-preset-api Github repo. These definitions can be used to programmatically create Anukari presets in any language that supports Protocol Buffers, such as Python.

However, the raw Protocol Buffers are quite difficult to work with, though, so we strongly recommend using the anukaribuilder library by 312ears instead.This library provides a much more user-friendly API for creating presets, along with a bunch of examples, including some extremely fun stuff like a preset that morphs between a sphere and a pyramid.