[HEADING=2]Documentation[/HEADING]

[HEADING=3]What ItemCoreX does[/HEADING]

ItemCoreX is a command-based custom item core for Paper servers.

It allows you to create real custom items with a stored identity using PDC instead of relying only on display names or lore.
This prevents renamed or faked items from being treated as valid custom items.

It is especially useful for:

• economy servers
• shops
• NPC systems
• DeluxeMenus setups
• mob drops
• quest rewards
• custom currencies

[HEADING=3]Installation[/HEADING]

1. Stop your server.
2. Put the ItemCoreX jar into your plugins folder.
3. Start the server.
4. Let the plugin generate its default files.
5. Edit the config and item files to fit your setup.
6. Restart the server or reload the plugin if supported.

[HEADING=3]Requirements[/HEADING]

• Paper server
• Modern Minecraft version matching the release

Optional depending on your setup:

• Vault or an economy plugin if you use economy-based selling
• DeluxeMenus for GUI shops
• FancyNPCs for NPC interactions
• PlaceholderAPI if placeholders are used elsewhere in your setup

[HEADING=3]Basic idea[/HEADING]

Each custom item in ItemCoreX has its own internal identity.

That means:

• renaming an item in an anvil does not make it valid
• copying the look of an item does not make it valid
• the plugin checks what the item really is, not only how it looks

This makes custom item handling much safer for real server systems.

[HEADING=3]Creating custom items[/HEADING]

Custom items are defined in the item configuration.

A typical item can contain things like:

• a key
• an internal numeric ID
• a vanilla material
• a display name
• lore
• glow
• behavior settings

Example structure:

items
↳ item key
↳ id
↳ material
↳ display-name
↳ lore
↳ glow
↳ behavior options

[HEADING=3]Behavior control[/HEADING]

ItemCoreX lets you control how a custom item behaves in vanilla Minecraft.

Depending on the item configuration, you can disable or allow things like:

• vanilla consume behavior
• vanilla interact behavior
• vanilla crafting ingredient usage
• vanilla block placing
• totem effects

This allows you to turn normal vanilla materials into:

• currencies
• relics
• quest items
• rare drop materials
• shop tokens

[HEADING=3]Commands[/HEADING]

ItemCoreX is designed to work through commands.

Useful examples:

• /ic list - shows available custom items
• /ic inspect - shows what an item really is

You can also use command-based item actions for things like:

• giving items
• taking items
• selling items

[HEADING=3]Using ItemCoreX in server systems[/HEADING]

ItemCoreX works very well in command-based server setups.

Typical use cases:

• sell custom items in DeluxeMenus shops
• use them as rewards in menus
• let NPCs give or require real items
• use them in boss or mob drops
• use them as secure economy materials

Because every item has a real internal identity, fake versions will not pass normal checks.

[HEADING=3]Why this matters[/HEADING]

Many custom item systems break once players start abusing appearance-based checks.

Examples:

• renaming vanilla items
• imitating lore
• trying to use fake items in menus or shops
• using copied-looking items in server systems

ItemCoreX avoids that by checking the stored identity instead of trusting names or lore alone.

[HEADING=3]Recommended workflow[/HEADING]

1. Create your custom items in the config.
2. Test them in-game.
3. Use inspect to verify the item identity.
4. Connect them to your menus, NPCs, or reward systems.
5. Use only real ItemCoreX items in server shops and exchanges.

[HEADING=3]Support[/HEADING]

If you want to see this plugin used in a live server environment, visit:

https://www.mcpacks.de