FAQ
Find answers to the most common questions about CoreItems.
General
Which Minecraft server versions are supported? CoreItems is meant to run on Spigot and Paper for Minecraft 1.21. We test on the latest stable releases and try to maintain as much backward compatibility for minor versions.
Where can I find the full documentation? Every section—from installation to troubleshooting—is available in the sidebar of this docs site. Bookmark it for quick access!
Configuration
Where do I define my custom items? All custom items go in a single file per namespace:
Under
plugins/CoreItems/customs/, create a folder named for your namespace (for example,weaponsortools).Inside that folder, edit customs.yml and list all your item definitions there.
What are namespaces and how do I reference items?
Namespaces help you group related items. Each folder under plugins/CoreItems/customs/ is a namespace. Items are identified as:
For example, an item with key diamond_sword in the weapons folder becomes weapons:diamond_sword.
How do I reload CoreItems after editing configs? Run
in-game or from the console. This re-reads your YAML files and updates all items without a server restart.
Customization
Why aren’t my custom textures appearing?
Make sure your resource pack is installed and active.
Verify the
custom-model-datavalue in your YAML matches the model ID in your pack’s JSON.Have players re-download and apply the updated pack.
How do I set CustomModelData for an item? In your item’s entry inside customs.yml, include:
That number must match the ID used in your resource pack’s model definition.
Commands & Permissions
Which commands does CoreItems provide?
/coreitems give <player> <namespace:item_key> [amount]— Give a custom item/coreitems reload— Reload all item configs/coreitems list— List every registered custom item/coreitems menu— Open the in-game item browser GUI
What permission nodes are available?
coreitems.command.give— Allows/coreitems givecoreitems.command.reload— Allows/coreitems reloadcoreitems.command.list— Allows/coreitems listcoreitems.command.menu— Allows/coreitems menuGrantcoreitems.command.*for full command access.
Troubleshooting
My items aren’t showing in /coreitems list or the GUI
Check for YAML syntax errors in customs.yml.
Confirm your namespace folder name and item keys are correct.
Run
/coreitems reloadand check server logs for loading errors.
I see “Failed to load item” errors in console
Ensure required properties (material, display name, custom-model-data) exist.
Verify any bound commands or effects are valid.
Inspect the full stack trace in logs to identify the problem.
Support
Where can I get help or report bugs? Join our Discord in the #support channel. We welcome bug reports, feature requests, and feedback!
Last updated