Creating New Items

Introduction to items#

DeluxeSellwands includes three distinct types of items: Sellwands, Chargers, and Dischargers.
All of these can be customized and configured via the items.yml file.

Each item is fully configurable, allowing you to adjust attributes such as display names, lore, material type (including support for custom skulls and custom model data), item flags, glow, and tier-specific settings.

You can edit the default item types or create new ones to suit your needs. To add a new item, simply copy an existing section and paste it under the appropriate category, then customize the values.

📕 Available placeholders:

• Sellwands: {0} = uses, {1} = multiplier, {2} = items sold (stats must be enabled), {3} = earnings (stats must be enabled), {4} = owner (binding must be enabled).
• Chargers: {0} = uses added.
• Dischargers: no placeholders.

Sellwands#

Sellwands are special tools that allow players to sell the contents of containers (chests, barrels, hoppers, shulkers, and other 3rd party containers) directly. By default, they come in multiple tiers (Common, Uncommon, Rare, Legendary, Godly, Mythical), you can configure your own tiers as well.

📕 Configurable options for Sellwands:

• settings.typeName — How the item shows up in commands and references.
• settings.provider — Economy provider (usually VAULT, do not change unless required).
• usable_item — Configuration for the active version of the wand.
• unusable_item — Configuration for the "needs recharging" version of the wand.
• Both item sections support:
  • material, materialData, customModelData
  • name and lore
  • itemFlags
  • glow

📕 Example configuration:

items:

   sellwands:
            
      common:
         settings:
            # Note: How the item shows up in give commands, etc.
            typeName: '<GRADIENT:7f7f7f>Common</GRADIENT:4a4a4a> Sellwand'
            # Note: Do not change the provider if you don't know what you're doing.
            provider: 'VAULT'
            
         usable_item:
            # Note: To use custom skulls use 'CUSTOM_SKULL-<URL>' 1.14.4+ ONLY
            # Note: You can find custom skull URLs at https://minecraft-heads.com/custom-heads
            material: 'PAPER'
            materialData: 0
            customModelData: 1
            name: '<GRADIENT:7f7f7f>Sellwand</GRADIENT:4a4a4a> &8(&7{0}&8) ┃ <GRADIENT:7f7f7f>Common Tier</GRADIENT:4a4a4a>'
            lore:
            - ''
            - '&8• &7Right-Click &f→ <GRADIENT:7f7f7f>Sell Container</GRADIENT:4a4a4a>'
            - '&8• &7Left-Click &f→ <GRADIENT:7f7f7f>Inspect Container</GRADIENT:4a4a4a>'
            - ''
            - '{ENCHANTMENTS}'
            - ''
            - '<GRADIENT:7f7f7f>&nUsable on:</GRADIENT:4a4a4a>'
            - '&8• &7All chests'
            - '&8• &7Barrels'
            - '&8• &7Hoppers'
            - '&8• &7Shulkers'
            - ''
            - '<GRADIENT:7f7f7f>&nInformation:</GRADIENT:4a4a4a>'
            - '&8• &7Multiplier: &fx{1}'
            - '&8• &7Uses: &f{0}'
            - ''
            - '<GRADIENT:7f7f7f>&nStatistics:</GRADIENT:4a4a4a>'
            - '&8• &7Earnings: &f{3}'
            - '&8• &7Items Sold: &f{2}'
            - ''
            - '<GRADIENT:7f7f7f>Owner:</GRADIENT:4a4a4a> &f{4}'
            itemFlags:
            - 'HIDE_ATTRIBUTES'
            - 'HIDE_ENCHANTS'
            - 'HIDE_PLACED_ON'
            glow: true
            
         unusable_item:
            # Note: To use custom skulls use 'CUSTOM_SKULL-<URL>' 1.14.4+ ONLY
            # Note: You can find custom skull URLs at https://minecraft-heads.com/custom-heads
            material: 'PAPER'
            materialData: 0
            customModelData: 1
            name: '<GRADIENT:7f7f7f>Sellwand</GRADIENT:4a4a4a> &8(&cNeeds Recharging&8) ┃ <GRADIENT:7f7f7f>Common Tier</GRADIENT:4a4a4a>'
            lore:
            - ''
            - '&8[&c&l❌&8] &cThis sellwand cannot be used'
            - '&cuntil it has been re-charged!'
            - ''
            - '{ENCHANTMENTS}'
            - ''
            - '&8• &7Right-Click &f→ <GRADIENT:7f7f7f>Sell Container</GRADIENT:4a4a4a>'
            - '&8• &7Left-Click &f→ <GRADIENT:7f7f7f>Inspect Container</GRADIENT:4a4a4a>'
            - ''
            - '<GRADIENT:7f7f7f>&nUsable on:</GRADIENT:4a4a4a>'
            - '&8• &7All chests'
            - '&8• &7Barrels'
            - '&8• &7Hoppers'
            - '&8• &7Shulkers'
            - ''
            - '<GRADIENT:7f7f7f>&nInformation:</GRADIENT:4a4a4a>'
            - '&8• &7Multiplier: &fx{1}'
            - '&8• &7Uses: &f{0}'
            - ''
            - '<GRADIENT:7f7f7f>&nStatistics:</GRADIENT:4a4a4a>'
            - '&8• &7Earnings: &f{3}'
            - '&8• &7Items Sold: &f{2}'
            - ''
            - '<GRADIENT:7f7f7f>Owner:</GRADIENT:4a4a4a> &f{4}'
            itemFlags:
            - 'HIDE_ATTRIBUTES'
            - 'HIDE_ENCHANTS'
            - 'HIDE_PLACED_ON'
            glow: true

