Settings, Chat & Teleport

Players change their own preferences in /settings. Each category is one file in settings/; add your own the same way.

A settings option

- id: public_chat            # storage key + placeholder name
  label: "&fPublic Chat"
  tooltip: "&7Show or hide public chat"
  default: "on"
  gui: { slot: 10, material: OAK_SIGN }
  values:                    # cycles top to bottom, then wraps
    - { id: "on",  display: "&aON" }
    - { id: "off", display: "&cOFF" }
  on-change:                 # optional commands per value
    "off":
      - "console: chattoggle %player% off"

Two values make an ON/OFF toggle; three or more make an Anyone / Friends / Nobody style cycle.

What DexDialog enforces itself

Setting	What happens
Chat → Public Chat	You stop receiving global chat
Chat → Private Messages	Anyone / friends / nobody can `/msg` you
Chat → Death / Advancement / Join-Leave	Those messages are filtered per player
PvP → Combat Timer	Combat tag, action bar, blocks teleporting
Privacy → Teleport Requests	Who may send you a request
Visuals → Teleport Confirm Menus	Requests open a dialog instead of chat buttons
Scoreboard → all options	Sidebar lines appear and disappear
General → Night Vision · Phantom Spawning · Mob Spawns	Applied for that player
General → Destroy Pearl on Death	Ender pearls are removed from your drops

◆

Other options (auction quick-buy, worth lore, payment privacy…) are stored for other plugins to read through the API or placeholders — see Commands & API.

Leaderboards

One file per board in leaderboards/. source: tracked uses the plugin's own counters: money (Vault), deaths, kills, mob_kills, blocks_placed, blocks_broken, playtime.

title: "&fTop Money"
source: tracked
column: money
top-size: 10
full-size: 200
cache-seconds: 60
value-format: compact         # compact | plain | time | decimal
entry-format: "&8#%rank% %head%%player% &8- &a$ %value%"
# or, from ajLeaderboards:
# source: placeholder
# placeholder-name: "%ajlb_money_all_%rank%_name%"

Chat

DexDialog owns chat while chat.yml → enabled: true. Set it to false if another plugin runs your chat.

Channel	How
Global	Normal chat
Friends	`/fchat <msg>` or `/chat friends` — only your DexFriends friends see it
Private	`/msg <player> <msg>`, `/r <msg>`

Teleport

enabled: true                  # false = keep EssentialsX /tpa
request-expiry-seconds: 60
cooldown-seconds: 5
warmup-seconds: 3
cancel-warmup-on-move: true
block-in-combat: true
combat-seconds: 15
confirm-menu: tp-request        # dialog for players with Teleport Confirm Menus on

Old clients & Bedrock

client:
  mode: auto                  # auto | always-chest | always-dialog
  min-protocol: 771           # 1.21.6
  protocol-source: auto       # auto | packetevents | viaversion | none
  bedrock-mode: forms         # forms | chest | dialog