Price Limiter

QuickShop provides a price limiter that lets you set minimum and maximum item prices on your server.

To edit the limit rules, you need to open price-restriction.yml file.

---

Enable the limiter

The limiter is disabled by default. Enable it before configuring the rules.

enable: true

---

Define unspecified item price limit

You can set minimum and maximum prices for items that do not match any rule.

undefined: # This option is always enabled and is not controlled by the enable option
  min: 0.01 # Can be zero if you want player create a free shop
  max: -1 # Actually this can be up to 1.7976931348623157E308

---

Create a rule

All rules are under the rules section in configuration.

rules: # Rules set
  example1: # Rules name, used for identifier and permission node (quickshop.price.restriction.bypass.<name>)
    items:
      - STONE_SWORD
      - STONE_PICKAXE
      - STONE_AXE
      - STONE_SHOVEL
      - STONE_HOE
    currency:
      - '*'
    min: 1.0
    max: 50.0

  example2:
    items:
      - GOLDEN_SWORD
      - GOLDEN_PICKAXE
      - GOLDEN_AXE
      - GOLDEN_SHOVEL
      - GOLDEN_HOE
    currency:
      - '*'
    min: 10.0
    max: 100.0

  example3:
    items:
      - DIAMOND_SWORD
      - DIAMOND_PICKAXE
      - DIAMOND_AXE
      - DIAMOND_SHOVEL
      - DIAMOND_HOE
    currency:
      - '*'
    min: 10.0
    max: 100.0

example1 and example2 are rule names. You may replace them with any clear, unique names.

items is a list of the items to which the rule applies. The item name can be:

• Bukkit Material Name
• Item Reference tag (add @ prefix)

The currency only works under Multi Currency mode.

min is the item's minimum price. max is the item's maximum price.

All items in a rule share the same price limits. Create another rule to assign different limits.

---

🆕 Wildcard Support in Item Blacklist (6.2.0.11+)

QuickShop now supports wildcard pattern matching inside item configurations.

This allows you to block entire categories of items using simple patterns instead of listing every item manually.

Supported Wildcards

Pattern	Meaning
*	Matches any number of characters
?	Matches a single character

Case-Insensitive Matching

Pattern matching is case-insensitive.

*_axe
*_AXE

Both behave the same.

---

Example Usage

Instead of writing:

items:
  - WOODEN_AXE
  - STONE_AXE
  - IRON_AXE
  - GOLDEN_AXE
  - DIAMOND_AXE
  - NETHERITE_AXE

You can now simply write:

items:
  - "*_AXE"

More Examples

Block all spawn eggs:

items:
  - "*_SPAWN_EGG"

Block all swords:

items:
  - "*_SWORD"

Use single-character matching:

items:
  - "DIAMOND_SPAWN_EG?"

---

Important Notes

• Wildcard patterns apply to Material names.
• They do not replace Item Reference (@reference) matching.
• Patterns are evaluated during rule matching.
• Wildcards reduce configuration size and improve maintainability.

---

Permission

Players who have:

quickshop.price.restriction.bypass.<rule-name>

can ignore that rule's limitation.