Configuration

config.yml

Generated automatically on first run. Edit and reload with /team reload.

limits:
  max-teams: 100
  max-members-per-team: 20
  max-name-length: 24
  min-name-length: 3
  max-prefix-length: 16
  allow-colored-prefix: true

validation:
  allowed-name-chars: "a-zA-Z0-9_-"
  blacklisted-names:
    - "admin"
    - "mod"
    - "staff"

chat:
  enabled: true
  format: "{team_prefix}<white>{player}</white><dark_gray>:</dark_gray> <gray>{message}</gray>"

invites:
  enabled: true
  expire-seconds: 60

team-chat:
  enabled: true
  format: "<dark_gray>[<aqua>Team Chat</aqua>]</dark_gray> <gray>{rank} {player}:</gray> <white>{message}</white>"

top:
  entries: 10

update-checker:
  enabled: true

bstats:
  enabled: true

Limits

limits.max-teams default: 100

Maximum number of teams that can exist on the server simultaneously.

limits.max-members-per-team default: 20

Maximum players allowed in a single team.

limits.max-name-length default: 24

Longest allowed team name.

limits.min-name-length default: 3

Shortest allowed team name.

limits.max-prefix-length default: 16

Maximum character length of a team prefix (tags stripped).

limits.allow-colored-prefix default: true

Whether team prefixes can contain MiniMessage color tags.

Validation

validation.allowed-name-chars default: a-zA-Z0-9_-

Regex character class for valid team names. Names must match entirely.

validation.blacklisted-names list

Case-insensitive list of forbidden team names.

Chat

chat.enabled default: true

Whether global chat should be prefixed with team prefixes.

chat.format string

MiniMessage format for global chat. Placeholders: {team_prefix}, {player}, {message}.

Invites

invites.enabled default: true

Whether the invite system is active. If false, only open teams can be joined.

invites.expire-seconds default: 60

How long pending invites last before automatically expiring.

Team Chat

team-chat.enabled default: true

Whether players can toggle team-only chat mode.

team-chat.format string

MiniMessage format for team chat. Placeholders: {team_prefix}, {rank}, {player}, {message}.

Other Settings

top.entries default: 10

Number of teams shown in the /team top leaderboard.

update-checker.enabled default: true

Whether to check Modrinth for updates on startup.

bstats.enabled default: true

Whether to submit anonymous metrics to bStats.

messages.yml

Every user-facing message is editable via messages.yml. The file uses MiniMessage formatting and supports placeholders wrapped in curly braces.

prefix: "<dark_gray>[<aqua>SimpleTeams</aqua>]</dark_gray> "

helpHeader: "<gray>----- SimpleTeams Help -----</gray>"
helpEntry: "<yellow>/team {usage}</yellow> - <gray>{description}</gray>"
helpFooter: "<gray>-------------------------</gray>"

teamCreated: "<green>You created the team {team}.</green>"
inviteSent: "<green>Invite sent to {player}. Expires in {seconds}s.</green>"
# ... etc

Tip Use /team reload to apply message changes without restarting.