# The serializer determines which serializer to use for text components:
# - minimessage: Use MiniMessage for advanced text formatting
# - legacy: Use LegacyComponentSerializer for formatting text in the classic Minecraft style
serializer : minimessage

# Settings for welcome messages when joining the server:
joiners:
  default:
    chat : <gradient: #ff00ff:#00ffff>Hello, %prefix% %player%! Welcome to %server_name%!
    sound:
      name : minecraft:entity.player.levelup
      volume : 1.0
      pitch : 1.0

  # Custom settings for specific player groups:
  custom :
    # VIP Group settings
    vip:
      permission : group.vip.permission
      # Random chat messages to welcome VIP players
      chat :
       - <green>Welcome, %prefix% %player%! Enjoy your VIP privileges!
        - <yellow>Hello %prefix% %player%, our VIP! Great to see you here!
    # No settings for actionbar, title, or sound

    # Admin Group settings
    admin:
      permission : group.admin.permission
      # No settings for chat or actionbar
      title:
        main : <red>Welcome</red>
        sub : <white>Admin %prefix% %player%!</white>
        fadeIn : 20
        stay : 60
        fadeOut : 20
    # No settings for sound

    # Moderator Group settings
    moderator:
      permission : group.moderator.permission
      # No settings for chat or title
      actionbar : <blue>Welcome Moderator %prefix% %player%! Thanks for helping us out.</blue>
    # No settings for sound

# Settings for leaving messages when leaving the server:
leavers:
  default:
    chat : <yellow> %player% left the game</yellow>
    sound:
      name : minecraft:entity.player.leveldown # A slightly different sound
      volume : 1.0
      pitch : 1.0

  # Custom settings for specific player groups:
  custom :
    # VIP Group settings
    vip:
      permission : group.vip.permission
      chat :
       - <red>Goodbye, %prefix% %player%! Your VIP presence will be missed.
    # No settings for actionbar, title, or sound

    # Admin Group settings
    admin:
      permission : group.admin.permission
      # No settings for chat or actionbar
      title:
        main : <red>See you later</red>
        sub : <white>Admin %prefix% %player%!</white>
        fadeIn : 20
        stay : 60
        fadeOut : 20
    # No settings for sound

    # Moderator Group settings
    moderator:
      permission : group.moderator.permission
      # No settings for chat or title
      actionbar : <blue>Thanks for your help, Moderator %prefix% %player%! See you soon.</blue>
    # No settings for sound

# Messages for /ijoiner command
messages:
  player_only_command : <red>Only players can use this command!</red>
  no_permission : <red>You don't have permission to use this command!</red>
  no_reload_permission : <red>You don't have permission to reload the plugin!</red>
  command_usage : '<yellow>Usage : /joiner reload</yellow>'
  plugin_reloaded : <green>Plugin reloaded successfully!</green>
  reload_error : <red>An error occurred while reloading the plugin configuration. Please check the console for details.</red >

# Example of using MiniMessage:
# Using MiniMessage allows for advanced text formatting, such as gradients, colors, styles, and placeholders.
# You can use placeholders like %prefix% %player% to dynamically insert player names or prefixes.
# Example:
# chat: "<gradient:#ff00ff:#00ffff>Hello, %prefix% %player%!"
# This will display a chat message with a gradient color and the player's name dynamically inserted.

# Example of using LegacyComponentSerializer:
# LegacyComponentSerializer allows for simple formatting using the legacy color codes (&a, &b, etc.).
# It's useful if you're familiar with Minecraft's old formatting system or need compatibility with plugins that use it.
# Example:
# chat: "&aHello, &b%prefix% %player%!"
# This will display a chat message with green text followed by the player's name in blue.

# Links to resources:
# - MiniMessage: https://webui.advntr.dev/
# - LegacyComponentSerializer: https://minecraftitemids.com/color-codes