Updated
Troubleshooting and answers to your questions about Avoyd. The FAQ covers:
We update the FAQ regularly. If you cannot find your answer, try to search for the relevant words in this page with the find function of your browser (usuallyCtrl +F). Then look in theVoxel Editor User Documentation and theenkisoftware FAQ. If you still can't find your solution, you shouldcontact us.
To learn how to use Avoyd, start with thetutorial and follow with theuser documentation.
Tutoriel et documentation en français.
We answer your questions on oursupport forum, and also onReddit,Itch.io,Youtube,Discord, or you cancontact us directly.
Avoyd is a voxel editing tool and a work in progress. Its functionality is currently in flux as we keep adding to it and improving it. We list its features and functionality in the following places:
Check ourRoadmap for features we are working on and plan to add in future.
If you need features that are currently missing, functionality you'd like us to improve, or have any questions, feel free tocontact us.
We may add these features in the future. Some of them have possible alternatives. ☛ See our roadmap for features we plan to add
.vox or.obj. Assemble them in a third party tool like MagicaVoxel or Blender..vox file that contains several models, Avoyd merges them into one world. When youexport the world to.vox, Avoyd creates new model boundaries..obj and animate them in Blender, orexport them to.vox to animate in a third party tool that can do it..vox and use a third party converter tool than can export to a Minecraft format.Avoyd and MagicaVoxel are both voxel editors capable of editing.vox files and doing renders. They are complementary in several ways. By using them together you can for example:
.vox files together in one scene, even if they have different palettes..vox models, Minecraft files, heightmaps, etc. (and optionally hollow them together)..obj and glTF.glb with all material properties (emissive, metallic, transparency) to use in Blender, game engines like Unreal etc..vox files by importing into Avoyd then exporting the fixed.vox.Explanation: data corruption can prevent a .vox file from opening properly in MagicaVoxel, but we've built a few error recovery processes into Avoyd.This is a non exhaustive list of differences between Avoyd and MagicaVoxel:
.vox format limitations. It can do the following:.vox models that exceed the MagicaVoxel limit of 2000 x 1000 x 2000 voxels a side..vox file size is limited to2GB.).vox is limited to 255.).avwr voxel files are roughly 10 times smaller than.vox..mca and.nbt schematics..hdr and.exr with image sizes up to 32768 pixels a side..obj and glTF.glb with all metallic, transparent and emissive materials, withpresets and instructions for loading into Blender and game engines Unreal, Godot and Unity..vox with unlimited size and automatic material count reduction..vox models keeping all their different materials, and the option to hull (hollow out) the result..vox files..obj.Officially Avoyd is available on Windows only. However several people have reported running Avoyd successfully onUnix-based systems (we haven't personally tested these configurations):
We do not plan to port Avoyd to Linux, Mac OS nor consoles for the foreseeable future. When we do we will port to Linux first.
The reasons for this decision are many: the underlying technology for Avoyd is multiplatform and we have tested making a Mac and Linux build. We also maintain several open source multiplatform libraries so have a good idea of how much effort is required to release cross platform software. The overheads of maintaining a port of a complex graphics application are high, especially as feature development is ongoing. It's relatively easy to break a build on one platform/hardware combo in a way a simple smoke test won't detect. Additionally we don't have a Mac which can run Avoyd (we use a old Mac to maintain the Mac versions of our open source libraries), and we don't think we'd make back the cost of buying one if we made a Mac version. We know the primary feature set we want for the Avoyd Voxel Editor and Renderer, and once these come together we'll reassess. If sales pick up before then we also might reassess. Finally, we're always happy tohear your thoughts on this.
Avoyd runs on our in-house voxel game engine written in C++ using OpenGL, and Vulkan for the GPU renderer. This is partly why the download size is small.
The LOD (Level Of Detail) system runs in real time to simplify parts of the 3D world that are far away from the camera. It helps Avoyd run faster whilst keeping an infinite render distance, but distant details are lost and show as large cubes instead. If your machine is powerful enough, you can increase the distance at which the LOD system kicks in. (You may be familiar with games that also choose to hide far away details behind a wall of fog but this limits the view distance, for exampleMinecraft.)
To see more details / fewer LOD cubes in real time, increase theGraphics Quality setting (see theGraphics settings documentation). It increases the render distance at the cost of lowering Avoyd's performance. Depending on your machine, you may not be able to remove the LOD cubes completely from the real time view.
When you path trace your world (using menuRender) to create a high quality rendered image, the LOD cubes disappear. The rendered image shows your world in full detail (depending on the image resolution and the number of samples per pixel you choose).
Use Avoyd's path tracing renderer to create high definition images of your world. To do so go to menuRender in the Voxel Editor and render your world. You can add special effects like bloom or depth of field. Path tracing a world takes time, depending on how powerful your computer is. See theRender documentation for more information.
The cursor is a guizmo that helps you edit the voxel world. It's a wireframe shape visible when you use the Edit Tool or Pick Material. Due to constraints and settings, the cursor can sometimes become hidden.
If you can't see the cursor, try to:
3D Viewport and right-mouse click to open the context menu.Move Cursor Here orMove Anchor here.If that doesn't work try to:
Tools > Edit Tool) and turnAnchor on.3D Viewport to open the context menu.First Person Camera > Focus on Anchor orArcball Camera > Centre on Anchor.If you still can't see the cursor:
Cursor section and turn the cursor on.Anchor offCollide offConstraints section and turn all constraints offAfter this if the cursor is still hiding, try context menuMove Cursor Here orMove Anchor here again.(Tip: if you don't want to move the anchor you can use the camerasFocus on Anchor andCentre on Anchor.)
In theTools > Edit Tool, tickSticky.
This ensures you can only place voxels adjacent to other voxels. This style of editing is similar to building in Minecraft. It works best with single voxels.
Avoyd does not currently support textured voxels. Each voxel has a single, uniform colour assigned to it: its material.
You can edit the materials properties to change the way they look: change their colour, emit light, be transparent, be smoother and reflective like metals inTools > Materials.
If you're creating your own scene, you can use multiple voxels with different materials to look like textures. You can import images into Avoyd but each pixel becomes a single voxel with a uniform colour.
The background of your voxel models is a physics-based simulation of a sky with a singular main light and an infinite atmosphere. To change its appearance:
Tools > Light and Atmosphere.The camera works in a similar way to FPS games. You use the mouse and keyboard to control it.
You need to be in 'Movement' mode to move the camera. You'll find explanations abouthow to move the camera, and the different types of cameras, in the documentation. There is also afull list of camera controls.
Follow theMinecraft Import and Render documentation.
Avoyd converts Minecraft data into voxels: all textured blocks and decorations are represented as single material voxels. As a result Avoyd is best suited to large path traced scenes, for example entire maps, where details matter less. If you need to render details and textures, useChunky.
There are several possible reasons for the render being black:
Exposure is set to0 or a very low value. Increase the value (default is1). (MenuRender).Light Intensity Multiplier is set to0 or a very low value. Increase the value (default is1). (MenuTools > Light and Atmosphere.)Light Colour to a colour other than black. (MenuTools > Light and Atmosphere.)If you cannot see your model - only the background and the sun - when you render using the GPU, it may be an intermittent bug that is due to the model not loading properly into the GPU memory.
To fix it, toggle toCPU and then back toGPU rendering. This will force the model to reload into memory which should fix the issue. Then render your scene again.
The steps you see may be aliasing artifacts due to the resizing of the render to display it in the 3D Viewport, or they may be due to an insufficient number of samples. They may not affect the actual render.
Save your render and open it in an image viewer to check if the lines are smooth and without steps. If you still see steps, try adding samples by increasing theMax SPP in theRender window.
Open theRender window. In theRenderer section, open thePath Termination settings and increaseMax Ray Depth.
Use theDenoiser or increase the number ofSamples Per Pixel (SPP).
To use the denoiser you need to install OIDN and render the scene.
Help > Version and Updates and update Avoyd if necessary -download Avoyd.oidn-n.n.n.x64.windows.zip...\Users\< your username >\Documents\Avoyd\Plugins\oidn. When done you should have several folders includingbin andlib in the..Plugins\oidn directory.Render.Render window selectPreview orDo Render Image.Denoise button in theRender window. The grainy noise that looks like static should disappear from the image. Note that it may blur fine details.Periodically check you're running the latest version of OIDN.
There are several ways to make a scene brighter:
Tools > Light and Atmosphere and increase theLight Intensity Multiplier. It increases the intensity of the main light (sun). Then render.Exposure..hdr or OpenEXR.exr and fix the brightness/contrast in an image editing tool likeGIMP orDarktable.Make the atmosphere colour darker:
Rayleigh Colour and theMie Colour inTools > Light and Atmosphere.Amount.A large sun (main light) makes soft shadows. A small sun makes sharp shadows.
To set the size of the sun openTools > Light and Atmosphere. Increase theSun Angular Diametre for softer shadows, reduce it for sharper shadows.
God rays or crepuscular rays or atmosphere shadows are a relatively rare natural phenomenon that occurs in specific circumstances depending on the sun, the atmosphere and the position of the observer.
Because Avoyd uses a physics based light and atmosphere system for its rendering, it's a good idea to understand which conditions cause god rays to appear in real life. Thewikipedia article on crepuscular rays is a good starting point.
To increase the chances of getting god rays in an Avoyd render, you need the following:
Atmosphere Volumetric Shadows in theRender window before you render your scene.Half Length andAmount (menuTools > Light and Atmosphere). Ensure your settings fulfill this rule:Half Length xAmount > distance obstacle to cameraHalf Length =1000 andAmount =5 for a Minecraft map with a mountain2000 voxels distant.Additional tweaks:
Increase the value of the atmosphere half length. See the effect this has in therendering video at 3min 02s.
Tools > Light and Atmosphere.Extremely Clear in thePresets drop-downAtmosphere.Half Length manually.Explanation: when you increase the distance between the camera and the world you'll notice that the scenery takes on a slight blue hue. It is visible on large Minecraft maps. This is because there is an atmosphere and the default is, like in the real world, slightly blue.
To make the water more or less transparent in renders, change theAbsorption Length of the material as follows then re-render to see the results:
This method applies to any transparent material such as water, glass, clouds, smoke etc.
Materials window withTools > Materials.Pick tool withTools > Pick Material and click on a water voxel in the world.Materials window, select theMaterial Type that countains the water from the drop-down, and click on the swatch of the water material you want to modify.Minecraft material and select the water swatch.Materials window, go to theMaterial Properties section.Absorption Length of the water to make it less transparent. Inversely, increase it for more transparency.Surface Transmission, and inversely if you want it less opaque.When you render Minecraft maps you may notice that the vegetation looks shiny depending on the angle of the light. This effect is called"Fresnel". Every smooth material has some degree of Fresnel or specular reflection.
You can reduce the Fresnel of the vegetation (e.g. grass) by making it less smooth: decrease the materialSmooth value inTools > Materials.
Avoyd doesn't currently support the use ofHDRI as a skybox.
As a partial workaround you can import a light emitting image and paste it into your voxel scene:
File > Load Paste Brush.Flat Image.Emissive to a number greater than 0.Import.Light and Atmosphere tool using the global preset (or settingLight Intensity Multiplier = 0).Path Tracing is a form ofRay Tracing which approximates physically correct lighting. Both can be done in real-time or 'offline'. Both are built on top ofRay Casting, which is where a single ray is cast to determine what it hits.
The originalRay Tracing is sometimes calledWhitted styleRay Tracing after Turner Whitted who first used recursiveRay Tracing (i.e. rays following after each other, or traced) to render mirror reflections and refraction through transparent materials.
Path Tracing then adds physically based materials and probabilistic sampling of light paths(*) to trace multiple rays and render realistic scenes.
(* paths _to_ the light, the reverse where you follow the light is calledPhoton Mapping, though there is alsoBi-directional Path Tracing)
Partially. Avoyd exportsemissive voxels to all formats. In addition, exports to.vox include themain light (sun) settings: angles (position in the sky), intensity, area (sun size) and colour. For.glb and.obj Avoyd doesn't export the main light. Avoyd doesn't export atmospheric scattering.
| Export Format | Emissive voxels | Main light (sun) | Atmosphere |
|---|---|---|---|
MagicaVoxel.vox | Yes | Yes | No |
glTF.glb | Yes | No | No |
Mesh.obj | Yes | No | No |
For reference there are three sources of lighting in Avoyd:
Avoyd exports the emissive voxels and their material properties, so these will contribute light to the scene if the tool or game engine renderer supports it.
Avoyd doesn't export the sunlight to.glb and.obj nor the atmosphere properties to any format. You need to set them up in the tool or game engine you load the exported models into.
If this happens, re-export your voxel model making sure the name of your.obj file has no spaces in it.
Run Avoyd version 0.26+ to get a warning if there are spaces in your filename when you export to mesh for Unity.
Explanation: spaces in the.obj filename may cause Unity to fail to load the materials correctly. The model will appear completely white in Unity.
If your model is smaller than 256 voxels a side, you can export it to.vox and open it inBlockbench 3D editor. Blockbench converts your model to mesh.
.vox with menuFile > Export > MagicaVoxel (.vox).Voxel Importer plugin:File > Plugins.Voxel Importer.Install..vox file with menuFile > Import > Import Vox.Note: Alternatively, you can export your voxel model to.obj, but you will need to open it in Blender and save it back out before importing it into Blockbench.
You're likely seeing a standard warning about programs which have not been downloaded by millions of people. The Avoyd executables are virus checked and signed with our company Enkisoftware Limited's digital certificate. The certificates are delivered by an independent provider: Sectigo.
What you can do to check the file you downloaded is safe to open or execute:
Downloads folder.Show more options.Scan with Microsoft Defender.Avoyd_0.25.0.942_full_setup.exe.Properties.Digital Signatures.| Name of signer: | Digest algorithm | Timestamp |
|---|---|---|
Enkisoftware Limited | sha1 | 20 December 2024 19:09:21(*) |
Enkisoftware Limited | sha256 | 20 December 2024 19:09:25(*) |
Details.View Certificate.| Issued to: | Enkisoftware Limited |
|---|---|
| Issued by: | Sectigo Public Code Signing CA R36 |
| Valid from | 22/03/2023 to 21/03/2026(**) |
Issuer Statement for more information from theSectigo websiteIf Avoyd stops working or shuts down, follow those steps:
AvoydLog.txt (..\Users\< your username >\Documents\Avoyd) tosupport@enkisoftware.com with the steps you followed to reach the crash. We'll get back to you as soon as possible.Avoyd stores all its settings and data (including world files, templates, screenshots and renders) in..\Users\< your username >\Documents\Avoyd.
To reinitialise Avoyd (resets all settings and layouts and returns Avoyd to its original state) do the following:
..\Users\< your username >\Documents\Avoyd.imgui.ini anduser.cfg.(You will lose your configuration, if you need to preserve these, make copies of the two files.)(Note that some windows in the voxel editor have aReset button at the bottom (ex.Tools > Cameras andSettings > Display). Pressing that button only reinitialises the settings of the features available in the window.)
You can't change it currently. All images are saved to your user directory..\Users\< your username >\Documents\Avoyd\Screenshots.
Avoyd is only available in English as the functionality and the user interface are in flux.
Avoyd n'est pas disponible en français mais letutoriel d'introduction et une partie de la documentation de l'éditeur de voxels sont publiés en ligne.
⚠ Controls keys and keyboard shortcuts are currently hardcoded: you cannot change them.
☛ List of controls and shortcuts
You can however modify the following parameters:
Settings > Controls.Tools > Camera sectionSettings.To modify the voxel editor's user interface (UI), open menuSettings > Display and edit the parameters. For example:
Size.Font.Theme andSaturation.If you use Avoyd on a TV, increase theSafe Area Padding to ensure the UI fits in the smaller display area.
You may notice that your computer heats up (fans can become louder) when using Avoyd. There are several ways to reduce the power consumption.
Save power by doing any of the following:
Settings > Graphics and tickPower Save Mode.Settings > Graphics and tickVSync.Settings > System and decrease theMax Logical Processors.You can go further at the expense of graphics quality:
Settings > Graphics and lower theGraphics Quality.Settings > Graphics and lower the resolutionsFullscreen Resolution andWindowed Resolution.From the most to the least effective method to reduce.avwr file sizes:
Make simpler worlds.
Avoid unnecessary details and reduce complexity where you can. Examples of approaches you can follow are:
Amount to255 by tickingFull Voxels in theEdit Tool. This will prevent Avoyd from morphing voxels to smooth surfaces - every voxel will show as a cube - but it will reduce the complexity of the information stored.Explanation: the.avwr format is compressed. Volumes that are homogeneous, meaning filled with the same material with the same properties, are compressed. Volumes filled with a lot of information: different materials, holes, complex shapes, noise, cannot compress as well. This leads to larger file sizes.
Defragment the Octree.
UseEdit > Defragment the Octree.
Note that Avoyd automatically defragments the Octree during saving if there have been sufficient changes to the world andAuto Defragment on Save is on (underSettings > System).
Explanation: defragmenting the Octree groups similar volumes together and deduplicates regions which have the same data (a form of compression). This helps to improve performance, reduce memory consumption and reduce the size of the.avwr file.
Remove unused Materials.
UseEdit > Remove Unused Materials.
The size reduction depends on how many materials you have and the length of their names. It typically is of the order of tens of kB, hence more noticeable on small files.
To reduce your.vox file size you need touse fewer voxels.
Use the optionRemove Hidden Voxels when you export to.vox if your voxel scene or model can be hollow (you're not using it in a destruction game for example).
Explanation: the size of a.vox file is directly proportional to the number of voxels in it. In other words, the more voxels, the larger the file.
Make sure your voxel model fits within the.vox format limitations, checking specifically that the.vox file size doesn't exceed 2GB.
Nowadays the.vox voxel format is pretty much exclusivelyMagicaVoxel's file format. But the history goes back toKen Silverman ofBuild Engine fame (Duke Nukem 3D). We believe MagicaVoxel originally used his.vox format which is an uncompressed voxel file format from hisSLAB6 viewer/editor, but it has evolved considerably since then.
MagicaVoxel.vox is a popular format that is easy to parse (specification) and handle thanks to open source libraries likeJustin Paver's ogt_vox.h. Many voxel assets are distributed as.vox files.
The three main limitations of.vox are the limited number of voxels it can describe, a maximum 255 colours (materials) palette, and the lack of compression.More information in our documentation.
You can use Avoyd to open and save.vox. Be aware that Avoyd can handle larger.vox files than MagicaVoxel.
⚠Game development is on hold as we concentrate on the Voxel Editor.
In Avoyd 0.26+, theprototype game is hidden in the Voxel Editor. To access it:
Settings > System.Show Prototype Game.File > Back to Main Menu, clickStart Game and choose a game type.Game and choose a game type.⚠Controls are currently hardcoded
The game uses FPS controls Mouse and Keyboard WASD. Because the game is in zero gravity you have 6 degrees of freedom movement, so there are additional controls for pitch and yaw, rolls and vertical movement:
Mouse: aim the camera, pitch and yawWASD: move forward and backwards, strafe left and rightQE: roll left and rightSpace andleft Ctrl: move up and downYou can access the full description of the movement system, weapons and build tools from AvoydSettings > Controls (from the main menu or pressEsc whilst in-game).
Theprototype game supports both single-player and cooperative multiplayer (pve).
We're pondering whether to includepvp team multiplayer. Currently we think we won't in the early versions of the game.
Avoyd is a voxel editor and renderer developed and published by enkisoftware • ©enkisoftware 2001-2025