Configuration

config.yml holds the rules. Restyle the menus in gui.yml and dialog.yml, and every chat line in messages.yml. & codes and &#rrggbb hex work everywhere.

Follows

follow:
  friends-only-actions: true     # messages, pokes, location + teleports need a mutual follow
  notify-cooldown-seconds: 300   # "started following you" at most once per follower
friends:
  default-limit: 50
  limits:                         # dexfriends.limit.<key> → limit, highest wins
    default: 50
    vip: 100
    mvp: 200
  notify-join: true
  notify-quit: true
  block-limit: 100
  sort-favourites-first: true

Teleports

teleport:
  enabled: true
  provider: auto                # auto / essentials = EssentialsX /tpa · internal = built in
  intercept-commands: true      # Confirm / Accept screens for typed /tpa, /tpaccept ...
  region: 'Asia'                # shown with the player's ping on the teleport screens
  request-expiry-seconds: 120
  # internal provider only — Essentials uses its own:
  warmup-seconds: 3
  cancel-on-move: true
  cancel-on-damage: true
  cooldown-seconds: 10
  same-world-only: false

◆

If another plugin (CMI, HuskHomes…) owns /tpa, DexFriends leaves it alone.

Pay

pay:
  enabled: true                 # needs Vault + an economy plugin
  presets: [1000, 2000, 10000, 20000, 50000, 100000]
  minimum: 1
  maximum: 0                    # 0 = no maximum
  currency: '&a$ &f'
  history-per-page: 10

Direct messages

direct-messages:
  enabled: true
  cooldown-seconds: 0
  poke-cooldown-seconds: 10
  share-location: true
  format-sender: '&8[&7you &8-> &f%target%&8] &f%message%'
  format-target: '&8[&f%sender% &8-> &7you&8] &f%message%'

Dialog or GUI

ui:
  dialog:
    enabled: true               # false = chest GUI for everyone
    minimum-protocol: 771       # 1.21.6
    bedrock-uses-gui: true
  gui:
    follow-picker-per-page: 45

Your own toggles

They apply to everyone. Labels and defaults are yours to change; the keys are fixed because each one is enforced in code.

Key	Controls	Default
`allow-teleport`	Players can send you teleport requests	on
`allow-messages`	Players can message and poke you	on
`allow-pay`	Players can pay you	on
`notify-join`	Alerts when someone you follow joins or leaves	on
`notify-follow`	Alerts when someone follows you	on
`show-online`	Others can see you're online	on

Per-player settings

Set for one specific player from their Settings screen. Your own toggle above has to allow it too.

Key	Controls	Default
`activity`	Get their join and leave messages	on
`transactions`	Get a message when they pay someone	on
`payment-activity`	Get a message when they pay you	on
`can-message`	They can message, poke and share location	on
`can-teleport`	They can send you teleport requests	on
`auto-accept-tp`	Their teleport requests are accepted for you	off
`can-pay`	They can send you money	on

Storage

storage:
  type: SQLITE                  # SQLITE or MYSQL
  file: friends.db
  table-prefix: 'dexfriends_'