Lorenzo0111's Plugins
Discord
QualityArmory
QualityArmory
  • Installation
  • Configuration
    • Main Configuration
    • ResourcePack Configuration
  • Items Config
    • ResourcePack Model
    • Gun Configuration
    • Ammo Configuration
    • Armor Configuration
  • Developers
    • Adding the Dependency
    • QualityArmory API
  • Downloads
    • SpigotMC
    • Modrinth
    • CurseForge
Powered by GitBook
On this page
  • Choosing a Model Editor
  • Exporting the Model
  • Adding Iron Sights
  • Integrating the Model in Resource Packs

Was this helpful?

Edit on GitHub
Export as PDF
  1. Items Config

ResourcePack Model

PreviousResourcePack ConfigurationNextGun Configuration

Last updated 25 days ago

Was this helpful?

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.

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).

For Advanced Models: is recommended. It supports groups and complex display settings, making it ideal for first-person/off-hand configuration and iron sight alignment.

BlockBench