Configs

Core Configuration (config.yml)

Basic plugin configuration containing global settings and database.

# Global settings used across all features
settings:
  # Plugin prefix used in messages
  prefix: "&8[&cStaffUtils&8] "

  # Storage settings
  storage:
    # SQLite database file name
    database: "database.db"

# Available placeholders for all messages:
# {player} - Player name
# {staff} - Staff member name
# {message} - Chat message
# {reason} - Reason for action
# {time} - Time/duration 

Moderation Configuration (moderation.yml)

# Moderation Configuration

# Staff chat settings
staff-chat:
  format: "&c[Staff] &7{player}: &f{message}"
  notify-join-leave: true
  join-format: "&8[&c+&8] &7{player}"
  leave-format: "&8[&c-&8] &7{player}"

# Vanish settings
vanish:
  hide-join-message: true
  hide-quit-message: true
  prevent-interaction: true
  silent-chest-open: true
  hide-from-tab: true
  enable-message: "&7You are now &avanished"
  disable-message: "&7You are now &cunvanished"

# Freeze settings
freeze:
  prevent-commands: true
  allowed-commands:
    - msg
    - r
    - tell
  freeze-message: "&cYou have been frozen by a staff member!"
  unfreeze-message: "&aYou have been unfrozen!"
  staff-freeze-message: "&7You have frozen &f{player}"
  staff-unfreeze-message: "&7You have unfrozen &f{player}"
  prevent-movement: true
  prevent-damage: true

# Chat moderation
chat:
  slow-mode:
    default-delay: 5
    cooldown-message: "&cPlease wait {time} seconds before chatting again"
  clear:
    lines: 100
    message: "&7Chat has been cleared by &f{staff}"
    staff-message: "&7Chat has been cleared by &f{staff} &7(bypassed)"

Punishments Configuration (punishments.yml)

# Punishments Configuration

# Available placeholders for messages:
# {player} - Target player's name
# {staff} - Staff member's name who issued punishment
# {reason} - Punishment reason
# {duration} - Duration of punishment (Permanent or time remaining)
# {appeal} - Appeal message (if enabled)
# {count} - Warning count (for warn system)
# {punishment} - Type of punishment (ban/mute/warn)

# Global settings that apply to all punishment types
settings:
  broadcast-format: "&c{player} &7has been {punishment} by &f{staff}"
  default-reason: "No reason specified"

# Ban punishment settings
ban:
  broadcast:
    enabled: true
    format: "&c{player} &7has been banned by &f{staff} &7for: &f{reason}"
  permanent:
    message: |-
      &c&lPermanently Banned
      &7
      &7Reason: &f{reason}
      &7Duration: &f{duration}
      &7
      {appeal}
  temporary:
    message: |-
      &c&lTemporarily Banned
      &7
      &7Reason: &f{reason}
      &7Duration: &f{duration}
      &7
      {appeal}
  appeal:
    enabled: true
    link: "https://example.com/appeal"
    message: "&7Appeal at: &fhttps://example.com/appeal"

# Mute punishment settings
mute:
  broadcast:
    enabled: true
    format: "&c{player} &7has been muted by &f{staff} &7for: &f{reason}"
  message: "&cYou have been muted for: &f{reason}"
  blocked-commands:
    - msg
    - tell
    - r

# Warning system settings
warn:
  broadcast:
    enabled: false
    format: "&c{player} &7has been warned by &f{staff} &7for: &f{reason}"
  message: "&cYou have been warned: &f{reason}"
  max-warnings: 3
  actions:
    3: "kick {player} Too many warnings"
    5: "ban {player} Exceeding warning limit"