AgentPMT
Minecraft Custom Mod Builder

Minecraft Custom Mod Builder

Function

Available ActionsEach successful request consumes credits as outlined below.

list_capabilities25crvalidate_mod_project25crcreate_mod_project25crrender_preview_image25cr

Details

Create your own custom Minecraft mods and add-ons — no coding required. Just describe what you want to add to the game, from a flaming sword or a glowing ore to a rideable mob, a custom skin pack, or a whole new dimension, and get back a ready-to-install file in seconds. Build for Minecraft Bedrock (.mcaddon) and Java with Fabric and NeoForge (.jar). Create items, weapons, tools, armor, blocks, ores, food, mobs, bosses, biomes, structures, recipes, loot tables, enchantments, trades, and special in-game behavior — each with its own custom texture from a color, your own artwork, or generated pixel art. Preview every icon before you install, and download editable source so you can keep building. Perfect for creators, streamers, server owners, and players who want their own Minecraft content fast.

Use Cases

Create installable Minecraft Bedrock add-ons (.mcaddon) from a simple description, Build Java mods for Fabric and NeoForge and download the .jar, Design custom swords, pickaxes, tools, and armor with their own textures, Add new blocks, ores, and crops with world generation, Create custom mobs from passive animals to hostile bosses and tameable pets, Make Bedrock skin packs (.mcpack) for a fresh character look, Give items special behavior like a sword that sets enemies on fire, Add custom crafting recipes, loot tables, enchantments, and villager trades, Generate custom biomes, dimensions, and structures, Use a color, your own image, or generated pixel art for every texture, Preview textures and icons before installing, Get editable source files to keep customizing your mod

Actions(4)

list_capabilities25cr1 param

Return supported platforms, pinned dependencies, feature kinds, event kinds, action kinds, output artifacts, unsupported categories, the v2 schema version, the major capability matrix, and the Bedrock component registry derived from the pinned Mojang Bedrock Samples archive.

Return supported platforms, pinned dependencies, feature kinds, event kinds, action kinds, output artifacts, unsupported categories, the v2 schema version, the major capability matrix, and the Bedrock component registry derived from the pinned Mojang Bedrock Samples archive.

target_platformstring

Target platform. 'bedrock' generates a .mcaddon for Minecraft Bedrock Edition. 'bedrock_skinpack' generates a .mcpack skin pack. 'fabric' / 'neoforge' generate Java mod source zips and built jars.

Values:
bedrockbedrock_skinpackfabricneoforge
validate_mod_project25cr13 params

Validate either a structured mod specification (spec mode) or a previously generated source archive (archive mode). Spec mode: provide target_platform, mod_id, mod_name, features (or skin_pack for skinpacks). Archive mode: provide source_archive_file_id. Returns a validation report with error codes and warnings; does NOT write artifacts.

Validate either a structured mod specification (spec mode) or a previously generated source archive (archive mode). Spec mode: provide target_platform, mod_id, mod_name, features (or skin_pack for skinpacks). Archive mode: provide source_archive_file_id. Returns a validation report with error codes and warnings; does NOT write artifacts.

target_platformstring

Required for spec-mode validation. Optional in archive-mode (omit when passing source_archive_file_id). One of bedrock, bedrock_skinpack, fabric, neoforge.

Values:
bedrockbedrock_skinpackfabricneoforge
mod_idstring

Required for spec-mode validation (lowercase ^[a-z][a-z0-9_]{1,63}$). Optional in archive-mode.

mod_namestring

Required for spec-mode validation. Optional in archive-mode.

minecraft_versionstring

Pinned Minecraft version. Omit to use the platform default.

descriptionstring

Short mod description shown in the pack metadata.

compatibility_modestring
Values:
strictallow_platform_passthrough
Default: strict
mod_metadataobject

