Enchantments

Introduction#

DeluxeSellwands supports both built-in enchantments and custom enchantments that can be configured in the enchantments.yml file. Enchantments allow you to enhance Sellwands with special effects like bonus tokens, EXP, multipliers, or even executing custom commands when selling.

Global Settings#

Located under the settings: section:

• enabled → Toggle the enchantment system on or off.
• tokens.name → Name of the enchantment currency (e.g., "tokens").
• tokens.enchantmentsWhenValueAbove → Minimum sale value required for enchantments to activate. Prevents farming with cheap items.
• tokens.playerCommands → Configure commands players can use:
  • commands → Aliases for enchantment-related commands (e.g., /wandtokens).
  • balanceCommand.enabled → Whether players can check token balance.
  • sendCommand.enabled → Whether players can send tokens to others.
• tokens.costWhenFullyUpgraded → Placeholder text shown when an enchantment is maxed.
• tokens.enchantmentsWhenNotEnchanted → Placeholder shown if no enchantments are applied.
• levelFormat → How enchantment levels are displayed (e.g., I, II, III…).
• gui → GUI settings for the enchantment menu:
  • openWith → Keybind to open GUI (SHIFT-LEFTCLICK / SHIFT-RIGHTCLICK).
  • layout → Defines the GUI shape (~ = filler, numbers = enchantment slots).
  • title → GUI title (supports placeholders).
  • items → Configure filler slots and each enchantment’s menu item.

Built-in Enchantments#

The plugin includes several built-in enchantments. You cannot rename their types (TOKENFINDER, EXPFINDER, MULTIPLIER), but you can edit their settings and levels.

📕 Options available for each enchantment:

• enabled → Toggle this enchantment on or off.
• name → Display name in menus.
• messageName → Name used in messages when the enchantment activates.
• sound → Sound effect played on activation.
• particle → Particle effect displayed on activation.
• levels → Define multiple upgrade levels.
  • cost → Token cost to purchase/upgrade.
  • chance → Chance (in %) of the enchantment activating.
  • amount → Value given when it activates (e.g., tokens, EXP, multiplier).
  • details → Lore lines shown in the GUI ({4} placeholder).

📕 Example (Token Finder):

TOKENFINDER:
   settings:
      enabled: true
      name: "&7Token Greed"
      messageName: "Token Greed"
      sound: "BLOCK_ENCHANTMENT_TABLE_USE"
      particle: "TOTEM"
      levels:
         '0':
            cost: 500
            chance: 7.5
            amount: "1-2"
            details:
            - '&7Activation Chance: &a&l7.5%'
            - '&7Tokens Amount: &a1-2 tokens'
         '1':
            cost: 1000
            chance: 10.0
            amount: "2-3"
            details:
            - '&7Activation Chance: &a&l10%'
            - '&7Tokens Amount: &a2-3 tokens'

Other built-in enchantments include:

• EXPFINDER → Grants EXP when selling.
• TOKENFINDER → Grants DeluxeSellwand Tokens when selling.
• MULTIPLIER → Temporarily multiplies earnings.

Custom Enchantments#

You can create unlimited custom enchantments under the customEnchantments: section. Unlike built-in ones, these trigger server commands when activated.

📕 Options available for custom enchantments:

• enabled → Toggle this enchantment on/off.
• name → Display name in menus.
• messageName → Name used in messages.
• sound → Sound played on activation.
• particle → Particle effect shown.
• levels → Each level can define:
  • cost → Token cost to purchase/upgrade.
  • chance → Chance (in %) to activate.
  • commands → List of commands to execute when activated. One random command will be picked.
  • details → Description shown in the GUI ({4} placeholder).

📕 Example (Spawner Finder):

customEnchantments:
   SPAWNERFINDER:
      settings:
         enabled: true
         name: "&7Spawner Looter"
         messageName: "Spawner Looter"
         sound: "BLOCK_ENCHANTMENT_TABLE_USE"
         particle: "TOTEM"
         levels:
            '0':
               cost: 500
               chance: 5
               commands:
               - 'spawner give {PLAYER} skeleton 1'
               - 'spawner give {PLAYER} zombie 1'
               details:
               - '&7Activation Chance: &a&l5%'
               - '&7Spawner Drops:'
               - ' &a• Skeleton'
               - ' &a• Zombie'

📕 Example (Mobcoin Finder):

   MOBCOINFINDER:
      settings:
         enabled: true
         name: "&7Mobcoin Finder"
         messageName: "Mobcoin Finder"
         sound: "BLOCK_ENCHANTMENT_TABLE_USE"
         particle: "TOTEM"
         levels:
            '0':
               cost: 125
               chance: 5
               commands:
               - 'mobcoin give {PLAYER} 1'
               - 'mobcoin give {PLAYER} 2'
               details:
               - '&7Activation Chance: &a&l5%'
               - '&7Mobcoins Amount: &a1-2 mobcoins'

Summary#

• Built-in enchantments (Token Greed, EXP Greed, Multiplier, etc.) come pre-configured. You can adjust costs, chances, and amounts.
• Custom enchantments let you execute any commands when a Sellwand is used — giving endless flexibility (spawners, mobcoins, crate keys, etc.).
• Use {PLAYER} in commands to target the wand user.
• Add as many levels as you want for scaling costs, chances, and rewards.

By combining built-in and custom enchantments, you can design a fully unique enchantment system for your server’s Sellwands.