Chargers#

Chargers are consumable items used to replenish uses on a Sellwand.

📕 Configurable options for Chargers:

• settings.typeName — Name of the charger type.
• item — Visual appearance and behavior, including:
  • material, materialData, customModelData
  • name and lore (use {0} to display how many uses it restores)
  • itemFlags

📕 Example configuration:

   chargers:
   
      default:
         settings:
            # Note: How the item shows up in give commands, etc.
            typeName: 'Charger'
            
         item:
            # Note: To use custom skulls use 'CUSTOM_SKULL-<URL>' 1.14.4+ ONLY
            # Note: You can find custom skull URLs at https://minecraft-heads.com/custom-heads
            material: 'PAPER'
            materialData: 0
            customModelData: 8
            name: '&eSellwand Charger &a&o⚡ &7(&a+{0} uses&7)'
            lore:
            - ''
            - '&a• &7Uses &f→ &a+{0}'
            - ''
            - '&e&nInformation:'
            - '&6• &7Right-Click on this item to replenish'
            - '&7uses of a sellwand in your inventory!'
            - ''
            - '&4• &7This will not work on infinite-uses sellwands!'
            - ''
            itemFlags:
            - 'HIDE_ATTRIBUTES'
            - 'HIDE_ENCHANTS'
            - 'HIDE_PLACED_ON'

Dischargers#

Dischargers do the opposite of Chargers: they extract uses from a Sellwand in exchange for creating a Charger item.

📕 Configurable options for Dischargers:

• settings.typeName — Name of the discharger type.
• settings.chargerType — Which charger type it will generate after use.
• item — Visual appearance and behavior, including:
  • material, materialData, customModelData
  • name and lore
  • itemFlags

📕 Example configuration:

   dischargers:
   
      default:
         settings:
            # Note: How the item shows up in give commands, etc.
            typeName: 'Discharger'
            # Note: What type of charger to create after using the discharger.
            chargerType: 'default'
            
         item:
            # Note: To use custom skulls use 'CUSTOM_SKULL-<URL>' 1.14.4+ ONLY
            # Note: You can find custom skull URLs at https://minecraft-heads.com/custom-heads
            material: 'PAPER'
            materialData: 0
            customModelData: 7
            name: '<SOLID:ff931f>Sellwand Discharger &c&o⚡'
            lore:
            - ''
            - '<SOLID:ff931f>&nInformation:'
            - '&6• &7Right-Click on this item to discharge'
            - '&7a sellwand from your inventory, and'
            - '&7get a new charger!'
            - ''
            - '&4• &7This will not work on infinite-uses sellwands!'
            - ''
            itemFlags:
            - 'HIDE_ATTRIBUTES'
            - 'HIDE_ENCHANTS'
            - 'HIDE_PLACED_ON'

Summary#

• Sellwands: Tiered tools to instantly sell container contents.
• Chargers: Add uses back into a Sellwand.
• Dischargers: Remove uses from a Sellwand to create a Charger.

By duplicating and editing sections in items.yml, you can easily create new tiers of Sellwands, or define new Charger/Discharger types to fit your server’s economy and gameplay.