# =========================================================
# TexturepackManager — Default Configuration
# =========================================================
# Tips:
# • If you're self-hosting the pack, enable pack.application_methods.local
#   and make sure 'host' and 'port' are reachable by your players.
# • If you're using an external CDN link, enable pack.application_methods.public_url
#   and set pack.public_url (+ optional pack.public_url_sha1).
# • Place any "vanilla-style" resource pack inputs in pack.resourcepack_style_dir.
# • Final built pack is written to pack.user_packs_dir as pack.zip.
# =========================================================

pack :
  # -----------------------------
  # Local pack hosting (self-host)
  # -----------------------------
  host : "0.0.0.0"                 # IP address to bind the internal web server to
  port : 8000                       # Port for the internal web server
  url_path : "/texturepackmanager/pack.zip"   # HTTP path where pack.zip is served

  # -----------------------------
  # Startup behavior
  # -----------------------------
  build_on_start : true             # Build the resource pack on plugin startup
  auto_apply_on_join : true         # Send/apply the pack automatically when players join

  # -----------------------------
  # How players receive the pack
  # -----------------------------
  application_methods:
    local : true                   # Serve the pack from the internal web server (host/port/url_path)
    public_url : false             # If true, use public_url (below) instead of local hosting

  # -----------------------------
  # Paths & external URLs
  # -----------------------------
  resourcepack_style_dir : "resourcepack_style"   # Source folder for your RP inputs (sounds, models, lang, etc.)
  user_packs_dir : "packs"                       # Output directory where pack.zip is written
  public_url : "https://download.mc-packs.net/pack/TEXTURE-PACK-ID.zip"   # CDN/external URL to pack.zip (if application_methods.public_url = true)
  public_url_sha1 : "SHA1-ID"                     # Optional SHA-1 hex of the pack for client caching/integrity

  # -----------------------------
  # Download protection
  # -----------------------------
  protection:
    enabled : true                 # Gate downloads with a short-lived signed token
    secret : "CHANGE-ME-32B"       # 32+ byte random secret; CHANGE THIS IN PRODUCTION
    ttl_seconds : 90               # Token lifetime in seconds
    bind_to_ip : true               # Bind token to the requester's IP (prevents sharing)
    block_non_game_requests : true # Reject requests that don't look like a Minecraft client
    rate_limit:
      enabled : true
      max_requests : 3             # Burst size
      period_seconds : 2           # Burst window
      cooldown_minutes : 30         # Temporary block after exceeding limits

# =========================================================
# In-game Menu / Debugging
# =========================================================
menu:
  debug:
    items : true                   # Show Items tab in the debug menu
    blocks : true                   # Show Blocks tab in the debug menu
    furniture : true               # Show Furniture tab in the debug menu

  # Show dynamic lore on category tabs (uses {category}, {total}, {page}, {pages})
  tab_button_lore_enabled : true
  tab_button_lore :
   - ""
    - "&7Category : &f{category}"
    - "&7Items : &f{total}"
    - "&7Page : &f{page}/{pages}"

  # Optional: lore on Prev/Close/Next buttons
  nav_button_lore_enabled : false
  nav_button_lore :
   - ""
    - "&7Page : &f{page}/{pages}"

# =========================================================
# Integrations / Extras
# =========================================================
settings :
  # If true and ModelEngine is installed, assets found in its folders are pulled
  # into the build pipeline (e.g., textures/models) when compiling the pack.
  ModelEngine : true

# =========================================================
# Command: /restarting
# =========================================================
restarting :
  # default length of the countdown if /restarting is used with no args
  duration_seconds : 10

  # broadcast every second; each line is sent as-is (supports & colors and :emoji: tokens)
  # {seconds} placeholder is replaced with remaining time
  broadcast_lines :
   - ":server-icon:"
    - "                          &fThe server will be"
    - "                           &frestarting in &b{seconds}s&f!"
    - ""

  # run console commands when the remaining seconds equals the map key.
  # If a command contains %player%, it is run once per online player with %player% replaced.
  # If it doesn't contain %player%, it's run once globally.
  run_at:
    "3" :
     - "tpm playtotemanimation %player% restarting"
    "0" :
      # choose one: "restart" (Paper) or "stop" (Spigot). Keep only the one you use
      - "restart"

