####################################################################################################[/LEFT]
# AIMinecraft — Configuration
#
# HOW TO GET A GEMINI API KEY (STEP BY STEP)
#  1) Open https://aistudio.google.com/ in your browser.
#  2) Click “Sign in” and use your Google account (or create one if needed).
#  3) Once logged in, open the menu (top-right) → “Get API key” (or “API keys”).
#  4) Click “Create API key” (choose a project if prompted) and copy the key.
#  5) Paste the key into gemini.api_key below and restart your server (or /ai reload).
#
# NOTES ABOUT PRICING
#  • AI Studio provides a free usage tier suitable for basic experimentation.
#  • Premium/paid tiers with higher limits and/or better models are also available.
#  • Review Google’s pricing & quotas carefully to avoid unintended costs.
#
# IMPORTANT DISCLAIMER
#  • AIMinecraft is not affiliated with Google or AI Studio in any way.
#  • You are solely responsible for your API key and any usage/charges incurred.
#
# SECURITY TIP
#  • Keep your API key private. Do not share it publicly or commit it to public repos.
####################################################################################################


gemini:
  # Your Gemini API key from AI Studio.
  # Paste the key you created at https://aistudio.google.com/ → “Get API key”.
  api_key: "PUT_YOUR_KEY_HERE"

  # The default model used by /ai chat and /ai build (unless overridden with flags or /ai model).
  # Options:
  #   - gemini-2.0-flash : Faster, cheaper, great for quick building and iteration.
  #   - gemini-1.5-pro   : Higher quality reasoning; slower and costlier.
  default_model: "gemini-2.0-flash"

  # Total HTTP timeout (in seconds) for AI requests. If the model takes too long,
  # the request is aborted. Increase this if you frequently build large structures.
  request_timeout_seconds: 300

console:
  # Optional console/remote dashboard integration (not required to use AI)

  # Enable/disable the remote console bridge.
  # If you do not use the external dashboard, leave this false.
  enabled: false

  # The dashboard endpoint your server will post to / poll from.
  # Only relevant if console.enabled is true.
  dashboard_url: "http://217.154.63.80:9016"

  # How often (in server ticks) to poll for remote commands.
  # 20 ticks = ~1 second. Default here is 60 ticks (~3 seconds).
  poll_interval_ticks: 60

build:
  throttle:
    # If true, the builder sleeps briefly between block placements
    # to avoid tanking server TPS on large builds.
    enabled: true

    # Advisory limit for block updates per tick. This is a soft/target value
    # and may not be a strict cap. Keep this conservative on busy servers.
    per_tick: 200            # max block updates per tick (soft target)

  # Milliseconds to sleep between block updates during async processing.
  # Higher values are gentler on performance but make builds complete slower.
  default_buffer_ms: 5

text3d:
  default_block: "WHITE_CONCRETE"
  pixel_size: 1
  extrude_depth: 1
  spacing: 1
  hollow: false

prefix: "&8(&6ᴀɪ&aᴍ&8) &f"[/LEFT]
no-permission: "You &cdon't &fhave permission to do that."
players-only: "This command can only be used by a player."
usage:
  base: "           &6ᴀɪ&aᴍ"
  chat: "Usage&7: &e/ai chat (message)"
  build: "Usage&7: &e/ai build (prompt) [-m flash|pro]"
  continue: "Usage&7: &e/ai continue (modification)"
  model: "Usage&7: &e/ai model (flash|pro)"
  text3d: "Usage&7: &e/ai text3d (text) [-b BLOCK] [-s SIZE] [-d DEPTH] [-sp SPACING] [-h HOLO]"
  cancel: "Usage&7: &e/ai cancel"
  undo: "Usage&7: &e/ai undo"
  progress: "Usage&7: &e/ai progress"
  reload: "Usage&7: &e/ai reload"
 
text3d:
  placed: "3D text &aplaced&f."
status:
  thinking: "Thinking..."
  designing: "Designing your structure..."
  modifying: "Modifying your structure..."
  cancelled: "&cCancelled &fyour previous build task."
  building-start: "Building structure... &7(&b%total% blocks&7)"
  building-progress: "Building progress: &f%progress% &7(&b%done%&7/&b%total% blocks&7)"
  building-success: "Structure built &asuccessfully&f!"
  reverted: "Reverted to the previous build state due to errors."
  restored-failed: "&cFailed &fto restore the original build."
  no-last-build: "You haven't built anything yet."
  cancelled-none: "You have no active build."
  cancelled-ok: "You have &ccancelled &fyour active build."
errors:
  api-key-default: "Gemini API key &cisn’t configured&f. Set this up in the &bconfig.yml&f, then use &e/ai reload &for restart."
  api-key-missing: "Gemini API key &cmissing&f! &7(Can be set in the config.yml)"
  ai-failed: "Failed to get a response. &7(AI might be busy)"
  ai-invalid: "Received &cinvalid &fbuilding data. &7(Please try again)"
  build-error: "&cError &fwhile building&7: &e%error%"
  continue-error: "&cError &fapplying changes&7: &e%error%"
  json-validate: "&cInvalid &fmaterial or structure in AI response."
  usage: "&cIncorrect &fusage."
admin:
  reloaded: "Configuration &areloaded&f."
  model-set: "Model set to &b%model%&f."
chat:
  response: "%message%"