> For the complete documentation index, see [llms.txt](https://docs.xandtech.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xandtech.fr/home/xplayerexp/reference/configuration-files.md).

# Default Configuration Files

Full contents of every config file XPlayerEXP ships by default, for reference. These are generated the first time the plugin starts (see [Installation & Setup](/home/xplayerexp/getting-started/getting-started.md)) — copy from here if you ever need to restore a default.

{% hint style="info" %}
Language files (`lang/*.yml`) aren't included here since there are nine of them — see [Languages & Update Checker](/home/xplayerexp/features/languages-and-updates.md) for how they work.
{% endhint %}

## config.yml

```yaml
config-version: 1 # Do not modify

lang:
  # Availables : "fr", "en", "es", "de", "it", "pt", "ja", "zh", "ru"
  default: "en"

commands:
  main: "bottlexp"
  commands-alias-enable: true
  aliases:
    - "xexp"
    - "expbottle"

  # Rename the subcommand keywords (e.g. "create" -> "creer" for a French server).
  # Restart or /bottlexp reload after changing these.
  subcommands:
    create: "create"
    give: "give"
    reload: "reload"
    doublexp: "doublexp"

permissions:
  create: "xplayerexp.bottle.create"
  use: "xplayerexp.bottle.use"
  admin-reload: "xplayerexp.admin.reload"
  admin-give: "xplayerexp.admin.give"

bottle-settings:
  # Availables modes :
  # POINTS : Remove/Add raw EXP points (vanilla system, exponential)
  # LEVELS : Remove/Add entire levels (linear system)
  calculation-mode: "LEVELS"

  # PERMISSION LOGIC:
  # 1. If a player has NONE of the listed permissions, the restriction/tax does not apply.
  # 2. If a player has MULTIPLE permissions, the plugin will always take the highest value
  #    (the most restrictive) to ensure tier compliance.

  # Minimum amount required to create a bottle
  min-exp-requirement:
    enabled: true
    permissions:
      - "xplayerexp.bottle.min.1": 5
      - "xplayerexp.bottle.min.2": 10

  # Maximum amount allowed per bottle
  max-exp-requirement:
    enabled: true
    permissions:
      - "xplayerexp.bottle.max.1": 40
      - "xplayerexp.bottle.max.2": 50

  # Percentage (%) of EXP taken as tax during creation
  tax:
    enabled: true
    permissions:
      - "xplayerexp.bottle.taxe.1": 10
      - "xplayerexp.bottle.taxe.2": 15

  # Cooldown between two bottle creations, per player.
  cooldown:
    enabled: true
    seconds: 5
    bypass-permission: "xplayerexp.bottle.cooldown.bypass"

  # Block bottle creation in specific worlds and/or WorldGuard regions.
  # Region restriction requires WorldGuard to be installed (soft-dependency, silently ignored otherwise).
  restrictions:
    enabled: false
    disabled-worlds:
      - "world_the_end"
    disabled-regions:
      - "spawn"
    bypass-permission: "xplayerexp.bottle.restriction.bypass"

  # Texts used to replace %unit% in lore and messages
  units:
    points: "EXP"
    levels: "Level(s)"

  item:
    material: "EXPERIENCE_BOTTLE"
    display-name: "&d&lExperience Bottle &7(Right-Click)"
    # Use %amount% for the value, %unit% for the label, and %player% for the creator.
    lore:
      - ""
      - "&7Contains: &a%amount% %unit%"
      - "&7Created by: &f%player%"
      - ""
      - "&e▶ Right-click to consume"

sounds:
  bottle-create:
    enabled: true
    sound: "BLOCK_ENCHANTMENT_TABLE_USE"
    volume: 1.0
    pitch: 1.0

  bottle-use:
    enabled: true
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
    volume: 1.0
    pitch: 1.0

update-checker:
  enabled: true
  check-interval-hours: 6
  notify-permission: "xplayerexp.admin.update-notify"
```

## doublexp.yml

```yaml
bonus-permissions:
  - "xplayerexp.bonus.1.5x": 1.5
  - "xplayerexp.bonus.2x": 2.0
  - "xplayerexp.bonus.3x": 3.0

commands:
  start-permission: "xplayerexp.doublexp.start"
  end-permission: "xplayerexp.doublexp.end"
  # Rename the "start"/"end" arguments of /bottlexp doublexp <start|end>.
  start: "start"
  end: "end"

# BossBar settings
bossbar:
  enabled: true
  color: "BLUE"  # RED, BLUE, GREEN, YELLOW, PURPLE, WHITE, PINK
  style: "SOLID" # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
  title: "&d&lEVENT &8» &fDouble XP &b%multiplier%x &7(%time% remaining)"

messages:
  started: "&aDouble XP event started! Multiplier: &e%x%&a for &e%duration%&a."
  ended: "&cDouble XP event ended."
  already-running: "&cA Double XP event is already running."
  not-running: "&cNo Double XP event is currently running."
  no-permission: "&cYou don't have permission to use this command."
  time-left: "&aDouble XP ends in &e%time%&a."
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.xandtech.fr/home/xplayerexp/reference/configuration-files.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.