GroupeZ Docs

Price Modifiers

Configure permission-based price modifications

Cette page est affichée en anglais car sa traduction française n’est pas encore disponible.

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

Suivant

Sur cette 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

La documentation dans ton IA

Le MCP permet à ton IA de chercher dans la documentation GroupeZ et de lire les exemples à jour pour t’aider à configurer tes plugins.

Lecture seule · Sans clé API côté documentation

1. Copie l’adresse du serveur

Transport : HTTP (Streamable HTTP). Authentification : aucune. Ton outil utilise son propre modèle et ses propres limites d’abonnement.

  1. Ouvre Plugins dans ChatGPT sur le web, puis + → Ajouter un serveur MCP personnalisé.
  2. Nomme-le « GroupeZ Documentation », colle l’URL ci-dessus et choisis « Aucune authentification ». Crée puis installe le plugin.
  3. Dans une conversation, tape @ et sélectionne ce plugin avant d’envoyer ta question. Si nécessaire, active search, get_page et list_pages dans ses paramètres.
Guide officiel de cet outil

3. Pose une question

Utilise le MCP GroupeZ pour m’aider à créer un inventaire zMenu. Recherche les pages pertinentes, lis les exemples et cite tes sources.
Autres clients et dépannage

Pour les clients utilisant mcpServers, adapte cet exemple à leur format :

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

Les outils disponibles sont search, get_page et list_pages. Après une mise à jour, actualise les outils du connecteur. Si ton IA n’y accède pas, vérifie que le connecteur est activé dans la conversation et que ton compte autorise les MCP personnalisés. Ouvrir l’URL dans un navigateur n’est pas un test MCP.