####################################################################################################
# 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.5-flash-lite : The most up-to-date Gemini AI with even more improvements.
  #   - 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.5-flash-lite"

  # 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

  sanitize:
    enabled: true         # turn on basic sanity passes before building - this is AI-Minecrafts' internal code that tries to improve accuracy of AI build requests

  autohollow:
    enabled: true         # auto-hollow large solid cuboids
    min_edge: 4           # consider a volume "room-like" from this edge length
    min_volume: 125       # and/or this volume (e.g., 5x5x5)
    default_thickness: 1  # shell thickness when auto-hollowing (how many blocks wide/thick does the wall have to be for the area to be considered a room - making it holo'd out)

  glass:
    shell_only: true          # prevent glass from spawning inside interiors
    shell_min_thickness: 1    # how thick the shell band check should be

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