← Files ContraptifyARCHIVED FILE

plugin.json

5.74 KB · Nov 18, 2026 · 06:18 UTC

↓ Download file

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "contraptify",
  "version": "1.0.1",
  "description": "Design redstone machines with ChatGPT, test them tick by tick with Java Edition rules, and play with them in 3D.",
  "author": {
    "name": "Torsvik Labs",
    "email": "hello@contraptify.com",
    "url": "https://torsviklabs.com"
  },
  "homepage": "https://contraptify.com",
  "license": "Proprietary",
  "keywords": [
    "redstone",
    "simulator",
    "3d",
    "java edition"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Contraptify",
        "shortDescription": "Redstone machines, tested",
        "longDescription": "Describe a redstone machine for Minecraft: Java Edition, and ChatGPT designs it. Contraptify then runs the design tick by tick in a simulator that follows Java Edition 26.3's redstone rules: block update order, scheduled ticks, piston timing and quasi-connectivity. ChatGPT writes a test from what you asked for (what a player does and when, and what must happen then), reads which checks failed, and fixes the design until it passes. You get the machine in an interactive 3D viewer in the chat: press its buttons, flip its levers, run it tick by tick and click any part to read what it does, then build it in your world.\n\nIt handles doors, locks, clocks, counters, flip-flops, flying machines and more, from a few blocks to thousands. Ready-made examples include a 2x2 piston door, a combination lock, a 0-9 counter and a 00-59 lamp clock.\n\nContraptify only computes: it stores no designs, needs no account and collects nothing that identifies you. Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft.",
        "developerName": "Torsvik Labs",
        "category": "Entertainment",
        "capabilities": [],
        "websiteURL": "https://contraptify.com",
        "supportURL": "https://contraptify.com/help",
        "privacyPolicyURL": "https://contraptify.com/privacy",
        "termsOfServiceURL": "https://contraptify.com/terms",
        "defaultPrompt": [
          "Build me a 2x2 piston door that opens with a button.",
          "Show me the 0-9 counter example and press its button three times.",
          "Make a lamp that blinks once a second."
        ],
        "brandColor": "#B3261E",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Design and test a piston door from a description",
              "prompt": "Build me a 2x2 piston door that opens with a button and closes again by itself.",
              "tools_triggered": "simulate, show",
              "expected_behavior": "ChatGPT designs a door, runs simulate until the door's own test passes (it may take several rounds), then calls show; the 3D viewer opens with the door, and pressing its button opens it."
            },
            {
              "description": "Show a built-in example",
              "prompt": "Show me the 0-9 counter example and press its button three times.",
              "tools_triggered": "list_examples, show",
              "expected_behavior": "ChatGPT calls show with the example id (list_examples first is optional); the 3D viewer opens with the 0-9 counter, and three presses of its button make the display count to 3."
            },
            {
              "description": "Design a toggle circuit",
              "prompt": "Design a T flip-flop: one button press turns a lamp on, the next turns it off.",
              "tools_triggered": "simulate, show",
              "expected_behavior": "The design's test checks the lamp after each press and passes; the viewer opens with the circuit, and each press of its button toggles the lamp."
            },
            {
              "description": "Design a lock with a test of right and wrong codes",
              "prompt": "Make a 3-lever combination lock that lights a lamp only for the right code.",
              "tools_triggered": "simulate, show",
              "expected_behavior": "The test checks the right code and at least one wrong code and passes; the viewer opens, and the lamp lights only when the levers are set to the right code."
            },
            {
              "description": "Design a timed circuit",
              "prompt": "Make a lamp that blinks on and off once a second, and show it to me.",
              "tools_triggered": "simulate, show",
              "expected_behavior": "The test checks the lamp's timing over several cycles and passes; the viewer opens, and after its lever is flipped the lamp blinks about once a second."
            }
          ],
          "negative": [
            {
              "description": "A Minecraft question that needs no machine design or simulation; ChatGPT should answer from its own knowledge and call no Contraptify tool.",
              "prompt": "What is the best enchantment for a sword in Minecraft?"
            },
            {
              "description": "Building instructions that involve no redstone circuit; ChatGPT should answer directly and call no Contraptify tool.",
              "prompt": "How do I build a Nether portal?"
            },
            {
              "description": "A programming task unrelated to Minecraft; ChatGPT should write the script itself and call no Contraptify tool.",
              "prompt": "Write a Python script that counts from 1 to 10."
            }
          ]
        },
        "demo_recording_url": "https://contraptify.com/demo/chatgpt-review.mp4",
        "commerce": false
      },
      "publication": {
        "release_notes": "First public release: design, simulate and show redstone machines in a 3D viewer."
      },
      "apps": "./.app.json"
    }
  }
}

SHA-256: da80a02e03e5c95183890ea5e6cbe666e2641b62078d0b898038564e50a9d308