Troubleshooting and Common Item Behavior

This page is for the issues that most often feel like "the plugin is broken" when the real problem is a workflow mismatch, tooltip misunderstanding, or naming/template mistake.

+6 armor only shows 3 armor icons

That is normal Minecraft behavior.

• tooltip armor values are armor points
• the UI bar shows half as many icons

So:

• +6 armor = 6 armor points
• that displays as 3 armor icons

A profile generated the wrong item name across materials

This usually means the profile used a fixed display or item-name string instead of a dynamic template.

Use:

{ogitemname}

or:

Hardened {ogitemname}

if one profile should work across many materials.

Hide tooltip hid more than expected

Tooltip hiding is stronger than normal flag hiding, so always test it on a real item before you mass-apply it through profiles.

If you only want cleaner hover information, use item flags and presentation defaults first.

A chat prompt seems stuck

Item Forge chat prompts can be cancelled with:

• cancel
• stop
• exit

They also time out automatically based on config.

The armor Give lane only shows leather

That is usually because the profile template has a custom leather color.

Item Forge restricts the armor generator to leather in that case so it does not pretend non-leather armor can accept leather dye.

PDC data behaved differently than expected

Check the merge mode:

• KEEP_EXISTING
• OVERWRITE

Best next pages

• placeholders, Prefixes, and Dynamic Templates
• smart Scaling, Armor Math, and Durability Math
• commands, Permissions, and Quick Admin Workflows