Перейти к содержимому
Mineforgian

ItemCoreX

ItemCoreX is a core plugin for custom items with real identity (PDC), so they can’t be faked or abused. Works great with DeluxeMenus, NPCs and other plugins. Just does what it’s supposed to do without any weird stuff.

Загрузки
101
Подписчики
1
Обновлён
26 мая 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 20 марта 2026 г.

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

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

Menu

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


🛠️ Item Editor

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.

Ченджлог

2.1Релиз26.1, 26.1.1, 26.1.2 · 26 мая 2026 г.

ItemCoreX 2.1 - Hotfix

This update improves the safety of /ic sellvanilla and the related vanilla amount placeholders.

Fixed

  • /ic sellvanilla now only sells clean, unchanged vanilla items.
  • Items with PDC/plugin data are now ignored.
  • Items with custom names, lore, enchants, custom model data, attribute modifiers or other custom metadata are ignored.
  • Custom items from ItemCoreX and other plugins are now protected from being accidentally sold as vanilla items.
  • The ItemCoreX vanilla amount placeholders now use the same strict vanilla detection.

Why this matters

Some plugins use normal Minecraft materials for custom items and store their data through PDC.

For example, a custom fish can use the same material as a normal COD, SALMON, PUFFERFISH or TROPICAL_FISH.

With this hotfix, /ic sellvanilla will only accept real vanilla items and will ignore protected/custom plugin items.

Recommended

  • Restart your server after updating.
  • If you use PlaceholderAPI and DeluxeMenus together with ItemCoreX, make sure both plugins are fully reloaded after the update.
  • Update your shop menus to use /ic sellvanilla instead of minecraft:clear when selling vanilla items.
2.0Релиз26.1, 26.1.1, 26.1.2 · 11 мая 2026 г.

🚀 ItemCoreX 2.0 - HUGE UPDATE

This update heavily modernizes ItemCoreX and introduces a much cleaner GUI-first workflow.

✨ Major Changes

  • Complete GUI overhaul
  • Improved item editor system
  • Better real-time item previews
  • Improved serialized item handling
  • Better glow handling for serialized items
  • Better GUI inventory click isolation
  • Cleaner internal architecture
  • Improved language system
  • Removed outdated legacy command systems
  • Removed unused config/lang entries
  • Improved stack size editor handling
  • Improved item consistency across GUI and commands
  • Improved logger/startup banner
  • Large internal cleanup and optimization pass

🛠️ GUI & Editor Improvements

  • Real 1:1 item previews
  • Display names now correctly use serialized item data
  • Improved item editor navigation
  • Better lore editing workflow
  • Better stack size handling
  • Cleaner editor structure
  • Improved GUI interaction handling

🔧 Cleanup

Removed outdated systems and commands:

  • Removed /ic info
  • Removed /ic list
  • Removed /ic iteminfo
  • Removed /ic setname
  • Removed /ic setglow
  • Removed /ic disable
  • Removed /ic disableall

📦 Version

1.4 → 2.0

This is a major internal and structural update for ItemCoreX.

1.4Релиз26.1, 26.1.1, 26.1.2 · 17 апреля 2026 г.

ItemCoreX 1.4 - Major Custom Item Update

Added:

  • True 1:1 custom item saving
  • Custom items now keep their original name, lore, enchantments, attributes and flags
  • Custom stack-size support for ItemCoreX items
  • Support for stack sizes beyond vanilla stack limits (up to 99)
  • To increase the stack size of a custom item, add 'stack-size: 99' to that item in customitems.yml.

Improved:

  • Much more reliable /ic create behavior for advanced custom items
  • Better support for custom weapons and attribute-based items
  • Stronger foundation for shops, upgrades and secure custom item progression

Fixed:

  • Custom items created from held items no longer lose important item data
  • Attribute modifiers are now saved correctly
  • Saved custom items now behave much closer to the original item
1.3Релиз26.1, 26.1.1, 26.1.2 · 10 апреля 2026 г.

ItemCoreX 1.3

This update adds a much safer item delivery system for custom items and improves ItemCoreX integration with PlaceholderAPI and third-party plugins.

New

  • Added a persistent pending / claim system for custom items
  • Added /ic claim for players to claim saved pending items
  • Added SQLite-based storage for pending items
  • Added auto-claim on join
  • Added join reminder if pending items still exist
  • Added new PlaceholderAPI placeholders:
    • %itemcorex_pending_total%
    • %itemcorex_has_pending%
    • %itemcorex_pending_<key>%

