1 / 3Built interface — Item detail
Overview
Custom Items Forge adds items to a Java Edition server that vanilla clients can see. Each item is a YAML definition paired with a model and texture in the included resource pack, shown through custom model data on a base item, so players need only accept the pack. Weapons carry damage, attack speed and reach values, armour carries protection and set bonuses, and consumables carry effects and cooldowns.
Furniture blocks are placed as item display entities with a collision barrier and a rotation snap, so a table sits square in a room and a lamp lights the block it stands on. Every item can be given a rarity, a lore template, an enchantment whitelist and a crafting recipe, and the recipe appears in a chest-style crafting GUI that players open at a forge block or with a command, with the required ingredients highlighted.
The plugin reads its own item folder and can also register items already defined in ItemsAdder or Oraxen packs, so a server that has invested in one of those keeps its content and gains the stats, set bonuses and GUI from this plugin. Blockbench sources for every included model are in the download, so re-texturing a sword or extending a furniture set is a normal editing job rather than a rebuild.
Compatibility updates follow Paper releases and resource pack format changes, including the item model and component changes Mojang has made across 1.21. Config lives in items.yml, recipes.yml and gui.yml, PlaceholderAPI exposes item counts and set bonus status, and a merge tool combines the Forge pack with your existing server pack so there is one download for players.
What you get
- Paper plugin .jar with stat-bearing weapons, armour, consumables and furniture
- Resource pack with custom model data models, textures and Blockbench sources
- Chest-style crafting GUI with recipe browsing and ingredient highlighting
- items.yml, recipes.yml and gui.yml with commented examples for each item type
- Registration of ItemsAdder and Oraxen items so existing packs gain stats and recipes
- Pack merge tool that combines the Forge pack with your server resource pack
- PlaceholderAPI placeholders for set bonuses and item counts
- Compatibility updates for Paper releases and pack format changes
Eligible resources
The plan covers these resource types. Individual resources are listed in your Gaming Library as they publish.
- Item definitions
- Weapon models
- Armour sets
- Furniture blocks
- Crafting recipes
- Resource pack
Features
- Items vanilla clients see
- Models and textures load through custom model data on the server resource pack, so no player needs a mod to see a new sword.
- Stats live in YAML
- Damage, protection, effects, cooldowns and set bonuses are plain fields, so balancing an item is an edit and a reload.
- Keeps your existing packs
- ItemsAdder and Oraxen items register into the same stat and recipe system, so a server does not have to start over.
Compatibility and requirements
Works with
- Paper and Purpur 1.20.4 through 1.21.x
- ItemsAdder or Oraxen item packs, optional
- PlaceholderAPI and Vault for GUI purchases, optional
- Blockbench for editing the included model sources
You need
- A Paper or Purpur server you control
- Web space or object storage to host the merged resource pack
- Java 21 for current Paper builds
Updates and content cadence
- The full item set, resource pack and GUI from your first day
- Compatibility updates for each Paper release and resource pack format change while subscribed
- New item types and furniture sets published as they are written
License
- Licensed for one server network you own or operate.
- You may edit, re-texture and configure resources for that network.
- Reselling, sharing or re-uploading the files is not permitted.
Installation
- 1Download Custom Items Forge from your Gaming Library.
- 2Place the .jar in your plugins folder and restart to generate items.yml, recipes.yml and gui.yml.
- 3Run the merge tool against your server resource pack, upload the result and set its URL and hash in server.properties.
- 4Run /forge reload, then /forge give <item> to check a model renders on a client with the pack accepted.
If you cancel
- Access and updates continue until the end of the period you paid for.
- The licence to run the plugin and pack ends with the subscription.
- Remove the plugin and pack from live servers once access ends.
More from DistroSource Gaming
Browse all
3MinecraftPlugins
Plugin Suite
Crates, shops, custom enchants and GUI menus for Minecraft servers, maintained for new game versions.
- Plugins
- Crates
- Shops
View details$95/mo
Subscription
3MinecraftPlugins
Quest & Battlepass Pack
Written quest chains, daily objectives and a configured battlepass with reward tiers — a new season of content every month.
- Quests
- Battlepass
- Monthly drop
View details$86/mo
Subscription
3MinecraftPlugins
Quest & Progression
A Paper plugin for quest lines with branching objectives, NPC dialogue, a journal GUI, daily and weekly boards, progression tiers with rewards and a PlaceholderAPI feed for scoreboards.
- Quests
- Paper
- Update plan
View details$13/mo
Subscription
$16/mo
Custom Items Forge
