ItemCoreX Documentation

ItemCoreX is built to work well in real server setups where items matter.

The plugin uses PDC-based identity, which means custom items are checked by what they actually are, not only by display name or lore.
This makes setups with DeluxeMenus, FancyNPCs, mob rewards, economy systems and server shops much safer.

--------------------------------------------------
Main player command
--------------------------------------------------

/ic claim
Claims saved pending ItemCoreX items.

If a player receives a custom item while the inventory is too full:
- the part that fits is delivered
- the rest is saved safely
- the player can later claim it with /ic claim

Optional features:
- auto-claim on join
- reminder on join if pending items still exist

--------------------------------------------------
Admin commands
--------------------------------------------------

/ic info
/ic reload
/ic create <key> <displayName>
/ic delete <id|key>
/ic give <player> <id|key> [amount]
/ic take <player> <id|key> [amount]
/ic list [page]
/ic iteminfo <id|key>
/ic setname <id|key> <name>
/ic setglow <id|key> <true|false>
/ic disable <id|key> <flag> <true|false>
/ic disableall <id|key> <true|false>
/ic inspect
/ic sell <player> <id|key> <amount> <money>
/ic sellvanilla <player> <material> <amount> <money>

--------------------------------------------------
Permissions
--------------------------------------------------

itemcorex.admin
- access to all admin commands
- default: op

itemcorex.claim
- allows players to use /ic claim
- default: true

--------------------------------------------------
PlaceholderAPI support
--------------------------------------------------

ItemCoreX supports PlaceholderAPI.

Available placeholders:
%itemcorex_amount_<key>%
%itemcorex_vanilla_amount_<MATERIAL>%
%itemcorex_pending_total%
%itemcorex_has_pending%
%itemcorex_pending_<key>%

Examples:
%itemcorex_amount_tesrei%
%itemcorex_vanilla_amount_BONE%
%itemcorex_pending_total%
%itemcorex_pending_tesrei%

This can be used in plugins like:
- DeluxeMenus
- FancyNPCs
- scoreboards
- bossbars
- HUD / actionbar systems
- other PlaceholderAPI-compatible plugins

--------------------------------------------------
Safe vanilla selling
--------------------------------------------------

ItemCoreX can safely separate:
- real vanilla items
- real ItemCoreX custom items

This is especially useful when custom items use the same vanilla material.
For example, a custom item based on BONE will not be counted as a normal vanilla BONE when using the safe vanilla placeholder:

%itemcorex_vanilla_amount_BONE%

That makes DeluxeMenus selling setups much safer.

--------------------------------------------------
Files
--------------------------------------------------

ItemCoreX uses:
- config.yml
- customitems.yml
- lang/en.yml
- lang/de.yml
- pending-claims.db

Pending claim data is stored in:
plugins/ItemCoreX/pending-claims.db

--------------------------------------------------
Notes
--------------------------------------------------

- PlaceholderAPI is optional, but required if you want to use placeholders in other plugins
- /ic claim is available to players by default
- admin commands stay protected by itemcorex.admin
- ItemCoreX is designed to avoid fake-item problems and make custom item systems much safer