PlayerNotes

# PlayerNotes Configuration

# Storage configuration
storage:
  # Type of storage: "mysql" or "flatfile"
  type: flatfile
  
  # MySQL settings (only used if type is mysql)
  mysql:
    host: localhost
    port: 3306
    database: minecraft
    username: root
    password: password
    # Optional connection parameters
    params: "?useSSL=false&autoReconnect=true"
  
  # Flat file settings (only used if type is flatfile)
  flatfile:
    # Folder name under the plugin data folder
    folder: playerdata

# Display settings
display:
  # Number of notes per page in /note list
  page-size: 10
  
  # Date format for displaying timestamps
  # Available formats: ISO (2024-01-15T14:30:00), LOCAL (01/15/2024 02:30 PM), SIMPLE (2024-01-15 14:30)
  date-format: SIMPLE

# Validation settings
validation:
  # Maximum length for note text
  max-text-length: 512
  
  # Strip color codes from note text
  strip-colors: true

# Performance settings
performance:
  # Enable simple caching for recent note lists
  enable-cache: true
  
  # Cache time-to-live in seconds
  cache-ttl: 60
  
  # Maximum number of players to cache
  cache-size: 50

# PlayerNotes Messages Configuration
# All messages support MiniMessage formatting: https://docs.advntr.dev/minimessage/format.html
# Placeholders:
# {player} - Target player name
# {uuid} - Target player UUID
# {actor} - The person executing the action
# {id} - Note ID
# {count} - Number of notes
# {page} - Current page number
# {total_pages} - Total number of pages
# {timestamp} - Formatted timestamp
# {text} - Note text
# {max_length} - Maximum text length

# General messages
no-permission: "<red>You don't have permission to use this command."
player-not-found: "<red>Player '<yellow>{player}</yellow>' not found."
player-never-joined: "<red>Player '<yellow>{player}</yellow>' has never joined this server."
invalid-number: "<red>Invalid number provided."
storage-error: "<red>Failed to perform operation. Please try again later."

# Add command messages
add:
  usage: "<red>Usage: /note add <player> <text>"
  text-empty: "<red>Note text cannot be empty."
  text-too-long: "<red>Note text is too long. Maximum length is <yellow>{max_length}</yellow> characters."
  success: "<green>Note added to <yellow>{player}</yellow>."
  
# List command messages
list:
  usage: "<red>Usage: /note list <player> [page]"
  invalid-page: "<red>Invalid page number."
  no-self-permission: "<red>You don't have permission to view your own notes."
  empty: "<yellow>{player}</yellow> <gray>has no notes."
  header: "<gold><bold>=== Notes for {player} ==="
  uuid-line: "<gray>UUID: <white>{uuid}"
  total-line: "<gray>Total Notes: <white>{count} <gray>| <gray>Page: <white>{page}/{total_pages}"
  entry: "<yellow>[#{id}] <gray>{timestamp} <white>{actor}<gray>: <white>{text}"
  next-page: "<gray>Use <yellow>/note list {player} {page}</yellow> <gray>for the next page."
  
# Remove command messages
remove:
  usage: "<red>Usage: /note remove <player> <id>"
  invalid-id: "<red>Invalid note ID."
  success: "<green>Note <yellow>#{id}</yellow> removed from <yellow>{player}</yellow>."
  not-found: "<red>Note <yellow>#{id}</yellow> does not exist for <yellow>{player}</yellow>."
  
# Clear command messages
clear:
  usage: "<red>Usage: /note clear <player> confirm"
  confirm-prompt: "<red>Are you sure you want to clear all notes for <yellow>{player}</yellow>?"
  confirm-instruction: "<red>Use <yellow>/note clear {player} confirm</yellow> to proceed."
  success: "<green>Cleared <yellow>{count}</yellow> note(s) from <yellow>{player}</yellow>."
  empty: "<yellow>{player}</yellow> <gray>has no notes to clear."
  
# Info command messages
info:
  usage: "<red>Usage: /note info <player>"
  no-self-permission: "<red>You don't have permission to view your own notes."
  header: "<gold><bold>=== Note Info for {player} ==="
  uuid-line: "<gray>UUID: <white>{uuid}"
  total-line: "<gray>Total Notes: <white>{count}"
  latest-header: "<gray>Latest Note:"
  latest-entry: "<yellow>[#{id}] <gray>{timestamp} <white>{actor}<gray>: <white>{text}"
  view-all: "<gray>Use <yellow>/note list {player}</yellow> to view all notes."
  
# Reload command messages
reload-success: "<green>Plugin configuration and messages reloaded successfully!"

# Help command messages
help:
  header: "<gold><bold>=== PlayerNotes Commands ==="
  entry: "<yellow>/note {usage} <gray>- <white>{description}"
  unknown-subcommand: "<red>Unknown subcommand. Use <yellow>/note</yellow> for a list of commands."