ItemCoreX

ItemCoreX is the custom item system I ended up building because I got tired of fake items, messy setups and unsafe item handling.

A lot of servers use items that only look special through names or lore, but internally they are still just normal vanilla items.
That becomes a problem very quickly once players rename items, fake rewards or when menus and shop systems only check the base material.

ItemCoreX solves that by giving every custom item a real identity using PDC.

That means:

• renamed vanilla items do not become valid custom items
• fake-looking items cannot bypass your systems
• custom items can safely use the same vanilla material
• menus, rewards and economy systems become much safer
• serialized items preserve their real appearance

---

🚀 ItemCoreX 2.0

Version 2.0 is a huge modernization update.

The plugin was heavily cleaned up internally and now focuses on a full GUI-first workflow instead of old command-heavy management.

✨ What's new in 2.0

• Complete GUI overhaul
• Full live item editor
• Real 1:1 item previews
• Better serialized item handling
• Improved glow handling
• Better inventory click handling
• Cleaner language system
• Cleaner internal architecture
• Improved item consistency
• Better startup/shutdown logger
• Large cleanup of outdated systems

---

🖥️ Main GUI

The new GUI system makes item management much cleaner and easier.

You can now:

• browse all registered items
• search items directly in the GUI
• edit items live
• duplicate items
• modify stack sizes
• edit lore
• manage glow effects
• inspect serialized item previews

---

🎬 GUI Navigation

The GUI system was designed to replace most old command-heavy workflows.

---

🛠️ Item Editor

The item editor now supports:

• live editing
• real item previews
• serialized item previews
• lore editing
• glow toggles
• stack size editing
• safer item handling

---

Serialized Items

Serialized items preserve the original Minecraft item exactly as it was created.

This includes:

• display names
• lore
• enchantments
• item flags
• custom appearance
• stored item meta

That allows ItemCoreX to keep real 1:1 item previews and original item behavior intact.

If you want to fully customize names and lore directly through the ItemCoreX editor, you can remove the serialized item data at any time inside the editor.

What ItemCoreX is for

I made this for servers where items actually matter.

Especially servers using:

• custom drops
• custom currencies
• NPC rewards
• menu shops
• economy systems
• event items
• upgrade systems
• reward crates

ItemCoreX is meant to sit in the background and safely handle item identity.

No API work needed.
Everything works through commands, config files, placeholders and standard server plugin setups.

---

Main Features

• real custom item identity using PDC
• GUI-first item management
• serialized item support
• safe vanilla item selling
• PlaceholderAPI support
• pending claim system
• SQLite-based pending storage
• auto-claim support
• join reminders
• German and English language support
• configurable vanilla behavior flags

---

Why this matters

A normal plugin setup might only see something like:

BONE
EGG
CHARCOAL

ItemCoreX checks what the item actually is.

So if you build:

• DeluxeMenus shops
• NPC trades
• reward systems
• mob drops
• economy systems

the plugin can safely separate:

• real vanilla items
• real ItemCoreX items
• renamed junk pretending to be custom items

That is the whole point.

---

PlaceholderAPI Support

ItemCoreX works well with PlaceholderAPI and plugins like:

• DeluxeMenus
• FancyNPCs
• scoreboards
• HUD plugins
• bossbars
• actionbars
• menu systems

Examples:

%itemcorex_amount_<key>%
Returns the amount of a specific ItemCoreX item in the player's inventory.
Useful for DeluxeMenus checks, shop requirements, custom trades, upgrades and reward systems.

%itemcorex_vanilla_amount_<MATERIAL>%
Returns the amount of a real vanilla material in the player's inventory while ignoring ItemCoreX custom items.
Useful for safe vanilla sell menus, trade checks, buy requirements and economy setups.

%itemcorex_pending_total%
Shows the total amount of pending items.

%itemcorex_has_pending%
Shows whether the player still has pending items.

%itemcorex_pending_<key>%
Shows pending amounts for one exact custom item.

---

Full Inventory? No problem.

If a player receives items while their inventory is full:

• fitting items are delivered
• remaining items are stored safely
• players can later use /ic claim
• pending items survive restarts
• join reminders are supported

This makes reward systems and custom drops much safer.

---

Works especially well with

• DeluxeMenus
• FancyNPCs
• PlaceholderAPI
• economy servers
• custom reward systems
• mob drop systems
• menu-based server setups

---

In short

ItemCoreX is made for servers that want custom items done properly.

Not fake-looking items.
Not lore-only checks.
Not unsafe material-only selling systems.

Just real item identity, safer handling, modern GUI management and clean integration into existing server setups.