GroupeZ Docs
Configuration

Limits

Configure purchase and sale limits in zShop

Limits allow you to restrict how many items players can buy or sell within a time period.

Limit Types

TypeDescription
serverBuyLimitServer-wide purchase limit
serverSellLimitServer-wide sale limit
playerBuyLimitPer-player purchase limit
playerSellLimitPer-player sale limit

Scheduler Types

TypeDescription
NEVERLimit never resets
DAILYResets every day
WEEKLYResets every week
MONTHLYResets every month
YEARLYResets every year

Basic Configuration

items:
  limited_item:
    type: ZSHOP_ITEM
    item:
      material: DIAMOND
    buyPrice: 100.0
    sellPrice: 50.0
    slot: 10

    # Add limits here
    playerBuyLimit:
      limit: 10
      schedulerType: DAILY
      hour: 0
      minute: 0

Limit Parameters

ParameterTypeRequiredDescription
limitIntegerYesMaximum amount
schedulerTypeEnumYesReset schedule type
hourIntegerNoHour of reset (0-23)
minuteIntegerNoMinute of reset (0-59)
dayString/IntegerNoDay for weekly/monthly
monthStringNoMonth for yearly

Examples

Daily Player Limit

Each player can buy 10 diamonds per day, resetting at midnight:

items:
  diamond:
    type: ZSHOP_ITEM
    item:
      material: DIAMOND
    buyPrice: 100.0
    sellPrice: 50.0
    slot: 10

    playerBuyLimit:
      limit: 10
      schedulerType: DAILY
      hour: 0
      minute: 0

Weekly Server Limit

Only 100 beacons can be purchased server-wide per week:

items:
  beacon:
    type: ZSHOP_ITEM
    item:
      material: BEACON
    buyPrice: 100000.0
    sellPrice: 25000.0
    slot: 11

    serverBuyLimit:
      limit: 100
      schedulerType: WEEKLY
      day: MONDAY
      hour: 0
      minute: 0

Valid day names:

  • SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY

Monthly Sell Limit

Players can sell up to 1000 iron ingots per month:

items:
  iron_ingot:
    type: ZSHOP_ITEM
    item:
      material: IRON_INGOT
    buyPrice: 15.0
    sellPrice: 5.0
    slot: 12

    playerSellLimit:
      limit: 1000
      schedulerType: MONTHLY
      day: 1  # First day of month
      hour: 0
      minute: 0

Yearly Event Item

Special item available only once per year:

items:
  christmas_gift:
    type: ZSHOP_ITEM
    item:
      material: CHEST
      name: "&c&lChristmas Gift"
    buyPrice: 0.0
    giveItem: true
    slot: 13

    playerBuyLimit:
      limit: 1
      schedulerType: YEARLY
      month: DECEMBER
      day: 25
      hour: 0
      minute: 0

Valid month names:

  • JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE
  • JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER

Permanent Limit (Never Resets)

One-time purchase item that never resets:

items:
  vip_kit:
    type: ZSHOP_ITEM
    item:
      material: NETHER_STAR
      name: "&6&lVIP Starter Kit"
    buyPrice: 50000.0
    giveItem: false
    slot: 14
    buyCommands:
      - "kit vip %player%"

    playerBuyLimit:
      limit: 1
      schedulerType: NEVER

Combined Limits

Item with both player and server limits:

items:
  rare_item:
    type: ZSHOP_ITEM
    item:
      material: DRAGON_EGG
      name: "&5&lDragon Egg"
    buyPrice: 1000000.0
    slot: 15

    # Each player can buy 1 per week
    playerBuyLimit:
      limit: 1
      schedulerType: WEEKLY
      day: MONDAY
      hour: 0
      minute: 0

    # Only 3 total available per week
    serverBuyLimit:
      limit: 3
      schedulerType: WEEKLY
      day: MONDAY
      hour: 0
      minute: 0

Buy and Sell Limits

items:
  gold_ingot:
    type: ZSHOP_ITEM
    item:
      material: GOLD_INGOT
    buyPrice: 50.0
    sellPrice: 25.0
    slot: 16

    # Can buy 100 per day
    playerBuyLimit:
      limit: 100
      schedulerType: DAILY
      hour: 0
      minute: 0

    # Can sell 500 per day
    playerSellLimit:
      limit: 500
      schedulerType: DAILY
      hour: 0
      minute: 0

Placeholders

Use these placeholders to display limit information:

PlaceholderDescription
%zshop_limit_player_buy_<material>%Player buy limit remaining
%zshop_limit_player_sell_<material>%Player sell limit remaining
%zshop_limit_server_buy_<material>%Server buy limit remaining
%zshop_limit_server_sell_<material>%Server sell limit remaining
%zshop_limit_player_buy_<material>_max%Max player buy limit
%zshop_limit_player_sell_<material>_max%Max player sell limit
%zshop_limit_server_buy_<material>_max%Max server buy limit
%zshop_limit_server_sell_<material>_max%Max server sell limit
%zshop_limit_<type>_<material>_reset%Time until reset

Lore Example with Limits

items:
  limited_diamond:
    type: ZSHOP_ITEM
    item:
      material: DIAMOND
    buyPrice: 100.0
    sellPrice: 50.0
    slot: 10
    lore:
      - ""
      - "&7Buy: &a%buyPrice%"
      - "&7Sell: &c%sellPrice%"
      - ""
      - "&7Your Limit: &e%zshop_limit_player_buy_DIAMOND%&7/&e%zshop_limit_player_buy_DIAMOND_max%"
      - "&7Resets in: &f%zshop_limit_player_buy_DIAMOND_reset%"

    playerBuyLimit:
      limit: 10
      schedulerType: DAILY
      hour: 0
      minute: 0

Data Storage

  • Server limits: Stored in plugins/zShop/limits.json
  • Player limits: Stored in plugins/zShop/players/<uuid>.json

Do not manually edit these files while the server is running. Use the plugin's reload command after any manual changes.

Best Practices

  1. Balance limits - Set reasonable limits to prevent economy abuse
  2. Use appropriate reset times - Match limits to your server's economy pace
  3. Combine limit types - Use both player and server limits for rare items
  4. Display information - Show limit status in item lore
  5. Test thoroughly - Verify limits work as expected before going live

Shop Items

Configure shop items with ZSHOP_ITEM button type

Button Types

All zShop button types for inventory configuration

On this page

Limit TypesScheduler TypesBasic ConfigurationLimit ParametersExamplesDaily Player LimitWeekly Server LimitMonthly Sell LimitYearly Event ItemPermanent Limit (Never Resets)Combined LimitsBuy and Sell LimitsPlaceholdersLore Example with LimitsData StorageBest Practices
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.