StaffLink Pro

Configuration

Every setting lives in plugins/StaffLinkPro/config.yml, generated the first time the plugin loads. This page covers the essentials; the config reference documents every key.

After editing the file, apply changes with:

/stafflink reload
Reload across servers

/stafflink reload reloads the server it's run on. On a network, run it on each server (or restart them) after changing shared settings like the messaging channel.

The first things to set

Server identity

Give every server a unique name and a friendly label:

server:
  name: "Survival"
  display-name: "Survival"

server-display-names:
  survival: "Survival"
  lobby: "Lobby"
  skyblock: "Skyblock"

server-display-names maps each server's internal name to the [Label] shown in chat. A server that isn't listed falls back to its first letter (for example [S]).

Messaging

Keep this identical on every server:

messaging:
  channel: "stafflink:staffchat"
  enabled: true
  debug: false

Chat formats

Each channel has its own format string. Placeholders: {server}, {rank}, {prefix}, {player}, {message}.

The shipped default colours {server} and the [StaffChat] tag with an indigo→violet gradient built from per-character &x hex codes (see the full string). You can keep it or swap in simpler & colours:

staff-chat:
  format: '&9{server} &l[StaffChat]&r: {rank}&f{player}&8: &a{message}'
  # How Discord messages look in-game. Placeholders: {user}, {message}
  discord-format: '&9&l[Discord] Staffchat&r: &f{user}&8: &7{message}'
  console-output: false
  toggle-enabled: true
  • {rank} is the LuckPerms rank label, rendered as [Rank].
  • {prefix} is the LuckPerms prefix (%luckperms_prefix% also works).
  • Colours use & codes and &x hex sequences.
No MiniMessage

StaffLink Pro renders colours with translateAlternateColorCodes, not MiniMessage, <gradient:…> or other MiniMessage tags will show as literal text. Use & / &x codes.

Feature sections

Each feature has its own block in the config. Jump to its page to see the options in context:

SectionControlsPage
mentions@mention pings, sound, highlightMentions
loggingmessage log + lookupMessage logging
socialspyprivate-message spyingSocialSpy
staff-list/staff broadcastsStaff list
update-checkerversion checksUpdate checker
discordDiscordSRV bridgeDiscord

Advanced

advanced:
  max-message-length: 256
  message-cooldown: 1
  log-messages: true
  disable-short-aliases: false

Set disable-short-aliases: true if /sc, /mc, /ac, /oc or /sl clash with another plugin.