# =========================================================
# TexturepackManager — Messages
# Color codes: use '&' (e.g., &a, &b, &7). Hex (&x&F&F...) if your chat supports it.
# Placeholders: shown as {like_this}. Do not rename placeholders.
# =========================================================

# Common prefix prepended to most messages
prefix : "&bᴛᴘᴀᴄᴋᴍᴀɴᴀɢᴇʀ &7» &f"

# Simple meta/info
meta :
  # {version} -> plugin version string
  version : "&bTexturepackManager &7version &f{version}"

# -------------------------------------
# Usage / Help text shown to players
# -------------------------------------
usage :
  # Multiline help for /tpm help
  # {version} -> plugin version; {command} -> base command alias (e.g., /tpm)
  help-usage :
   - "&bTexturepackManager &7v{version}"
    - "&7Commands:"
    - "&8- &e{command} help &7Show this help"
    - "&8- &e{command} menu &7Open the GUI"
    - "&8- &e{command} give &7(id|block:|furniture:) (player) (amount)"
    - "&8- &e{command} playtotemanimation (player) (id)"
    - "&8- &e{command} pack &7(build|reload|url|apply [player])"
    - "&8- &e{command} validate &7Check current pack files for errors"
    - "&8- &e{command} sounds &7(list|reload|play|ping|debug)"
    - "&8- &e{command} migrate &7Migrate from other TP plugins"
    - "&8- &e{command} version &7Display the plugin version"
    - ""
    - "&8- &e/restarting &7Restart the server in style!"

  # One-line usage hints for subcommands (used when args are wrong/missing)
  # {prefix} is auto-expanded from the top-level prefix
  pack : "{prefix}&e/tpm pack (build|reload|url|open)"
  pack_apply : "{prefix}&e/tpm pack apply (player)"
  give : "{prefix}&e/tpm give (item) (player) (amount)"
  migrate : "{prefix}&e/tpm migrate (itemsadder)" # oraxen & nexo support planned
  sounds_root : "{prefix}&e/tpm sounds &7(list|reload|play|ping|debug)"
  sounds_play : "{prefix}&e/tpm sounds play &7(id) (player) [volume] [pitch] [category]"
  sounds_debug : "{prefix}&e/tpm sounds debug &7(id)"
  play_totem : "{prefix}&e/tpm playtotemanimation (player) (id)"

# -------------------------------------
# Pack build / reload / apply feedback
# -------------------------------------
pack :
  # Shown when a build starts
  building : "{prefix}Building pack..."
  # {url} -> current pack URL (local or public)
  built : "{prefix}Pack &abuilt&f: &e{url}"
  reloaded : "{prefix}Pack &ereloaded&f: &e{url}"
  reload_start : "{prefix}Reloading config and rebuilding pack..."
  url_value : "{prefix}Pack URL: &e{url}"
  url_none : "{prefix}No pack built yet. Use &e/tpm pack build"
  open : "{prefix}Open this URL for the pack: &e{url}"
  # {player} -> target player; {error} -> error string
  apply_ok : "{prefix}Applied pack to &b{player}"
  apply_fail : "{prefix}&cFailed &fto apply: &c{error}"
  http_fail : "{prefix}&cFailed &fto (re)start HTTP host: &c{error}"
  # {ok} -> #successes, {fail} -> #failures, {url} -> pack URL
  apply_summary : "&aApplied &fpack to &b{ok}&f player(s)&7, &ffailures: &c{fail}&f. URL: &e{url}"

