Wiki
Item Forge Wiki
Custom item editing, profile automation, smart scaling, batch workflows, and admin-friendly generation docs for Item Forge.
Getting Started
Start here for install, first boot, and the three main editing lanes.
Naming and Templates
Get display name, item name, lore, placeholders, and prefix behavior right before you mass-generate items.
Profiles and Automation
Build reusable modifier workflows, scale item math, and generate outputs from the Give menu.
Item Editing Systems
Trim, dye, attribute, hide, model, and tag items without dropping into raw NBT tooling.
Operations and Support
Teach admins the command surface, the built-in help surfaces, and the troubleshooting path for common item issues.
Item Forge targets Paper 1.21.10 on Java 21.
The plugin's job is simple: give admins a reliable in-game surface for editing custom items and generating reusable item profiles without needing to hand-author every item in YAML or rebuild every variant manually.
What to install
Place the Item Forge jar in your server's plugins folder and boot the server normally.
Current project build output:
target/itemforge-1.0.4.jar
What should generate on first boot
On first startup, Item Forge should create:
plugins/ItemForge/plugins/ItemForge/profiles/plugins/ItemForge/config.yml
Profiles are stored as one file per profile:
plugins/ItemForge/profiles/*.yml
The config areas that matter first
The generated config.yml is intentionally small. The important parts are:
gui.title-prefixbranding.chat-prefixchat-input.timeout-secondschat-input.cancel-wordsprofiles.default-template-materialprofiles.pdc-merge-defaultpresentation.hide-upgrades-by-defaultpresentation.hidden-item-flags
First validation checklist
After boot:
- Confirm the console shows Item Forge enabled cleanly.
- Join as an operator or a player with
itemforge.use. - Run
/if. - Confirm the main menu opens.
- Hold a normal item and test the main-hand editor.
- Run
/if helpand/if placeholdersto confirm the help and placeholder surfaces open.
Permissions
Item Forge currently exposes:
itemforge.useitemforge.reload
Common first-boot mistakes
The menu opens, but nothing edits
Usually that means:
- the player is not holding an item for main-hand editing
- the wrong editing lane was opened
- a chat prompt is still waiting for input
The plugin boots, but profiles look empty
That is normal on a clean install. Profiles are created as you save them or as you create preset profiles.
The item tooltip looks cleaner than vanilla
That is also normal. By default, Item Forge hides upgrade-style tooltip noise through default hidden flags unless you switch an item into manual flag mode.