GroupeZ Docs

Price Modifiers

Configure permission-based price modifications

Price modifiers allow you to give players bonuses or discounts based on their permissions. This is perfect for VIP perks, donor ranks, or special promotions.

Configuration

Price modifiers are configured in config.yml:

pricesModifier:
  - permission: "zshop.prices.vip"
    type: SELL
    modifier: 1.5

  - permission: "zshop.prices.mvp"
    type: SELL
    modifier: 2.0

  - permission: "zshop.prices.vip.buy"
    type: BUY
    modifier: 0.9

Parameters

ParameterTypeDescription
permissionStringPermission node required
typeEnumBUY or SELL
modifierDoubleMultiplier applied to price

Modifier Types

SELL Modifier

Multiplies the sell price for players with the permission:

- permission: "zshop.prices.vip"
  type: SELL
  modifier: 1.5  # Sell for 50% more

Example:

  • Base sell price: $100
  • With 1.5x modifier: $150

BUY Modifier

Multiplies the buy price for players with the permission:

- permission: "zshop.prices.vip.buy"
  type: BUY
  modifier: 0.9  # Buy for 10% less

Example:

  • Base buy price: $100
  • With 0.9x modifier: $90

Common Configurations

Tiered Sell Bonuses

pricesModifier:
  # Basic VIP: +25% sell price
  - permission: "zshop.rank.vip"
    type: SELL
    modifier: 1.25

  # VIP+: +50% sell price
  - permission: "zshop.rank.vip_plus"
    type: SELL
    modifier: 1.5

  # MVP: +75% sell price
  - permission: "zshop.rank.mvp"
    type: SELL
    modifier: 1.75

  # MVP+: +100% sell price (double)
  - permission: "zshop.rank.mvp_plus"
    type: SELL
    modifier: 2.0

Buy Discounts

pricesModifier:
  # VIP: 5% discount
  - permission: "zshop.discount.vip"
    type: BUY
    modifier: 0.95

  # VIP+: 10% discount
  - permission: "zshop.discount.vip_plus"
    type: BUY
    modifier: 0.90

  # MVP: 15% discount
  - permission: "zshop.discount.mvp"
    type: BUY
    modifier: 0.85

  # MVP+: 20% discount
  - permission: "zshop.discount.mvp_plus"
    type: BUY
    modifier: 0.80

Combined Buy and Sell

pricesModifier:
  # VIP gets both bonuses
  - permission: "zshop.vip.sell"
    type: SELL
    modifier: 1.25
  - permission: "zshop.vip.buy"
    type: BUY
    modifier: 0.95

  # MVP gets better bonuses
  - permission: "zshop.mvp.sell"
    type: SELL
    modifier: 1.5
  - permission: "zshop.mvp.buy"
    type: BUY
    modifier: 0.90

Setting Up Permissions

LuckPerms

# Create VIP group with sell bonus
lp creategroup vip
lp group vip permission set zshop.rank.vip true

# Give to a player
lp user <player> parent add vip

PermissionsEx

# Give permission to group
pex group vip add zshop.rank.vip

# Give to a player
pex user <player> group add vip

Modifier Priority

