plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "blockgpt",
  "version": "0.4.14",
  "description": "Create Minecraft structures from text or image links and download schematic files.",
  "author": {
    "name": "BlockGPT"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "BlockGPT",
        "shortDescription": "Create Minecraft builds",
        "longDescription": "BlockGPT helps Minecraft players create structures from text descriptions or publicly accessible HTTPS image links. Generate castles, buildings, statues and other designs, choose a size from 50 to 300, and select a preset block palette or a custom list of supported Minecraft blocks. Download completed builds as .schem, .litematic or legacy .schematic files for use with compatible Minecraft tools.\n\nConnect your BlockGPT account to view your remaining build allowance, list saved builds and check generation progress. Completed results include a link to the build on BlockGPT and a schematic download link. Image input determines the shape; text cannot modify it.\n\nA BlockGPT account is required. The plugin creates downloadable build files; it cannot join a Minecraft server or place blocks in a running world. Direct chat attachment transfer, .nbt export and conversion of existing builds are not supported.",
        "developerName": "BlockGPT",
        "category": "Creativity",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png",
        "defaultPrompt": [
          "Build a colourful rainbow frog in Minecraft.",
          "Show my latest BlockGPT builds.",
          "How many builds do I have left?"
        ],
        "websiteURL": "https://blockgpt.ai/",
        "privacyPolicyURL": "https://blockgpt.ai/privacy",
        "termsOfServiceURL": "https://blockgpt.ai/terms",
        "capabilities": [
          "Read",
          "Write"
        ],
        "supportURL": "https://blockgpt.ai/support"
      },
      "publication": {
        "release_notes": "Changes the first conversation starter to a colourful rainbow frog, highlighting organic Minecraft builds.",
        "countries": []
      },
      "review": {
        "commerce_description": "Users primarily purchase subscriptions and may also buy additional build credits on blockgpt.ai. The plugin uses the connected account's existing allowance and credits and does not initiate checkout or process payment.",
        "test_cases": {
          "positive": [
            {
              "description": "Use a dedicated review account with current allowance or eligible purchased credits. Keep the same request ID on retries. Live admin generation and schematic download are verified; a live paid-account debit has not been exercised.",
              "prompt": "Create a medieval stone castle in Minecraft, size 120, using released blocks, and export it as a .schem file.",
              "tools_triggered": "generate_build; get_build; get_download",
              "expected_behavior": "generate_build receives a 3D subject description of medieval gray masonry castle geometry, with no Minecraft/voxel/block-built styling or specific block IDs in prompt. Supply size 120, block_palette all-release, export_format schem, and a fresh UUID request_id separately. Keep IDs internal and reuse the request on retries. Return the started build-page link without a polling loop. Check once when asked, or subscribe to build.finished in a supported Work chat when the user asks for completion notification. Once completed, retrieve get_download and return its actual build_url and download_url as descriptive links. Do not open cards or embed images."
            },
            {
              "description": "Connected dedicated test account has a known allowance and subscription state.",
              "prompt": "How many BlockGPT builds do I have left?",
              "tools_triggered": "get_account",
              "expected_behavior": "Report the connected account's allowance and subscription state from get_account. Do not invent a balance, price or entitlement."
            },
            {
              "description": "Dedicated account has several sample builds. No other account's builds may appear.",
              "prompt": "Show my five latest Minecraft builds.",
              "tools_triggered": "list_builds",
              "expected_behavior": "Call list_builds with limit 5 and offset 0. Display only returned owned builds in newest-first order, including statuses, without displaying internal IDs unless requested."
            },
            {
              "description": "Conversation contains a valid owned in-progress build ID returned by generation or history.",
              "prompt": "Is that Minecraft build finished yet?",
              "tools_triggered": "get_build",
              "expected_behavior": "Call get_build using the exact referenced build_id. Report its actual status and only show completion/download information when returned. Do not start a replacement build."
            },
            {
              "description": "Dedicated account has a completed sample build; prior conversation identifies its actual UUID.",
              "prompt": "Give me the schematic download for that completed build.",
              "tools_triggered": "get_download",
              "expected_behavior": "Call get_download with the owned completed build ID and return both its actual BlockGPT build_url and HTTPS download_url as descriptive links, without embedding images or opening cards. Do not claim format conversion or expose another account's file."
            }
          ],
          "negative": [
            {
              "description": "Running-world manipulation is unsupported. Explain that the plugin produces schematic files; do not invoke generation or claim world access.",
              "prompt": "Join my Minecraft server and place this castle at coordinates 100, 64, 200."
            },
            {
              "description": "Checkout is unsupported. Explain that subscriptions and credits are purchased on blockgpt.ai; do not call build tools or claim a payment.",
              "prompt": "Buy me a BlockGPT subscription and charge my saved card."
            },
            {
              "description": "Format conversion/upload editing is unsupported. Explain the limitation; do not invoke generate_build or claim conversion.",
              "prompt": "Convert this uploaded Minecraft world save into a Bedrock add-on."
            }
          ]
        },
        "demo_recording_url": "https://www.youtube.com/watch?v=Ttb8vKpeFzY"
      },
      "apps": "./.app.json"
    }
  }
}