Configuration

Colours use legacy & codes plus &#RRGGBB hex.

License

license:
  key: "YOUR-LICENSE-KEY"
config-version: 5

◆

Don't edit config-version — DexHomes uses it to spot an outdated config and back it up. Your key is carried across automatically.

Core settings

prefix: "&#7BFB09&lHomes &8┃ &r"
settings:
  max-slots: 56              # hard cap = 4 pages of 14
  default-homes: 1
  op-unlocks-all: true
  admin-unlocks-all: true
  default-icon: RED_BED
  small-font-names: false
  name-max-length: 16
  rank-fallback: "Default"
  combat-time: 15
  teleport-warmup: 5
  cancel-on-move: true
  cancel-on-damage: true

Home slot limits

Format is tiername: homes. Add, rename or delete tiers freely — the permission nodes follow automatically:

limits:
  vip: 3
  mvp: 5
  elite: 8

Tier in config	Permission generated	Legacy alias
`vip: 3`	`dexhomes.limit.vip`	`dexhomes.rank.vip`
`mvp: 5`	`dexhomes.limit.mvp`	`dexhomes.rank.mvp`
`elite: 8`	`dexhomes.limit.elite`	`dexhomes.rank.elite`

A player holding several tiers gets the highest value — they never stack.

◆

Not sure why someone has the slot count they do? Run /dexhomes check <player> — it names the exact rule.

How slots become pages

Slots	Result
14	One page. No next button. Title is just "Homes".
28	Two pages. Title becomes "Homes 1/2".
56	Four pages — the hard cap.

Storage

storage:
  type: SQLITE            # SQLITE or MYSQL
  mysql:
    host: localhost
    database: dexhomes
    table: dexhomes_homes

Menus & placeholders

Five menus — gui, confirm-gui, edit-gui, item-gui, colour-gui (plus particle/sound pickers) — are all re-skinnable. Placeholders include %player% %rank% %slot% %name% %used% %max% %free% %page% %pages% %bar% %colour% %particle% %sound%.