Skip to main content

​
Creating the Model

I suggest watching a tutorial on YouTube to learn how to create a model, here is a suggested one:

​
Choosing a Model Editor

  • For Simple Models: MrCrayfish’s Model Creator works well for basic guns.
  • For Advanced Models: BlockBench is recommended. It supports groups and complex display settings, making it ideal for first-person/off-hand configuration and iron sight alignment.

​
Exporting the Model

  1. Build your gun model in BlockBench.
  2. Export it as a .json file once complete.
  3. Name the file the same as the gun (e.g., ak47.json). This keeps things organized and makes it easier to update models later.
    • Note: From Minecraft 1.12+, filenames must be all lowercase

​
Adding Iron Sights

If you want to add iron sights:
  • Set first-person off-hand display values — QA uses off-hand for scoping, but it appears in the right hand.
  • Also define the third-person display values for proper iron sight positioning.
  • You can use existing models in the pack as references to copy values or setups.

​
Integrating the Model in Resource Packs

​
Minecraft 1.9 – 1.13

You’ll need to modify the diamond_axe.json file at /assets/minecraft/models/item/diamond_axe.json Find the JSON object structure that looks like this: 
{
    "predicate": {
        "damaged": 0,
        "damage": 0.0161
    },
    "model": "item/aa12"
},
Insert a new entry after the closing }, like so: 
{
    "predicate": {
        "damaged": 0,
        "damage": ID
    },
    "model": "item/MODEL"
}
Replace the placeholders: 
ID:
Calculated as 0.0161 + (0.006 * index)
(e.g., ID 27 → 0.0167, ID 28 → 0.0173, etc.)

MODEL:
The model file name (without .json)

​
Minecraft 1.14+

In 1.14+, Mojang introduced the custom_model_data tag — a cleaner way to add models. You can modify /assets/minecraft/models/item/crossbow.json and add a new entry: Here’s an example structure: 
{
    "predicate": {
        "custom_model_data": 66
    },
    "model": "item/stengun"
},
{
    "predicate": {
        "custom_model_data": 67
    },
    "model": "item/m32a1"
},
{
    "predicate": {
        "custom_model_data": 68
    },
    "model": "item/aiming"
}
Add your custom gun model: 
{
    "predicate": {
        "custom_model_data": ID
    },
    "model": "item/MODEL"
}
Replace the placeholders: 
ID:
This should match the custom_model_data value set in your plugin/mod (e.g., in the YAML config).

MODEL:
Name of your model file (no .json extension).