Introduction

Basic introduction to the plugin.

CoreItems is a powerful custom items plugin that allows server administrators to create, organize, and distribute unique items with special properties and interactive features. The plugin introduces a namespace system for better organization, an intuitive GUI for item browsing, and interactive click functionality.

CoreItems at a Glance

• YAML-Driven Configuration Define every aspect of your custom items in customs.yml, from display names and lore lines to potion effects and attribute modifiers.

• Custom Model Data & Textures Leverage resource-pack model variants seamlessly. Use custom model data IDs to map dozens of unique skins to a single base item.

• Dynamic Attributes & Effects Configure attack damage, attack speed, armor, durability, and even apply built-in potion or status effects on use.

• Interactive Abilities Bind right-click actions, cooldowns, and commands to items—create healing wands, teleport gems, or explosive shovels in minutes.

• Built-In Commands Quick management via /coreitems give, /coreitems reload, and /coreitems menu for testing and administration.

Key Features

• Create custom items with unique properties

• Organize items in namespaces

• Interactive items with click commands

• User-friendly GUI for browsing and obtaining items

• Search functionality

• Extensive customization options

Who Should Use CoreItems?

• Server Owners & Admins Craft specialized gear and balance gameplay without hiring a developer.

• Map Makers & Adventure Builders Add custom tools, quest items, and collectible artifacts to your world.

• Role-Play & Minigame Hosts Design unique equipment, power-ups, and interactive objects that elevate player immersion.

Next Steps

1. Key Concepts Learn CoreItems’ terminology—namespaces, item IDs, abilities, and placeholders.

2. Installation Follow the step-by-step guide to get CoreItems running on your server.

3. Configuration Open customs.yml and start defining your first custom item.

4. Commands & Permissions See which commands are available and how to grant players access.

Need help? Join us on Discord in the #support channel and let’s bring your item ideas to life!