Main Configuration

The config.yml file lives in plugins/EnhancedEchest/. It controls language, chest size, temporary chests, the storage backend, cross-server mode, automatic backups, and migration behavior.

Click any option or group below for more details.

Apply changes without a restart

After editing config.yml, run /ee reload in-game or from the console to apply your changes.

language:en_US

language-auto-detect:true

enderchest:

default-size:54

list-menu:dialog

shift-click-list:true

features.rename:true

features.icon:true

features.sort:false

features.sort-cooldown:10s

features.rename-blacklist:

-'server'

-'admin'

-'staff'

-'owner'

features.rename-colors:true

commands:

suggest-offline-within:30d

temp-enderchest:

expiry:7d

check-interval:5m

auto-reclaim:true

reclaim-notify.enabled:true

reclaim-notify.sound.enabled:true

reclaim-notify.sound.key:minecraft:entity.player.levelup

deny-sound.enabled:true

deny-sound.key:minecraft:entity.villager.no

database:

type:sqlite

table-prefix:echest_

autosave-interval:3m

sqlite-file:enderchests.db

host:localhost

port:3306

database:enhancedechest

username:root

password:

ssl:disable

pool-size:10

cross-server:

enabled:false

server-id:

redis.host:localhost

redis.port:6379

redis.password:

redis.ssl:false

redis.database:0

redis.key-prefix:echest:

backup:

enabled:true

interval:6h

keep:10

on-startup:false

folder:backups

activity-log:

enabled:false

log-unchanged:false

shulker-contents:true

chest-contents:true

queue-capacity:4096

max-file-size-mb:64

retention-days:14

migration:

enabled:false

Full Example

# EnhancedEchest configuration

language: en_US
language-auto-detect: true

enderchest:
  # Slot count of the chest auto-created the first time a player opens their ender chest.
  # Must be a multiple of 9, between 9 and 54.
  # Per-player override is available via the enhancedechest.default_size.<size> permission (no config).
  default-size: 54

  # How /eclist is shown: "dialog" (default, full Edit-mode menu) or "inventory" (a plain chest GUI
  # that only lists chests; click to open). The inventory menu grows 27 -> 36 -> 45 -> 54 slots and
  # holds up to 28 chests; players with more than 28 chests always get the dialog menu.
  list-menu: dialog

  # Open the chest list (same menu as /eclist) with shift + right-click on an ender chest block.
  shift-click-list: true

  # Server-wide switches for the "Edit mode" buttons (Rename / Choose icon / Sort).
  features:
    rename: true
    icon: true
    sort: false
    sort-cooldown: 10s
    rename-blacklist:
      - server
      - admin
      - staff
      - owner
    rename-colors: true

commands:
  # Only suggest offline players seen within this long. 'all' suggests everyone.
  suggest-offline-within: 30d

temp-enderchest:
  # Lifetime of a temporary chest created on shrink/delete/expire-with-items.
  expiry: 7d
  # How often the plugin scans for expired chests.
  check-interval: 5m
  # Move a temporary chest's items into a new, empty chest that is large enough for them.
  auto-reclaim: true
  # Tell the player which chest those items were moved into.
  reclaim-notify:
    enabled: true
    sound:
      enabled: true
      key: minecraft:entity.player.levelup
  # Sound played to a player who tries to deposit into a take-only temporary chest.
  deny-sound:
    enabled: true
    key: minecraft:entity.villager.no

database:
  # Storage backend: sqlite | mysql | mariadb | postgres
  type: sqlite
  # Prepended to every table this plugin creates. Letters, digits and underscore only.
  table-prefix: echest_
  # How often in-memory changes are written back to the database. Minimum 30s.
  autosave-interval: 3m
  sqlite-file: enderchests.db
  host: localhost
  port: 3306
  database: enhancedechest
  username: root
  password: ""
  # Require an encrypted TLS connection for a remote database. Requires a restart.
  ssl: false
  pool-size: 10

cross-server:
  # Share one database between several servers behind a proxy. Needs mysql/mariadb/postgres
  # plus a shared Redis server. See the Database page for the full setup.
  enabled: false
  # Unique name per server. Leave empty to generate one at every startup.
  server-id: ""
  redis:
    host: localhost
    port: 6379
    password: ""
    ssl: false
    database: 0
    key-prefix: "echest:"

backup:
  enabled: true
  interval: 6h
  keep: 10
  on-startup: false
  folder: backups

migration:
  enabled: false