Skip to main content
← All Guides
Plugins · 9 min read

How to Add Custom Items to Minecraft

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

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.

Related Tools & Resources

🔧

Minecraft Tools

Calculators, generators & server tools

🧱

Item Database

Browse all Minecraft items, stats & recipes

⚒️

Crafting Recipes

Visual crafting guides for every recipe