Improved

  • Improved custom item delivery when player inventories are full
  • Custom items are now partially delivered if possible, while the rest is saved safely
  • Claiming pending items now also supports partial delivery if the inventory is still too full
  • Improved safety against item loss and duplicate issues in claim handling
  • Improved TabCompleter behavior:
    • players now only see /ic claim
    • admin commands stay hidden from normal users
  • Improved PlaceholderAPI support for menu, NPC, UI and reward setups

Config

New claim settings in config.yml:

claim:
  auto-claim-on-join: true
  reminder-on-join: true

This update is especially useful for servers using:

DeluxeMenus
FancyNPCs
mob reward systems
PlaceholderAPI-based menus and UI
servers with custom item drops and full-inventory situations

ItemCoreX 1.3 focuses heavily on safer custom item handling in real server environments.
1.2.5Релиз1.21.11, 26.1, 26.1.1 · 5 апреля 2026 г.

Small hotfix update – sorry for the quick second release on the same day.

I found an issue after the previous version and decided to fix it immediately.

Changes in 1.2.5:

  • Added new vanilla amount placeholders
  • Improved DeluxeMenus support for Vanilla-only sell checks
  • Custom ItemCoreX items with the same base material are no longer counted as normal Vanilla items
  • This makes Vanilla shop checks much safer when using DeluxeMenus

Example: You can now use DeluxeMenus requirement checks like this:

type: '>=' input: '%itemcorex_vanilla_amount_BONE%' output: 1

This means DeluxeMenus checks the placeholder value from ItemCoreX instead of only checking the material itself.

That way:

  • real Vanilla items are counted
  • ItemCoreX custom PDC items are ignored
  • deny_commands can work again together with safe Vanilla selling

Sorry again for the quick follow-up update, and thanks for the support.

1.2Релиз1.21.11, 26.1, 26.1.1 · 5 апреля 2026 г.

ItemCoreX 1.2

Added

  • Added /ic sellvanilla <player> <material> <amount> <money>
  • Added clean separation between vanilla items and ItemCoreX custom items during selling, even if both use the same base material
  • Added full language entries for sellvanilla
  • Added sellvanilla to /ic info
  • Added tab completion for sellvanilla
  • Added automatic missing-key migration for:
    • config.yml
    • lang/en.yml
    • lang/de.yml

Improved

  • Improved DeluxeMenus / FancyNPC shop compatibility
  • Improved config and language reload workflow
  • Improved update checker console output
  • Improved plugin update safety for existing server installations

Fixed

  • Fixed missing config and language keys not being restored automatically after updating to a newer plugin version

Compatibility

  • Tested successfully on Paper 26.1.1
1.1Релиз1.21.9, 1.21.10, 1.21.11 · 28 марта 2026 г.

ItemCoreX 1.1

Added

  • Added update checker for Modrinth releases
  • Added admin join notification when a new update is available
  • Added automatic recreation of missing files on startup and reload:
    • config.yml
    • customitems.yml
    • lang/en.yml
    • lang/de.yml
  • Added /ic disable <id|key> <consume|interact|crafting|place|totem> <true|false>
  • Added /ic disableall <id|key> <true|false>

Improved

  • Improved /ic help output
  • Improved tab completion for new commands
  • Improved config and language reload workflow

Fixed

  • Fixed has translation key issue
  • Fixed update check fallback behavior when no public Modrinth release is available yet
1.0Релиз1.21.9, 1.21.10, 1.21.11 · 20 марта 2026 г.

ItemCoreX 1.0.0

Initial release of ItemCoreX.

This plugin provides a core system for custom items with a unique identity using PersistentDataContainer (PDC). Items are fully protected against fake duplicates and can be used safely across different systems.

Features

  • Custom items with unique key + ID
  • PDC-based identification (fake-proof)
  • Full command system:
    • /ic create, delete, give, take
    • /ic sell (perfect for menus / NPCs)
    • /ic inspect (with debug info and flags)
  • Control vanilla behavior per item:
    • Disable crafting usage
    • Disable consumption
    • Disable interaction
    • Disable placing
    • Disable totem effect
  • Pagination system for item lists
  • PlaceholderAPI support
  • Full language system (EN/DE)
  • Works with DeluxeMenus, FancyNPCs and LevelledMobs (I used it for these :)

Notes

This plugin is designed as a core dependency for server systems. Use commands instead of APIs to ensure maximum compatibility.

Комментарии

Загружаем…