Skip to main content
Plugins

How to Add Custom Items to Minecraft

Add custom items to your Minecraft server with ItemsAdder, Oraxen or MMOItems, models, textures, recipes and balance.

9 min read8 sectionsJava & Bedrock1.21

Custom items, new swords, ranged weapons, food, tools, cosmetics, are how a Minecraft server stops looking like every other Minecraft server. This guide compares the three main custom-item plugins in 2026 and gets you a working item.

The big three

PluginLicenseBest for
ItemsAdderPaidCosmetics, blocks, custom GUIs, full visual overhaul
OraxenPaid (was free)Custom items + blocks with great default textures
MMOItemsPaidRPG stats, tiers, sets, upgrade systems

Free alternatives

If you only need a handful of custom items:

  • Vanilla NBT + ResourcePack CMD, use CustomModelData on a vanilla item with a resource pack model.
  • ItemEdit / ItemNBT, rename, lore, enchant, attribute modifiers.
  • Skript, create items in code, give via commands, drop from MythicMobs drop tables.

Resource packs and CustomModelData

All three plugins use CustomModelData on vanilla items so you don't need a client mod. Players just accept the auto-prompted resource pack on join. Set the prompt in server.properties:

resource-pack=https://example.com/pack.zip
resource-pack-sha1=<sha1 of pack.zip>
require-resource-pack=true

Example: a custom sword in Oraxen

Create plugins/Oraxen/items/swords.yml:

flame_blade:
  displayname: '&6Flame Blade'
  material: IRON_SWORD
  Pack:
    custom_model_data: 1001
    model: default/flame_blade
  AttributeModifiers:
   - {AttributeName: generic.attack_damage, Amount: 9, Operation: 0, Slot: mainhand}
  Mechanics:
    fire: {seconds: 3}

Give in-game: /oraxen give Steve flame_blade.

Recipes

All three plugins let you bind a custom recipe to your custom item. Oraxen example (in the same item file):

Recipe:
  shaped:
    rows:
     - " B "
     - " B "
     - " S "
    ingredients:
      B: BLAZE_ROD
      S: NETHERITE_INGOT

Balance and rarity

Custom items are easy to break a server with. Hard rules:

  • Cap stat increases per item (no +50 damage swords).
  • Tag rarity in the lore so players see why one item is better.
  • Don't let crafting recipes use only common materials, mix in crate-only ingredients to gate progression.

Common pitfalls

  • Resource pack hosted on a slow CDN, first-join takes 30s and players quit.
  • SHA-1 mismatch, players see "broken pack". Re-hash whenever you re-upload.
  • Custom items losing their NBT after going through a vanilla recipe (e.g. anvil rename).

Looking for a server that nails this setup end-to-end? Try Astroworld MC, economy survival, custom bosses, full crossplay.

Questions about Add Custom Items to Minecraft

Why would you set up Add Custom Items to Minecraft at all?

Custom items, new swords, ranged weapons, food, tools, cosmetics, are how a Minecraft server stops looking like every other Minecraft server.

How much does Add Custom Items to Minecraft actually need?

Resource pack hosted on a slow CDN, first-join takes 30s and players quit.

Which command does Add Custom Items to Minecraft use?

Set the prompt in server.properties: Create plugins/Oraxen/items/swords.yml: Give in-game: /oraxen give Steve flame_blade. This guide uses /oraxen give Steve flame_blade.

Where does Add Custom Items to Minecraft store its settings?

Set the prompt in server.properties: Create plugins/Oraxen/items/swords.yml: Give in-game: /oraxen give Steve flame_blade.

What separates the options in Add Custom Items to Minecraft?

For ItemsAdder, the table on this page lists License: Paid, Best for: Cosmetics, blocks, custom GUIs, full visual overhaul.

What should you avoid while doing Add Custom Items to Minecraft?

All three plugins use CustomModelData on vanilla items so you don't need a client mod.

How to Add Custom Items to Minecraft: Add custom items to your Minecraft server with ItemsAdder, Oraxen or MMOItems, models, textures, recipes and balance.
How to Add Custom Items to Minecraft, from the Plugins guides on Astroworld.

More guides on this site

More Plugins Guides

Related Tools & Databases