> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/edpets/getting-started/main-configuration.md).

# Main Configuration

Everything global lives in `config.yml`.

## Data

```yaml
data:
  method: h2            # h2 (local file, zero setup) or mysql
  save-interval: 120    # autosave interval in seconds
  mysql:
    host: localhost
    port: 3306
    database: edpets
    username: user
    password: password
```

## Pet limits

```yaml
pets:
  default-slots: 1      # active pet slots every player starts with
  max-slots: 4          # cap reachable through /pets giveslots
  default-storage: 50   # stored pets every player starts with
  max-storage: 100      # cap reachable through /pets givestorage
  level-up-sound: 'UI_TOAST_CHALLENGE_COMPLETE:0.3:2'
  default-sorting: level   # level, name, tier, usage
```

Sounds everywhere in EdPets use the `SOUND_NAME:volume:pitch` format.

## Display (the packet entities)

```yaml
display:
  default-mode: CIRCLE     # formation for players who haven't picked one
  tick-interval: 2         # mover task interval in ticks (higher = fewer packets)
  teleport-distance: 10.0  # lazy modes snap to the player past this distance
  height-offset: 1.1       # base hover height above the player's feet
  swing-animation: true    # master switch for grind swing animations
  bobbing: true            # gentle hover motion; disabling it lets the mover fully
                           # skip idle players on static formations (crowded servers)
  smooth-model-movement: true  # model pets glide via client-side interpolation
  world-blacklist: []      # worlds where pets are hidden (they stay active)
```

One **global async task** moves every pet on the server — there are no per-pet tasks and no main-thread work. See [Display Modes & Entities](/p/edpets/core/display-modes.md) for the formations and entity types.

## Booster integration

```yaml
boosters:
  display-name: '&d&lPets'
```

The name your pet boost renders under inside PinnaPrison / EdTools / EdDungeons booster GUIs.

## Lore addons

The `lore-addons` section holds the context lines appended to a pet's item in menus (equipped / click to equip / selected for bin / selected for fusion / marked for deletion / click to select). Each key is a string list.

## Default placeholders

```yaml
default-placeholders:
  enhancement: '&cNone'    # {enhancement} when the pet has none
  boost: '&cNone'          # {boost_*} when un-rolled
  progress-bar:
    length: 20
    color-done: '&a'
    color-left: '&c'
    symbol: ':'
```