Custom Items

Custom Items

Custom Items is the simplest content module: define static items that do not need a specialized module.

Files

• Settings: modules/custom_items/settings.yml

• Items: items/basic.yml

• Bundled resources on GitHub

Commands and permissions

Alias: customitems. Shared list, get, give, drop, and reload commands require divinity.admin.

Configuration and example

Use item flags, enchantments, color, lore, and the normal tier/name fields. Static items can still be used as targets or ingredients in other modules.

Administrator notes

• The item ID is derived from the filename. Renaming it can break drops, recipes, commands, sets, and other module references.
• Use the module's get or give command for testing; vanilla /give does not create the configured item metadata.
• Back up player inventories before changing material, unbreakable state, enchantments, model data, or other persistent metadata.
• Reload, create a new item, and also inspect an old item; reloads do not necessarily rewrite items already held by players.

items/basic.yml — bundled static item

name: 'Basic Item'
lore: []
material: IRON_INGOT
color: -1,-1,-1
unbreakable: true
item-flags: []
enchantments:
  sharpness: 4

See Modules and Commands and Permissions.