# -------------------------------------
# Reload/build failures
# -------------------------------------
reload :
  # {error} -> error message
  fail : "{prefix}&cRebuild failed: &f{error}"

# -------------------------------------
# Validation messages
# -------------------------------------
validate:
  start : "{prefix}Validating resource pack..."
  # {files} -> number of files validated
  ok : "{prefix}Validation &apassed. &fFiles: &b{files}"
  # {count} -> number of errors found
  fail_header : "{prefix}Validation found &c{count} error(s)&f:"
  # {msg} -> each error line
  fail_line : "&7- {msg}"

# -------------------------------------
# Give command
# -------------------------------------
give :
  # {n} -> amount, {item} -> resolved item display
  ok : "{prefix}Gave &b{n}x {item} &fto &b{player}"
  # {kind} -> item type (e.g., block/furniture), {id} -> id, {shown} -> name shown
  ok2 : "{prefix}Gave &b{n}x &7[{kind}] &f{id} &7(&f{shown}&7) to &b{player}"
  # {item} -> input token user tried
  nf : "{prefix}Unknown item id &b{item}"

# -------------------------------------
# Migration messages
# -------------------------------------
migrate :
  # {path} -> scanned directory, {flavor} -> migration flavor (itemsadder, etc.)
  start : "{prefix}Scanning &e{path} &ffor &b{flavor}&f..."
  started_async : "{prefix}Migration running in the background. Watch your action bar for progress."
  done_sync : "{prefix}Migration &adone&f. Check console for details."
  # {files} -> file count, {errors} -> error count
  report : "{prefix}Scan complete: &b{files} &ffiles, &c{errors} errors&f. &7(See console for details.)"
  path_missing : "{prefix}Could not find migration path: &e{path}"
  path_not_dir : "{prefix}Not a directory: &e{path}"

# -------------------------------------
# Totem animation
# -------------------------------------
totem :
  # {player} -> target player
  ok : "{prefix}Played totem animation for &b{player}"

# -------------------------------------
# Sounds command feedback
# -------------------------------------
sounds :
  # {count} -> number of definitions loaded
  reloaded : "{prefix}Sounds reloaded. Loaded: &f{count}"
  # {count} -> #missing; list items below with 'missing_line'
  missing_header : "{prefix}&cMissing .ogg files (&f{count}&c):"
  # {id} -> sound id shown per line
  missing_line : "&7- &f{id}"
  none : "{prefix}&eNo custom sounds defined."
  # {count} -> number of sounds
  list_header : "{prefix}&7Sounds (&f{count}&7):"
  list_line : "&7- &f{id}"
  # {player} -> who received it
  ping_ok : "{prefix}Played vanilla ping to &b{player}"
  unknown : "{prefix}Unknown sound id: &e{id}"
  # {id}, {player}, {vol}, {pitch}, {cat}
  play_ok : "{prefix}Played &f{id} &7to &f{player} &7(vol=&f{vol}&7, pitch=&f{pitch}&7, cat=&f{cat}&7)"
  # Debug info when checking a specific id
  debug_header : "{prefix}&7Sound debug: &f{id}"
  # {val} -> explanatory text/value
  debug_defined : "&7- Defined: &f{val}"
  debug_missing : "&7- OGG missing: &f{val}"
  debug_hint : "{prefix}&8If no audio: rebuild/apply the pack and ensure the id is in sounds.json with a valid .ogg."

# -------------------------------------
# Emojis
# -------------------------------------
emojis:
  none : "{prefix}No emojis found."

# -------------------------------------
# Errors / Generic replies
# -------------------------------------
errors:
  unknown_sub : "{prefix}Unknown subcommand."
  player_nf : "{prefix}Player &cnot &ffound."
  no_perm : "{prefix}You don't have permission: &f{perm}"
  players_only : "{prefix}Players only."
  bad_int : "{prefix}Invalid number: &b{value}"
  no_players_online : "{prefix}&cNo &fplayers are online."