Optional ModMetadataSpec: version, license, authors, homepage_url, issue_tracker_url, credits, logo_texture, brand_color_hex (#RRGGBB), java_side, bedrock_experiments. See get_instructions for the full shape.

assetsobject

Optional AssetSetSpec containing pre-bound textures/sounds/particles/models/language entries: {textures: NamedAssetSpec[], sounds: NamedAssetSpec[], particles: NamedAssetSpec[], models: NamedAssetSpec[], language: {locale: {key: value}}}. See get_instructions for shape.

advanced_resourcesarray

Escape-hatch list of AdvancedResourceSpec entries for files the structured surface does not model (raw JSON blobs, custom sound definitions, etc.). Each entry has {path, content_base64|content_text|source_file_id, content_type}.

Array of: object
featuresobject

Structured feature set (items, blocks, entities, events, etc.). Required for spec-mode validation on non-skinpack targets.

Properties:
animation_controllers(array)
animations(array)
biomes(array)
blocks(array)
commands(array)
damage_types(array)
dimensions(array)
effects(array)
enchantments(array)
entities(array)
events(array)
functions(array)
game_rules(array)
items(array)
localizations(array)
loot_tables(array)
machines(array)
particles(array)
recipes(array)
render_controllers(array)
scoreboards(array)
sounds(array)
storage(array)
structures(array)
trades(array)
transportation(array)
ui(array)
worldgen(array)
skin_packobject

Skin pack definition. Required for spec-mode validation when target_platform='bedrock_skinpack'.

Properties:
display_name(string)
pack_id(string)
skins(array)
allow_experimental_bedrock_featuresboolean

Allow Bedrock features that require experimental world toggles.

source_archive_file_idstring

File Manager file_id for a previously generated source zip. Supply this for archive-mode validation (skips spec validation; replays the zip's contents).

create_mod_project25cr16 params(3 required)

Generate mod artifacts and upload them to File Manager. Returns artifact file_ids, signed URLs, generated file manifests, validation results, install instructions, warnings, and build reports. Always follow this call with render_preview_image to confirm the icon before asking the user to install.

Generate mod artifacts and upload them to File Manager. Returns artifact file_ids, signed URLs, generated file manifests, validation results, install instructions, warnings, and build reports. Always follow this call with render_preview_image to confirm the icon before asking the user to install.

target_platformrequiredstring

Required. One of bedrock, bedrock_skinpack, fabric, neoforge. Legacy 'forge' is rejected with a migration error pointing to 'neoforge'.

Values:
bedrockbedrock_skinpackfabricneoforge
mod_idrequiredstring

Required. Lowercase ^[a-z][a-z0-9_]{1,63}$. Becomes the mod namespace in generated identifiers (e.g. <mod_id>:flame_sword).

mod_namerequiredstring

Human-readable mod name shown in the pack list.

minecraft_versionstring

Pinned Minecraft version. Omit to use the platform default.

descriptionstring

Short mod description shown in the pack metadata.

compatibility_modestring
Values:
strictallow_platform_passthrough
Default: strict
mod_metadataobject

Optional ModMetadataSpec: version, license, authors, homepage_url, issue_tracker_url, credits, logo_texture, brand_color_hex (#RRGGBB), java_side, bedrock_experiments. See get_instructions for the full shape.

assetsobject

Optional AssetSetSpec containing pre-bound textures/sounds/particles/models/language entries: {textures: NamedAssetSpec[], sounds: NamedAssetSpec[], particles: NamedAssetSpec[], models: NamedAssetSpec[], language: {locale: {key: value}}}. See get_instructions for shape.

advanced_resourcesarray

Escape-hatch list of AdvancedResourceSpec entries for files the structured surface does not model (raw JSON blobs, custom sound definitions, etc.). Each entry has {path, content_base64|content_text|source_file_id, content_type}.

Array of: object
featuresobject

Structured feature set. Required when target_platform is bedrock/fabric/neoforge. Omit when target_platform='bedrock_skinpack' (use skin_pack instead).

Properties:
animation_controllers(array)
animations(array)
biomes(array)
blocks(array)
commands(array)
damage_types(array)
dimensions(array)
effects(array)
enchantments(array)
entities(array)
events(array)
functions(array)
game_rules(array)
items(array)
localizations(array)
loot_tables(array)
machines(array)
particles(array)
recipes(array)
render_controllers(array)
scoreboards(array)
sounds(array)
storage(array)
structures(array)
trades(array)
transportation(array)
ui(array)
worldgen(array)
skin_packobject

Skin pack definition. Required when target_platform='bedrock_skinpack'.

Properties:
display_name(string)
pack_id(string)
skins(array)
output_modestring

Artifact mode: 'installable' (.mcaddon/.mcpack/.jar only), 'source' (zip only), or 'both'.

Values:
installablesourceboth
Default: both
build_jarboolean

Fabric/NeoForge only; build the jar offline when true.

Default: true
validate_outputboolean

Run platform validation (Bedrock Creator Tools) where available.

Default: true
include_file_previewboolean

Include capped previews for small generated text files in the response.

allow_experimental_bedrock_featuresboolean

Allow Bedrock features that require experimental world toggles.

render_preview_image25cr18 params

Render an enlarged PNG preview for an item/block/entity texture and upload it to File Manager. Three modes: (1) spec preview — pass target_platform, mod_id, mod_name, features; (2) archive preview — pass source_archive_file_id; (3) direct image preview — pass preview_source_file_id. Returns a preview artifact with PNG file_id, signed URL, and image metadata.

Render an enlarged PNG preview for an item/block/entity texture and upload it to File Manager. Three modes: (1) spec preview — pass target_platform, mod_id, mod_name, features; (2) archive preview — pass source_archive_file_id; (3) direct image preview — pass preview_source_file_id. Returns a preview artifact with PNG file_id, signed URL, and image metadata.

target_platformstring

Required for spec-mode preview. Optional when passing source_archive_file_id or preview_source_file_id.

Values:
bedrockbedrock_skinpackfabricneoforge
mod_idstring

Required for spec-mode preview; optional for archive-mode (defaults to the archive's mod_id).

mod_namestring

Required for spec-mode preview.

minecraft_versionstring

Pinned Minecraft version. Omit to use the platform default.

descriptionstring

Short mod description shown in the pack metadata.

compatibility_modestring
Values:
strictallow_platform_passthrough
Default: strict
mod_metadataobject

Optional ModMetadataSpec: version, license, authors, homepage_url, issue_tracker_url, credits, logo_texture, brand_color_hex (#RRGGBB), java_side, bedrock_experiments. See get_instructions for the full shape.

assetsobject

Optional AssetSetSpec containing pre-bound textures/sounds/particles/models/language entries: {textures: NamedAssetSpec[], sounds: NamedAssetSpec[], particles: NamedAssetSpec[], models: NamedAssetSpec[], language: {locale: {key: value}}}. See get_instructions for shape.

advanced_resourcesarray

Escape-hatch list of AdvancedResourceSpec entries for files the structured surface does not model (raw JSON blobs, custom sound definitions, etc.). Each entry has {path, content_base64|content_text|source_file_id, content_type}.

Array of: object
featuresobject

Structured feature set (items, blocks, entities, events, etc.). Required for create_mod_project on non-skinpack targets.

Properties:
animation_controllers(array)
animations(array)
biomes(array)
blocks(array)
commands(array)
damage_types(array)
dimensions(array)
effects(array)
enchantments(array)
entities(array)
events(array)
functions(array)
game_rules(array)
items(array)
localizations(array)
loot_tables(array)
machines(array)
particles(array)
recipes(array)
render_controllers(array)
scoreboards(array)
sounds(array)
storage(array)
structures(array)
trades(array)
transportation(array)
ui(array)
worldgen(array)
skin_packobject

Skin pack definition. Required for create_mod_project when target_platform='bedrock_skinpack'.

Properties:
display_name(string)
pack_id(string)
skins(array)
allow_experimental_bedrock_featuresboolean

Allow Bedrock features that require experimental world toggles.

source_archive_file_idstring

File Manager file_id for a previously generated source zip. Use to preview an asset from a built mod without re-supplying the spec.

preview_source_file_idstring

render_preview_image: File Manager file_id for a user-supplied image to preview directly.

preview_target_kindstring

render_preview_image: 'item', 'block', or 'entity'. Omit to auto-select.

Values:
itemblockentity
preview_target_idstring

render_preview_image: feature id or namespaced id to preview.

preview_sizeinteger

render_preview_image: square preview size in pixels (32-1024). Default 256.

Default: 256
Range: 32 - 1024
preview_backgroundstring

render_preview_image: background style for the preview canvas.

Values:
checkerboardtransparentwhiteblack
Default: checkerboard

About this Product

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

Can I use my own artwork for textures?

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?

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?

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?

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?

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).

Looking for help integrating AI into your business? Set up a free consultation.