Documentation
AgentMC Documentation
Learn how to convert Java resource packs to Bedrock format and get them running on your devices.
Get started with AgentMC
You can convert many different types of Java resource pack content with AgentMC, including custom items with your favorite ItemsAdder or Oraxen packs, to custom armor and 3D models.
The converter automatically handles textures, sounds, item models, armor attachables, and generates proper sprites.json for Bedrock compatibility.
See the quick start guide for step-by-step instructions, or the features section for a complete list of supported conversions.
Quick references
Quick Start
Create an account
Sign up for free to access the converter and track your conversion history.
Go to Dashboard → Convert
Navigate to the convert page from your dashboard sidebar.
Upload your .zip file
Drag and drop your Java resource pack or click to browse.
Configure and convert
Set your pack name, toggle conversion options, and click Convert.
Download your .mcaddon
Once complete, download your Bedrock-compatible pack.
Features
3D to 2D Icon Conversion
Automatically generates flat 2D icons from 3D item models for Bedrock inventory display.
Armor Attachables
Converts Java armor textures to Bedrock attachable format for proper player rendering.
Sprites Generation
Creates sprites.json for item atlas textures with proper UV mapping.
Sound Definitions
Converts sound definitions and OGG files for Bedrock's audio system.
GeyserMC Compatible
Output packs work seamlessly with GeyserMC for cross-platform play.
Upload a Pack
To upload a pack, navigate to Dashboard → Convert. You can either drag and drop your .zip file onto the upload area, or click to browse your files.
Note: Make sure your resource pack is a valid Java Edition pack in .zip format. The converter expects a standard pack structure with an assets folder.
Conversion Options
| Option | Description |
|---|---|
| Pack Name | Custom name for your output pack |
| Convert Items | Include custom items and generate icons |
| Convert Sounds | Convert sound files and definitions |
| Convert Models | Include 3D models (enables icon generation) |
Download Output
`` After conversion completes, you'll see a download button for your .mcaddon file. You can also find all your conversions in Dashboard → History.
The .mcpack format is a Minecraft-specific archive that will automatically open in Minecraft when double-clicked on supported platforms.
Installing on Mobile (iOS/Android)
- Download the .mcpack file to your device
- Tap the file to open it
- Select "Open with Minecraft" when prompted
- Minecraft will open and import the pack automatically
- Go to Settings → Storage → Resource Packs to activate
Installing on Windows 10/11
- Download the .mcpack file
- Double-click the file to open it
- Windows will automatically open Minecraft and import the pack
- Wait for the import confirmation message
- Find the pack in your global resources or per-world settings
GeyserMC Server Setup
To use your converted pack on a GeyserMC server:
- Rename the .mcpack file to .zip
- Extract the contents
- Place the resource pack folder in your Geyser packs directory
- Configure Geyser to use the pack in config.yml
- Restart your server
Bedrock players will automatically receive the pack when joining your server.
Console Installation
Xbox, PlayStation, and Nintendo Switch don't support direct file imports. You have two options:
- Upload the pack to a Realm you control and join from console
- Import via a Windows/Mobile device and use cloud saves
Frequently Asked Questions
What file formats are supported?
We accept Java resource packs in .zip format. The converter outputs .mcaddon files for Bedrock Edition.
Is there a file size limit?
Free users can upload packs up to 50MB. Pro users have higher limits for larger resource packs.
Why are some items showing as pink/magenta?
Pink squares indicate missing textures. Ensure your original Java pack has all required textures and try re-converting.
How long does conversion take?
Most conversions complete in under a minute. Larger packs with many 3D models may take longer.
Troubleshooting
Having issues? Check these common problems:
- Pack won't import: Ensure you're using Minecraft Bedrock Edition, not Java
- Missing textures: Re-convert with all options enabled
- Sounds not playing: Check that sounds were enabled during conversion
- Pack not showing: Make sure the pack is activated in your world settings
Still need help? Contact our support team.