# ──────────────────────────────────────────────────────────────────────────────
#  PlotWorlds — config.yml
#
#  Tip: Most features are per-world in worlds.yml (plot size, road size, template,
#  enter/leave display, limits, default flags, etc.).
# ──────────────────────────────────────────────────────────────────────────────

settings:
  # Enables extra console logging (helpful for debugging world gen & schematics).
  debug: false

update-check:
  # Enable or disable automatic update checks.
  enabled: true

  # Permission node required to see update notifications.
  permission: plotworlds.update

  # Message when a new version is available.
  # Placeholders:
  #   %latest%  - Latest available version
  #   %current% - Your current version
  message: "&a&lᴘʟᴏᴛ&fᴡᴏʀʟᴅꜱ &8➜ &fA new version, &b%latest%&f, is available. You're running &e%current%&f."

  # Text for the clickable button that opens the download link.
  button-text: "&7[&a&lClick to Download&7]"

storage:
  # SQLITE | MYSQL | YAML
  type: YAML

  sqlite:
    file: "plotworlds.db"

  mysql:
    host: "127.0.0.1"
    port: 3306
    database: "plotworlds"
    username: "root"
    password: "password"
    use-ssl: false
    parameters: "?useUnicode=true&characterEncoding=utf8&useSSL=false&allowPublicKeyRetrieval=true"

  yaml:
    plots-file: "plots.yml"
    warps-file: "warps.yml"
    holograms-file: "plot_holograms.yml"

hooks:
  # Economy hook for costs/limits/etc
  vault: true

  # Permissions hook
  luckperms: false

  # PlaceholderAPI support for messages/scoreboards/etc
  placeholderapi: true

  worldedit:
    enabled: false

    # If true, the plugin will refuse to use schematics without WorldEdit present.
    require-for-schematics: false

plot-auto:
  # If true: player must be inside a plotworld to use /plot auto
  require-in-plotworld: true

  # What to do when require-in-plotworld is false and player is NOT currently in a plotworld:
  # AUTO = pick the first enabled plotworld found in worlds.yml that is loaded
  # SPECIFIED = use the world below
  selection-mode: "AUTO"

  # Used when selection-mode is SPECIFIED
  specified-plotworld: "plots"

  # How far out to search for an unclaimed plot (spiral radius)
  search-radius: 75

  # Teleport the player to the plot after claiming
  teleport-on-claim: true

enter-display:
  # Global (cross-world) rating display settings.
  # This shows a plot's warp rating when players enter a plot (if a warp exists).
  rating:
    enabled: true

    # If true, only display rating when the plot has a warp set.
    require-warp: false

    # ACTIONBAR | TITLE | BOSSBAR | OFF
    display: "TITLE"

    stars:
      # Total star icons to show
      max: 5

      # Filled star + empty star style
      full: "&e★"
      empty: "&7☆"

      # How to round the star count from a 0–5 rating:
      # FLOOR | NEAREST | CEIL
      rounding: "NEAREST"

    no-ratings:
      # Friendly display when there are no votes yet
      enabled: true

      # Used for %rating% when votes = 0
      rating-text: "&7No ratings yet"

      # Used for %stars% when votes = 0 (leave blank to auto-build empties)
      stars-text: "&7☆☆☆☆☆"

      # Used for %votes% when votes = 0
      votes-text: "0"

      # If true, still show the rating display even with 0 votes (warp must exist)
      show-when-zero: true

    title:
      title: "&d&lPlot Rating"
      subtitle: "%stars% &f%rating% &7(%votes% votes)"
      fadeIn: 5
      stay: 30
      fadeOut: 10

    actionbar:
      text: "%stars% &f%rating% &7(%votes% votes) &8| &7Warp: &f%warp%"

    bossbar:
      text: "%stars% &f%rating% &7(%votes% votes) &8| &7Warp: &f%warp%"
      seconds: 3

world-defaults:
  pvp: false
  auto-save: true
  keep-spawn-in-memory: false

  spawn-flags:
    spawn-monsters: false
    spawn-animals: false

  difficulty: PEACEFUL

  time:
    lock: true
    value: 6000

  weather:
    lock-clear: true

  gamerules:
    doDaylightCycle: true
    doMobSpawning: false
    keepInventory: true
    doFireTick: false
    mobGriefing: false
    announceAdvancements: false
    doWeatherCycle: false
    randomTickSpeed: 0
    spawnRadius: 0
    maxEntityCramming: 0

plot-hologram:
  enabled: true

  # If true, hologram is only created when at least one player is on the plot.
  # It is removed automatically when the plot becomes empty.
  remove-when-empty: true

  # Default location: PLOT_CENTER or PLOT_HOME
  default-anchor: "PLOT_CENTER"

  # Default offset from anchor (center/home)
  default-offset:
    x: 0.5
    y: 2.2
    z: 0.5

  # Space between hologram lines
  line-spacing: 0.27

  # Only show hologram to players within this distance (performance + aesthetics)
  view-distance: 48

  # Marker armorstands are 1.20+ friendly and super light.
  armorstand:
    marker: true
    invisible: true
    no-gravity: true
    silent: true

  # Default hologram lines (supports placeholders below)
  # Placeholders:
  #   %plot_id% %owner% %world%
  #   %trusted% %denied%
  #   %warp% %rating% %votes% %stars%
  #   %visits%
  lines:
    - "&fOwner: &e%owner%"
    - "&b&lPlot &8➜ &f%plot_id%"
    - "&f"
    - "&7Trusted: &f%trusted% &8| &7Denied: &f%denied%"
    - "&7Visits: &f%analytics_visits% &8| &7Unique: &f%analytics_unique_visitors%"
    - "&7Time: &f%analytics_time_spent% &8| &7Last: &f%analytics_last_seen%"
    - "&d%stars% &f%rating% &7(%votes% votes)"
    - "&f"
    - "&e/plot hologram move &7to reposition"

performance:
  # Maximum schematic/template pastes per tick (higher = faster, more lag risk).
  max-pastes-per-tick: 2

  # Maximum cached plot lookups kept in memory (higher = faster, more RAM).
  plot-cache-size: 10000