When a player has multiple modifiers:

  • Only the highest applicable modifier is used (they don't stack)
  • Order in config determines priority if values are equal

Example:

pricesModifier:
  - permission: "zshop.rank.vip"
    type: SELL
    modifier: 1.25
  - permission: "zshop.rank.mvp"
    type: SELL
    modifier: 1.5

If a player has both permissions, they get the 1.5x modifier (highest).

Excluding Items from Modifiers

Some items can be excluded from price modifiers:

items:
  fixed_price_item:
    type: ZSHOP_ITEM
    item:
      material: BEDROCK
    buyPrice: 1000000.0
    sellPrice: 500000.0
    affectByPriceModifier: false  # No bonuses apply
    slot: 10

Displaying Modifier Status

Use placeholders to show players their active modifier:

# In item lore
lore:
  - ""
  - "&7Your sell bonus: &a%zshop_modifier_sell%x"
  - "&7Your buy discount: &a%zshop_modifier_buy%x"

Event Modifiers

Create temporary event modifiers with permission plugins:

Double Sell Weekend (LuckPerms)

# Create temporary permission
lp group default permission settemp zshop.event.double_sell true 2d

# Add the modifier in config.yml
pricesModifier:
  - permission: "zshop.event.double_sell"
    type: SELL
    modifier: 2.0

Holiday Sale

# 25% discount for all players during holiday
lp group default permission settemp zshop.event.holiday_sale true 7d
pricesModifier:
  - permission: "zshop.event.holiday_sale"
    type: BUY
    modifier: 0.75

Complete Example

pricesModifier:
  # ===== Rank-based Sell Bonuses =====
  # VIP: +25%
  - permission: "zshop.sell.vip"
    type: SELL
    modifier: 1.25

  # VIP+: +50%
  - permission: "zshop.sell.vipplus"
    type: SELL
    modifier: 1.50

  # MVP: +75%
  - permission: "zshop.sell.mvp"
    type: SELL
    modifier: 1.75

  # MVP+: +100%
  - permission: "zshop.sell.mvpplus"
    type: SELL
    modifier: 2.00

  # Legend: +150%
  - permission: "zshop.sell.legend"
    type: SELL
    modifier: 2.50

  # ===== Rank-based Buy Discounts =====
  # VIP: 5% off
  - permission: "zshop.buy.vip"
    type: BUY
    modifier: 0.95

  # VIP+: 10% off
  - permission: "zshop.buy.vipplus"
    type: BUY
    modifier: 0.90

  # MVP: 15% off
  - permission: "zshop.buy.mvp"
    type: BUY
    modifier: 0.85

  # MVP+: 20% off
  - permission: "zshop.buy.mvpplus"
    type: BUY
    modifier: 0.80

  # Legend: 25% off
  - permission: "zshop.buy.legend"
    type: BUY
    modifier: 0.75

  # ===== Event Modifiers =====
  # Double sell event
  - permission: "zshop.event.doublesell"
    type: SELL
    modifier: 2.00

  # Half price event
  - permission: "zshop.event.halfprice"
    type: BUY
    modifier: 0.50

Button Types

All zShop button types for inventory configuration

Placeholders

Next Page

On this page

ConfigurationParametersModifier TypesSELL ModifierBUY ModifierCommon ConfigurationsTiered Sell BonusesBuy DiscountsCombined Buy and SellSetting Up PermissionsLuckPermsPermissionsExModifier PriorityExcluding Items from ModifiersDisplaying Modifier StatusEvent ModifiersDouble Sell Weekend (LuckPerms)Holiday SaleComplete Example
GroupeZ MCP

Documentation in your AI

MCP lets your AI search GroupeZ documentation and read current examples to help you configure your plugins.

Read-only · No documentation API key needed

1. Copy the server URL

Transport: HTTP (Streamable HTTP). Authentication: none. Your tool uses its own model and subscription limits.

  1. Open Plugins in ChatGPT on the web, then + → Add custom MCP server.
  2. Name it ‘GroupeZ Documentation’, paste the URL above and choose ‘No authentication’. Create and install the plugin.
  3. In a conversation, type @ and select the plugin before asking. If needed, enable search, get_page and list_pages in its settings.
Official setup guide

3. Ask a question

Use GroupeZ MCP to help me create a zMenu inventory. Search relevant pages, read the examples and cite your sources.
Other clients and troubleshooting

For clients using mcpServers, adapt this example to their format:

{
  "mcpServers": {
    "groupez-docs": {
      "url": ""
    }
  }
}

Available tools are search, get_page and list_pages. Refresh the connector’s tools after updates. If your AI cannot access them, check that the connector is enabled in the conversation and your account allows custom MCP servers. Opening the URL in a browser is not an MCP test.