ArtixBuilder

A plugin designed to use ai to build your favorite build

Command:
/build <prompt>
Permission: OP

EXAMPLE
/build a nice little house
/build parkour
/build heart


# Configuration for ArtixBuilder AI Integration
# API Settings - Configure these to match your AI provider (e.g., OpenAI compatible API)
api:
# The base URL of the AI API endpoint (e.g., " https://api.openai.com/v1/chat/completions")
base_url: "YOUR_API_BASE_URL_HERE"
# Your API Key for authentication
key: "YOUR_API_KEY_HERE"
# The specific AI model to use (e.g., "gpt-3.5-turbo", "gpt-4")
model: "gpt-3.5-turbo"
# Build Settings
build:
# Maximum number of blocks the AI can place in a single build command.
max_blocks: 5000
# Maximum distance from the player's origin point in any direction (X, Y, Z) a block can be placed.
# This defines a cube centered on the player: (max_dimension*2+1)^3
max_dimension: 32
# Delay between placing each block in ticks (20 ticks = 1 second). 0 for instant placement (can cause lag).
# Set to 1 or higher for large structures on busy servers.
placement_delay_ticks: 1
# Request Settings
request:
# Maximum time in seconds to wait for a response from the AI API.
timeout_seconds: 60
# The system prompt sent to the AI to guide its response format.
# {PROMPT} will be replaced with the player's input.
# {COORDINATES} will be replaced with the player's starting coordinates.
# The AI *must* respond ONLY with a valid JSON array of block objects.
system_prompt: |
You are a Minecraft structure generator. The user wants to build '{PROMPT}' starting at coordinates {COORDINATES}.
Your task is to generate a list of blocks and their relative coordinates (x, y, z) from the starting point to create this structure.
Respond ONLY with a valid JSON array formatted like this: [{"x": relative_x, "y": relative_y, "z": relative_z, "block": "minecraft:block_id"}, ...].
Use standard Minecraft block IDs (e.g., "minecraft ak_planks", "minecraft:stone_bricks").
Do not include any explanations, introductions, or text outside the JSON array.
Keep the structure reasonably sized and functional based on the prompt.
The 'y' coordinate represents height relative to the starting block. y=0 is the level of the starting block.
Ensure the JSON is well-formed and contains only the block data.