Getting Started

Installing the Voxel Dungeons Resource Pack

Step-by-step guide for installing Voxel Dungeons resource packs in Minecraft 1.21.4+. Includes new commands, folder structure, and plugin integration support.

Welcome to the Voxel Dungeons Installation Guide! This page will walk you through the process of installing your newly purchased assets into a Minecraft resource pack, using them in-game immediately, and understanding how to expand their use with server-side plugins.

Whether you're a server administrator, a mapmaker, or a solo builder looking to enhance your world, this guide ensures you can start using your new 3D models, items, and equipment right away.

[Step 1: Locate the Voxel Dungeons Folder](id-step1)

After downloading your purchased .zip file from our storefront, open the archive and locate the folder titled voxeldungeons. This folder contains the models, textures, and necessary namespace configuration for your assets.

Downloads folder on a windows, with the Voxel Dungeons zip file highlighted.

This folder is the core namespace. It contains the custom models, textures, and supporting files needed for Minecraft to recognize and display your new assets correctly. This includes:

  • items/ — Minecraft control files, used for generating items in-game.
  • models/ — 3D item JSON files
  • textures/ — texture maps and sprites for each model
📌 Do not rename this folder. The namespace is referenced in Minecraft’s internal systems and any changes will break item rendering or compatibility with plugins.

[Step 2: Add the Folder to Your Minecraft Resource Pack](id-step2)

To add these assets to your game, you’ll need to insert the voxeldungeons folder into a Minecraft-compatible resource pack structure.

If you already have a resource pack:

1. Open your Minecraft resource pack directory: .minecraft/resourcepacks/{yourpack}/assets/

2. Drag the voxeldungeons folder from the .zip into the assets directory of your pack.

3. Ensure it sits alongside the minecraft folder (not inside it).


📌 Important: Do not rename the voxeldungeons folder — this will break the namespace references required to display items correctly.
Click and drag the "volxeldungeons" folder from your .zip into your resource pack assets folder.

If you don’t have a pack yet:

You can go ahead and create a new one yourself:


1. Inside .minecraft/resourcepacks, create a new folder (e.g., "My_Resource_Pack").

2. Inside that, create a pack.mcmeta file (see below) and an assets/ folder.

3. Place the voxeldungeons folder inside assets/.


📌 Learn to make an pack.mcmeta pack here: Tutorials/Creating a resource pack (Minecraft Wiki)

[Step 3: Enable and Test the Pack In-Game](id-step3)

Once the resource pack is in the correct structure:


1. Launch Minecraft (Java Edition 1.20 or higher).

2. Open the menu, select Options > Resource Packs.

3. Locate your pack in the left-hand list. Click the arrow to move it to the right (active).

4. Click "Done" and wait for Minecraft to reload the assets.


If installed correctly, Minecraft will now recognize the voxeldungeons namespace and render your 3D models and textures as configured.

Use This Command to Spawn a Sample Item

To instantly preview your new items in-game, use Minecraft's built-in /give command. Example:


/minecraft:give @p iron_sword[item_model="voxeldungeons:collection/vd_collection_pack_type_id_control"] 1

  • iron_sword - Can be replaced with any Minecraft vanilla item you want to the model to be applied to.
  • voxeldungeons:{id} - Is the reference model control file in the items/ folder of the voxeldungeons resource pack.

[Frequently Asked Questions](id-faq)

How do Minecraft items and folder structure work?

All Voxel Dungeons assets follow the updated Minecraft 1.21+ structure, using model control files in the items/ folder to drive multiple draw states and sprite behaviors. The asset pack includes three key folders inside the voxeldungeons namespace:


Folder
Description
items/

Holds item control .json files that define how in-game items behave and which 3D models they use (used for swords, shields, bows, etc.)

models/

Contains standalone 3D model .json files (usually exported from Blockbench)

textures/

Holds PNG textures and sprite sheets used by the models


Why doesn't the model appear?

  • Ensure your command includes the exact item_model path.
  • Double-check your folder structure: voxeldungeons/items/... must exist inside assets/
  • Confirm your resource pack is active and prioritized above others.
  • Can I use these models in multiplayer?

    Yes! As long as all players have the resource pack installed (manually or via a server pack), the models will render for everyone.

    Can I change the namespace or file names?

    We strongly advise against renaming the namespace (voxeldungeons) or changing folder/file names. Doing so will break all references and require you to manually remap hundreds of files.

    What version of Minecraft is required?

    All Voxel Dungeons resource packs are currently designed for:

    • Minecraft Java Edition 1.21.4 and above
    • ❌ Bedrock Edition is not supported at this time

    Where do I find all item_model names and commands?

    Each product includes a Asset_List.txt file listing:

    • Item names
    • Suggested base items
    • Full item_model paths
    • Usage notes for plugin configs and command blocks
    Voxel Dungeons is a product of © 2024 - Yora Entertainment Inc. All rights reserved. Unaffiliated with Mojang AB or the Microsoft Corporation.