Key Concepts

Before you start defining your own items, get familiar with these core ideas that power CoreItems.

Custom Items

Custom items are more than just renamed gear—they can have unique display names, lore, attributes, enchantments, custom model data, and built-in behaviors. You declare each item’s properties in items.yml, and CoreItems handles giving it the right texture, stats, and functionality in-game.

Namespaces

Namespaces let you organize items into separate folders and files. Each namespace corresponds to its own subdirectory under plugins/CoreItems/items/, so you can group related items (weapons, tools, cosmetics, etc.) into logical collections. This keeps your configs clean and makes it easy to share or swap out entire sets of items.

GUI System

CoreItems automatically generates a user-friendly GUI that players can open (e.g. via /core menu) to browse every custom item you’ve defined. The GUI supports pagination, search, and category tabs based on your namespaces, allowing players to find and obtain items without memorizing commands.

Interactive Commands

Beyond passive attributes, items can execute commands when clicked. You can bind both left- and right-click actions to any console command (including placeholders like {player} or {world}), with configurable cooldowns. This lets you create healing wands, teleport gems, custom effect potions, or virtually any interactive tool—entirely through your YAML configuration.