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 1 month 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