# Minecraft Custom Mod Builder ## Links - Product page URL: https://www.agentpmt.com/marketplace/minecraft-custom-mod-builder - Product markdown URL: https://www.agentpmt.com/marketplace/minecraft-custom-mod-builder?format=agent-md - Product JSON URL: https://www.agentpmt.com/marketplace/minecraft-custom-mod-builder?format=agent-json ## Overview - Product ID: 69f94706113a9d7251fe31e2 - Type: function - Unit type: request - Price: 1500 credits - Categories: Developer Tools, Video Game Design, 3D Asset Creation - Generated at: 2026-07-10T00:01:33.164Z ### Page Description Create structured Minecraft Bedrock add-ons, Bedrock skin packs, and Java Fabric/NeoForge mod projects with strict schemas, texture binding, validation, async build jobs, and install-readiness reporting. Use the verified async build path for anything a user should install; use source output and uploaded-source test jobs when an agent needs to edit code directly. ### Agent Description Deterministically generate, validate, preview, and test Minecraft Bedrock, Bedrock skin pack, Fabric, and NeoForge projects from structured specs. This product does not accept raw natural-language prompts; convert user intent into the schema from get_instructions. Use start_build_job for install-ready work: it returns a task_id, then get_build_job returns result.runtime_verification, result.quality_gate, result.ready_for_install, and artifacts. Treat ready_for_install=false, quality_gate.status!='passed', or verification_not_run=true as not shippable. create_mod_project is synchronous unverified source/debug output and accepts only verification_level='off'. For behavior the declarative schema cannot faithfully express, generate source, edit it, upload the zip, then call start_build_job with source_archive_file_id, source_test_mode, and verification_contract. Do not silently reinterpret intent; use fidelity_policy only for explicit user-approved approximations. Placeholder/debug-only actions require fidelity_policy='allow_explicit_stub' and are not install-ready. Features whose enabled_platforms exclude the target platform are rejected instead of dropped. Use one ItemSpec per in-game item, attach tool/weapon/armor/food/durability/enchantable fields to that same item, provide a texture for every visible asset, and call get_instructions before authoring complex specs. ## Details ### Details Create structured Minecraft Bedrock add-ons, Bedrock skin packs, and Java Fabric/NeoForge mod projects with strict schemas, texture binding, validation, async build jobs, and install-readiness reporting. Use the verified async build path for anything a user should install; use source output and uploaded-source test jobs when an agent needs to edit code directly. ### Actions - `list_capabilities` (2 credits): Return supported platforms, pinned versions, feature/action matrices, implementation_status, quality-gate fields, and unsupported families. - `validate_mod_project` (5 credits): Validate a structured Minecraft mod spec or a previously generated/uploaded source archive without writing install artifacts. - `create_mod_project` (15 credits): Synchronous unverified source/debug generation. Accepts only verification_level='off'; use start_build_job for install-ready final artifacts. - `start_build_job` (15 credits): Queue verified async generation or uploaded-source testing. Poll get_build_job and ship only when result.ready_for_install=true and quality_gate.status='passed'. - `get_build_job` (2 credits): Fetch one queued Minecraft build job by task_id. Poll after start_build_job until status is completed or failed; inspect result.ready_for_install and quality_gate. - `list_build_jobs` (2 credits): List recent Minecraft build jobs for the active budget to recover task_id values or inspect recent queued/completed builds. - `render_preview_image` (5 credits): Render and upload an enlarged PNG preview for an item, block, entity, texture, source archive, or direct image file. ### Use Cases Create verified Minecraft Bedrock add-ons (.mcaddon), Build Fabric and NeoForge source projects and jars through async build jobs, Generate Bedrock skin packs (.mcpack), Create items, weapons, tools, armor, blocks, ores, food, mobs, bosses, recipes, loot tables, enchantments, trades, scoreboards, events, commands, particles, sounds, worldgen, biomes, structures, and dimensions, Preview texture and icon assets before installation, Download editable source projects, Upload agent-edited source archives for compile/package/runtime quality-gate testing, Detect non-install-ready builds before users install broken mods ### Workflows Using This Tool No public workflows currently reference this product. ### Related Content #### Creative AI Agents Get a No-Code Minecraft Mod Builder - Type: article - Page URL: https://www.agentpmt.com/articles/creative-ai-agents-get-a-no-code-minecraft-mod-builder - Markdown URL: https://www.agentpmt.com/articles/creative-ai-agents-get-a-no-code-minecraft-mod-builder?format=agent-md The Minecraft Custom Mod Builder turns a structured spec into a ready-to-install Bedrock or Java mod — deterministic, cross-platform, and callable by any agent on AgentPMT. ## Integration Details ### DynamicMCP - Setup page URL: https://www.agentpmt.com/dynamic-mcp - Claude setup guide: https://www.agentpmt.com/dynamic-mcp#platform=claude - ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp#platform=chatgpt - Cursor setup guide: https://www.agentpmt.com/dynamic-mcp#platform=cursor - Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp#platform=windsurf Use the local router for command-based MCP clients. It forwards requests to `https://api.agentpmt.com/mcp` and does not execute tools locally. ```bash npm install -g @agentpmt/mcp-router agentpmt-setup ``` ### REST API The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials. - Purchase endpoint: https://api.agentpmt.com/products/purchase - Authorization format: `Bearer ` ```bash curl -X POST "https://api.agentpmt.com/products/purchase" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \ -d '{ "product_id": "69f94706113a9d7251fe31e2", "parameters": { "action": "get_instructions" } }' ``` ### Autonomous Agents Autonomous agents can access this tool through AgentAddress credit balances or direct x402 payments. Use the Autonomous Agent API reference for endpoint shapes after choosing the access pattern below. - Autonomous Agent API reference URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents - Autonomous Agent API reference markdown URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents?format=agent-md - Credit-Based Access Using AgentAddress: https://www.agentpmt.com/docs/autonomous-agents/credit-based-tool-usage-with-agentaddress - AgentAddress is preferred for persistent file access, stored platform state, and maximum tool use ability across repeated calls. - Direct x402 is for independent one-off tool calls that do not require shared files or stored platform state. - Direct x402 public payments: USDC on Base, Arbitrum, Optimism, Polygon, and Avalanche. - X402 Payment Instructions: https://www.agentpmt.com/docs/autonomous-agents/x402-payments-for-tool-usage #### Product Skill Package This product has a published Agent Skill package for product-specific operating instructions. - Skill slug: minecraft-custom-mod-builder - Version: 1.0.4 - Download SKILL.md: https://raw.githubusercontent.com/AgentPMT/agent-skills/main/skills/minecraft-custom-mod-builder/SKILL.md - Package source: https://github.com/AgentPMT/agent-skills/tree/main/skills/minecraft-custom-mod-builder - OpenClaw listing: https://clawhub.ai/agentpmt/minecraft-custom-mod-builder - OpenClaw install: `openclaw skills install minecraft-custom-mod-builder` - skills.sh install: `npx skills add AgentPMT/agent-skills --skill minecraft-custom-mod-builder` - Last published: 2026-07-09T18:25:40.353Z ### Schema #### Parameters - Schema type: actions ```json { "actions": { "get_instructions": { "description": "Return the canonical Minecraft Mod Builder instructions. Call before authoring complex specs or source-archive verification contracts.", "price_per_unit": 1 }, "list_capabilities": { "description": "Return supported platforms, pinned versions, feature/action matrices, implementation_status, quality-gate fields, and unsupported families.", "properties": { "target_platform": { "type": "string", "description": "Optional platform filter.", "required": false, "enum": [ "bedrock", "bedrock_skinpack", "fabric", "neoforge" ] } }, "price_per_unit": 2 }, "validate_mod_project": { "description": "Validate a structured Minecraft mod spec or a previously generated/uploaded source archive without writing install artifacts.", "properties": { "target_platform": { "type": "string", "description": "bedrock, bedrock_skinpack, fabric, or neoforge.", "required": false, "enum": [ "bedrock", "bedrock_skinpack", "fabric", "neoforge" ] }, "mod_id": { "type": "string", "description": "Lowercase namespace matching ^[a-z][a-z0-9_]{1,63}$.", "required": false }, "mod_name": { "type": "string", "description": "Human-readable mod name for spec mode.", "required": false }, "features": { "type": "object", "description": "FeatureSet object for spec mode. Use get_instructions for nested fields.", "required": false }, "skin_pack": { "type": "object", "description": "Skin pack definition for target_platform=bedrock_skinpack.", "required": false }, "source_archive_file_id": { "type": "string", "description": "File Manager file_id for a generated or agent-edited source zip to validate instead of a spec.", "required": false }, "minecraft_version": { "type": "string", "description": "Pinned version. Omit unless explicitly needed.", "required": false }, "allow_experimental_bedrock_features": { "type": "boolean", "description": "Allow Bedrock experimental features when required.", "required": false } }, "price_per_unit": 5 }, "create_mod_project": { "description": "Synchronous unverified source/debug generation. Accepts only verification_level='off'; use start_build_job for install-ready final artifacts.", "properties": { "target_platform": { "type": "string", "description": "bedrock, bedrock_skinpack, fabric, or neoforge.", "required": true, "enum": [ "bedrock", "bedrock_skinpack", "fabric", "neoforge" ] }, "mod_id": { "type": "string", "description": "Lowercase namespace matching ^[a-z][a-z0-9_]{1,63}$.", "required": true }, "mod_name": { "type": "string", "description": "Human-readable mod name.", "required": true }, "features": { "type": "object", "description": "FeatureSet object. Use arrays such as items, blocks, entities, events, commands, client_modules, machines, recipes, particles, sounds, functions, storage, worldgen, scoreboards, biomes, dimensions, effects, and skins. See get_instructions for nested fields.", "required": false }, "skin_pack": { "type": "object", "description": "Skin pack definition for target_platform=bedrock_skinpack.", "required": false }, "assets": { "type": "object", "description": "Optional textures, sounds, particles, models, and language entries.", "required": false }, "advanced_resources": { "type": "array", "description": "Raw files with path plus content_base64, content_text, or source_file_id.", "required": false, "items": { "type": "object" } }, "mod_metadata": { "type": "object", "description": "Optional metadata such as version, license, authors, logo_texture, brand_color_hex, java_side, and bedrock_experiments.", "required": false }, "minecraft_version": { "type": "string", "description": "Pinned version. Omit unless explicitly needed.", "required": false }, "description": { "type": "string", "description": "Short mod description.", "required": false }, "compatibility_mode": { "type": "string", "description": "strict or allow_platform_passthrough.", "required": false, "enum": [ "strict", "allow_platform_passthrough" ] }, "fidelity_policy": { "type": "string", "description": "preserve_intent, acknowledged_approximation, or allow_explicit_stub. Stub policy produces non-install-ready scaffolding.", "required": false, "enum": [ "preserve_intent", "acknowledged_approximation", "allow_explicit_stub" ] }, "user_intent_summary": { "type": "string", "description": "Optional concise intent statement for deterministic classification; not used for silent reinterpretation.", "required": false }, "verification_level": { "type": "string", "description": "Must be off for create_mod_project. Use start_build_job for boot_smoke or behavior.", "required": false, "enum": [ "off", "boot_smoke", "behavior" ] }, "output_mode": { "type": "string", "description": "installable, source, or both.", "required": false, "enum": [ "installable", "source", "both" ] }, "build_jar": { "type": "boolean", "description": "Fabric/NeoForge only. Build jar when true.", "required": false }, "validate_output": { "type": "boolean", "description": "Run output validation when supported.", "required": false }, "include_file_preview": { "type": "boolean", "description": "Include capped text previews in generated_files.", "required": false }, "allow_experimental_bedrock_features": { "type": "boolean", "description": "Allow Bedrock experimental features when required.", "required": false } }, "price_per_unit": 15 }, "start_build_job": { "description": "Queue verified async generation or uploaded-source testing. Poll get_build_job and ship only when result.ready_for_install=true and quality_gate.status='passed'.", "properties": { "target_platform": { "type": "string", "description": "bedrock, bedrock_skinpack, fabric, or neoforge.", "required": true, "enum": [ "bedrock", "bedrock_skinpack", "fabric", "neoforge" ] }, "mod_id": { "type": "string", "description": "Lowercase namespace matching ^[a-z][a-z0-9_]{1,63}$. Required for spec builds and source-archive jobs.", "required": true }, "mod_name": { "type": "string", "description": "Human-readable mod name. Required for spec builds; not required when source_archive_file_id is provided.", "required": false }, "features": { "type": "object", "description": "FeatureSet object for generated spec builds. Omit when testing uploaded source_archive_file_id.", "required": false }, "skin_pack": { "type": "object", "description": "Skin pack definition for target_platform=bedrock_skinpack.", "required": false }, "source_archive_file_id": { "type": "string", "description": "File Manager file_id for a generated or agent-edited source zip. When provided, the job tests the uploaded source without regenerating over edits.", "required": false }, "source_test_mode": { "type": "string", "description": "For source_archive_file_id jobs: test_only for iteration, or test_and_package to return install artifacts only after the quality gate passes.", "required": false, "enum": [ "test_only", "test_and_package" ] }, "verification_contract": { "type": "object", "description": "Required for source_archive_file_id jobs with verification enabled. Include expected_checks describing what the edited source must prove.", "required": false }, "verification_level": { "type": "string", "description": "behavior by default for install-ready builds; boot_smoke for runtime-load only; off for debug/unverified jobs.", "required": false, "enum": [ "off", "boot_smoke", "behavior" ] }, "fidelity_policy": { "type": "string", "description": "preserve_intent, acknowledged_approximation, or allow_explicit_stub. Stub policy produces non-install-ready scaffolding.", "required": false, "enum": [ "preserve_intent", "acknowledged_approximation", "allow_explicit_stub" ] }, "user_intent_summary": { "type": "string", "description": "Optional concise intent statement for deterministic classification; not used for silent reinterpretation.", "required": false }, "assets": { "type": "object", "description": "Optional textures, sounds, particles, models, and language entries.", "required": false }, "advanced_resources": { "type": "array", "description": "Raw files with path plus content_base64, content_text, or source_file_id.", "required": false, "items": { "type": "object" } }, "mod_metadata": { "type": "object", "description": "Optional metadata such as version, license, authors, logo_texture, brand_color_hex, java_side, and bedrock_experiments.", "required": false }, "minecraft_version": { "type": "string", "description": "Pinned version. Omit unless explicitly needed.", "required": false }, "description": { "type": "string", "description": "Short mod description.", "required": false }, "compatibility_mode": { "type": "string", "description": "strict or allow_platform_passthrough.", "required": false, "enum": [ "strict", "allow_platform_passthrough" ] }, "output_mode": { "type": "string", "description": "installable, source, or both.", "required": false, "enum": [ "installable", "source", "both" ] }, "build_jar": { "type": "boolean", "description": "Fabric/NeoForge only. Build jar when true.", "required": false }, "validate_output": { "type": "boolean", "description": "Run output validation when supported.", "required": false }, "include_file_preview": { "type": "boolean", "description": "Include capped text previews in generated_files.", "required": false }, "allow_experimental_bedrock_features": { "type": "boolean", "description": "Allow Bedrock experimental features when required.", "required": false } }, "price_per_unit": 15 }, "get_build_job": { "description": "Fetch one queued Minecraft build job by task_id. Poll after start_build_job until status is completed or failed; inspect result.ready_for_install and quality_gate.", "properties": { "task_id": { "type": "string", "description": "Build job id returned by start_build_job.", "required": true }, "timeout_seconds": { "type": "integer", "description": "HTTP timeout for the status lookup.", "required": false } }, "price_per_unit": 2 }, "list_build_jobs": { "description": "List recent Minecraft build jobs for the active budget to recover task_id values or inspect recent queued/completed builds.", "properties": { "limit": { "type": "integer", "description": "Maximum jobs to return, from 1 to 100.", "required": false }, "timeout_seconds": { "type": "integer", "description": "HTTP timeout for the list lookup.", "required": false } }, "price_per_unit": 2 }, "render_preview_image": { "description": "Render and upload an enlarged PNG preview for an item, block, entity, texture, source archive, or direct image file.", "properties": { "target_platform": { "type": "string", "description": "Optional platform context.", "required": false, "enum": [ "bedrock", "bedrock_skinpack", "fabric", "neoforge" ] }, "mod_id": { "type": "string", "description": "Lowercase namespace for spec/source preview.", "required": false }, "mod_name": { "type": "string", "description": "Human-readable mod name for spec preview.", "required": false }, "features": { "type": "object", "description": "FeatureSet object for spec preview.", "required": false }, "skin_pack": { "type": "object", "description": "Skin pack definition for target_platform=bedrock_skinpack.", "required": false }, "source_archive_file_id": { "type": "string", "description": "File Manager file_id for a generated source zip to preview from.", "required": false }, "preview_source_file_id": { "type": "string", "description": "File Manager image file_id for direct image preview.", "required": false }, "preview_target_kind": { "type": "string", "description": "item, block, entity, or texture.", "required": false, "enum": [ "item", "block", "entity", "texture" ] }, "preview_target_id": { "type": "string", "description": "Feature id or namespaced id, such as flame_sword or flame_tools:flame_sword.", "required": false }, "preview_size": { "type": "integer", "description": "Square preview PNG size from 32 to 1024 pixels.", "required": false }, "preview_background": { "type": "string", "description": "checkerboard, transparent, white, or black.", "required": false, "enum": [ "checkerboard", "transparent", "white", "black" ] } }, "price_per_unit": 5 } } } ``` ### Usage Instructions Use get_instructions as the canonical source before writing complex Minecraft specs. For final user-deliverable mods, call start_build_job, poll get_build_job, and ship only when result.ready_for_install is true and result.quality_gate.status is 'passed'. Synchronous create_mod_project is for quick unverified source/debug output; do not present it as a working final mod. If a requested behavior is beyond the declarative schema, use the agent-edited source loop: generate source, edit the code, upload the zip, then call start_build_job with source_archive_file_id, source_test_mode='test_only' while iterating, and a verification_contract.expected_checks list that states what the edited source must prove. Rerun with source_test_mode='test_and_package' only when the quality gate passes. Do not silently substitute a nearby mechanic for the user's intent; use fidelity_policy='acknowledged_approximation' only after explicit user approval. Placeholder/scaffolding-only actions require fidelity_policy='allow_explicit_stub' and always produce non-install-ready output until real source code is added and verified. Platform-mismatched features are validation failures, not warnings and not silently filtered. ### Additional Product Content ## Your own Minecraft mods — no coding required Minecraft Custom Mod Builder turns a simple description into a finished, installable mod. Tell it what you want to add to the game — a glowing ore, a flaming sword, a rideable beast, or a brand-new dimension — and get back a ready-to-play file in seconds. Build for **Minecraft Bedrock** (phones, console, and Windows) or **Minecraft Java** with **Fabric** and **NeoForge**. ## What you can build 1. **Items & gear** — swords, pickaxes, axes, shovels, hoes, armor sets, food, fuel, and projectiles, each placed in the right creative-inventory tab. 2. **Blocks & world content** — custom blocks, ores with world generation, crops, plants, machines, and storage containers. 3. **Mobs & bosses** — passive animals, hostile monsters, neutral and tameable creatures, rideable mounts, and boss battles. 4. **Gameplay systems** — crafting recipes, loot tables, enchantments, status effects, villager-style trades, and custom commands. 5. **Worlds** — custom biomes, dimensions, structures, and spawn rules. 6. **Skin packs** — Bedrock skin packs (.mcpack) for a fresh look. 7. **Special behavior** — wire up actions like a sword that ignites enemies on hit or a block that triggers an effect when used. ## Make it look exactly how you want Give every item, block, and creature its own texture. Pick a color, upload your own artwork, or drop in a generated pixel-art sprite. Preview each texture and icon in advance so you know it looks right before you ever install the mod. ## How it works 1. **Describe it.** Say what you want to add to Minecraft. 2. **Preview it.** Check the generated textures and icons. 3. **Install & play.** Download the ready-to-install file and load it into your game or server. ## What you get 1. Ready-to-install **.mcaddon**, **.mcpack**, and **.jar** files. 2. Editable source projects so you can keep building and customizing. 3. Preview images of your textures and icons. ## Who it's for Creators, streamers, realm and server owners, educators, and players who want custom Minecraft content — fast, and without learning to code. ### Frequently Asked Questions #### How do I connect this tool to an external agent? - Page URL: https://www.agentpmt.com/faq - Markdown URL: https://www.agentpmt.com/faq?format=agent-md You can install the local MCP server by opening a terminal and running: ``` npm install -g @agentpmt/mcp-router agentpmt-setup ``` This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc. Alternatively you can connect to the hosted version with this config block, no installation required: ``` { "mcpServers": { "agentpmt": { "type": "streamable-http", "url": "https://api.agentpmt.com/mcp", "headers": { "Authorization": "Bearer ", "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}" } } } } ``` [View MCP Connection Instructions](/docs/mcp-reference/connection) for more details. #### How does an external agent use this tool? - Page URL: https://www.agentpmt.com/faq - Markdown URL: https://www.agentpmt.com/faq?format=agent-md After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent: > Use the AgentPMT-Tool-Search-and-Execution tool. First call action 'get\_instructions' so you know how to use the tool search interface. Then call action 'get\_schema' with tool\_id 69f94706113a9d7251fe31e2 ("Minecraft Custom Mod Builder"). After reading the schema and any returned instructions, tell me what this tool can do, we are going to be using it The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT. #### Can I use my own artwork for textures? - Page URL: https://www.agentpmt.com/faq#faq-6a1227c7675a75b67fa934af - Markdown URL: https://www.agentpmt.com/faq?format=agent-md#faq-6a1227c7675a75b67fa934af - Tags: Product Specific Yes. Give any item, block, or creature a solid color, upload your own image, or use a generated pixel-art sprite — and preview it before you install. #### Do I need to know how to code? - Page URL: https://www.agentpmt.com/faq#faq-6a1227c7675a75b67fa934ac - Markdown URL: https://www.agentpmt.com/faq?format=agent-md#faq-6a1227c7675a75b67fa934ac - Tags: Product Specific No. Just describe what you want to add to Minecraft and you'll get back a finished, installable mod file — textures, items, behavior, and all. #### What can I create? - Page URL: https://www.agentpmt.com/faq#faq-6a1227c7675a75b67fa934b0 - Markdown URL: https://www.agentpmt.com/faq?format=agent-md#faq-6a1227c7675a75b67fa934b0 - Tags: Product Specific Items, weapons, tools, and armor; blocks, ores, and crops; custom mobs and bosses; recipes, loot tables, enchantments, and trades; plus biomes, dimensions, and structures. #### What do I get when my mod is finished? - Page URL: https://www.agentpmt.com/faq#faq-6a1227c7675a75b67fa934ae - Markdown URL: https://www.agentpmt.com/faq?format=agent-md#faq-6a1227c7675a75b67fa934ae - Tags: Product Specific A ready-to-install file you can load straight into Minecraft, preview images of your textures and icons, and editable source files so you can keep customizing. #### Which versions of Minecraft does it support? - Page URL: https://www.agentpmt.com/faq#faq-6a1227c7675a75b67fa934ad - Markdown URL: https://www.agentpmt.com/faq?format=agent-md#faq-6a1227c7675a75b67fa934ad - Tags: Product Specific Both editions. It builds Bedrock add-ons (.mcaddon) and skin packs (.mcpack) for phones, console, and Windows, plus Java mods for Fabric and NeoForge (.jar). ### Dependencies This product has no public dependency products.