GroupeZ Docs
Configuration

Main Configuration

Main configuration options for zCookieClicker

This page covers the main configuration options available in config.yml.

Database Configuration

Configure how player data is stored.

sql:
  type: SQLITE  # SQLITE, MYSQL, or MARIADB
  user: homestead
  password: secret
  port: 3306
  host: 192.168.10.10
  database: zcookieclicker
  prefix: "zcookieclicker_"
  retry: 5
  debug: false
OptionDescription
typeStorage type: SQLITE, MYSQL, or MARIADB
userDatabase username
passwordDatabase password
portDatabase port
hostDatabase host address
databaseDatabase name
prefixTable name prefix
retryNumber of connection retry attempts
debugEnable SQL query debugging

Price Scaling

Configure how upgrade prices increase with each purchase:

price-upgrade-percent: 15

This means each upgrade purchase increases the next purchase price by 15%.

Example with 15% increase:

  • First Grandma: 100 cookies
  • Second Grandma: 115 cookies
  • Third Grandma: 132.25 cookies
  • And so on...

Number Formatting

Standard Decimal Format

decimal-format: "#,###.#"

This format is used when short number format is disabled.

Short Number Format

For large numbers, enable short format with suffixes:

short-number-format:
  enabled: true
  decimal-format: "#.##"
  suffixes:
    - ""       # < 1,000
    - "K"      # Thousands
    - "M"      # Millions
    - "B"      # Billions
    - "T"      # Trillions
    - "Qa"     # Quadrillions
    - "Qi"     # Quintillions
    - "Sx"     # Sextillions
    - "Sp"     # Septillions
    - "Oc"     # Octillions
OptionDescription
enabledEnable/disable short number formatting
decimal-formatDecimal format pattern for short numbers
suffixesList of suffixes for each magnitude

Examples:

ValueFormatted
500500
1,2341.23K
5,678,9015.68M
1,234,567,8901.23B

Complete Example Configuration

# Database configuration
sql:
  type: SQLITE
  user: homestead
  password: secret
  port: 3306
  host: 192.168.10.10
  database: zcookieclicker
  prefix: "zcookieclicker_"
  retry: 5
  debug: false

# Price increase percentage per upgrade purchase
price-upgrade-percent: 15

# Standard number format
decimal-format: "#,###.#"

# Short number format for large numbers
short-number-format:
  enabled: true
  decimal-format: "#.##"
  suffixes:
    - ""
    - "K"
    - "M"
    - "B"
    - "T"
    - "Qa"
    - "Qi"
    - "Sx"
    - "Sp"
    - "Oc"

# Upgrade definitions (see Upgrades page for details)
upgrades:
  - type: "MANUAL_CLICK"
    cost: 10
    cps: 0.1
  # ... more upgrades

Configuration Tips

Balancing Price Scaling

  • Lower percentage (5-10%): Faster progression, easier to buy many upgrades
  • Standard percentage (15%): Balanced progression similar to original Cookie Clicker
  • Higher percentage (20-30%): Slower progression, more grinding required

Number Format Customization

You can customize suffixes for your server's language:

# French example
suffixes:
  - ""
  - "K"
  - "M"
  - "Md"    # Milliard (Billion in French)
  - "T"

Database Recommendations

  • Single Server: Use SQLite for simplicity
  • Multiple Servers: Use MySQL/MariaDB (note: data is not synchronized, just stored remotely)
  • Large Player Base: Use MySQL/MariaDB with connection pooling

Placeholders

PlaceholderAPI placeholders available in zCookieClicker

Upgrades

Configure upgrades in zCookieClicker

On this page

Database ConfigurationPrice ScalingNumber FormattingStandard Decimal FormatShort Number FormatComplete Example ConfigurationConfiguration TipsBalancing Price ScalingNumber Format CustomizationDatabase Recommendations
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.