A comprehensive MCreator plugin that uses AI and web search to generate Minecraft mod elements through natural language prompts. Create professional mods with items, blocks, recipes, textures, sounds, and more using simple text descriptions.
- Natural Language Processing: Describe what you want in plain English
- Intelligent Analysis: AI understands context, themes, and mod requirements
- Balanced Content: Automatically ensures game balance and compatibility
- Items & Blocks: Generate weapons, tools, armor, decorative blocks, ores, and more
- Textures: AI-generated pixel art textures matching your theme
- Sounds: Custom sound effects and ambient audio
- Recipes: Balanced crafting, smelting, and other recipes
- Enchantments: Custom enchantments with unique effects
- Procedures: Complex game logic and behaviors
- Research Integration: Searches the web for Minecraft modding references
- Community Knowledge: Learns from existing mods and best practices
- Up-to-date Information: Always current with latest Minecraft versions
- Clean UI: Intuitive interface suitable for beginners and experts
- Progress Tracking: Real-time generation progress and feedback
- Batch Generation: Create multiple related elements at once
- Theme Consistency: Maintains visual and gameplay coherence
- Forge 1.20.1: Full support with future Forge compatibility
- MCreator Integration: Seamless workflow with existing projects
- Optimized Assets: Properly formatted textures and sounds
- Error Handling: Robust error recovery and user guidance
- MCreator 2023.4 or later
- Java 17 or later
- Internet connection for AI and web search features
- Download the latest release from the Releases page
- Extract the ZIP file
- Copy the plugin files to your MCreator plugins directory:
- Windows:
%USERPROFILE%/.mcreator/plugins/ - macOS:
~/.mcreator/plugins/ - Linux:
~/.mcreator/plugins/
- Windows:
- Restart MCreator
- Find "AI Mod Generator" in the Tools menu
git clone https://github.com/mcreator/ai-mod-generator-plugin.git
cd ai-mod-generator-plugin
./gradlew preparePlugin- Open MCreator and create or open a workspace
- Go to Tools → AI Mod Generator
- Enter a description like: "Create a magical sword that shoots fireballs"
- Configure generation options
- Click Generate and watch the magic happen!
"Create a set of emerald tools that are faster than diamond""Make a glowing mushroom block that provides light and grows in caves""Design a fire-themed armor set with flame resistance""Build a crafting table that can create infinite weapons"
- Theme Mode: Generate entire themed mod packs
- Batch Generation: Create multiple related items at once
- Custom Styles: Specify art styles and color schemes
- Balance Control: Adjust power levels and rarity
The plugin supports multiple AI providers. Configure in the settings panel:
{
"aiProvider": "openai",
"apiKey": "your-api-key-here",
"model": "gpt-4",
"temperature": 0.7,
"maxTokens": 2000
}- Balanced Stats: Ensures game balance
- Generate Textures: Creates custom pixel art
- Generate Sounds: Adds audio effects
- Generate Recipes: Creates crafting recipes
- Generate Lore: Adds item descriptions
- Web Search: Uses internet research
Prompt: "Create a mystical magic mod with crystal-based items"
Generated:
- Crystal Sword (with glowing texture)
- Crystal Pickaxe (faster mining)
- Crystal Block (light-emitting)
- Crystal Ore (rare spawn)
- Enchantment: Crystal Power
- Ambient crystal sounds
- Crafting recipes using crystals
Prompt: "Design industrial machinery and advanced tools"
Generated:
- Steel Ingots and tools
- Industrial Furnace block
- Conveyor Belt system
- Power Generator
- Mechanical sounds
- Complex crafting chains
AIModGeneratorCore: Main generation logicAIIntegrationService: AI provider interfaceTextureGenerator: Image generationSoundGenerator: Audio generationItemGenerator: Item creationBlockGenerator: Block creation
// Custom generator example
public class CustomGenerator extends BaseGenerator {
public String generateCustomElement(String prompt, GenerationOptions options) {
// Your custom logic here
}
}Plugin not appearing in menu
- Ensure MCreator version is 2023.4+
- Check plugin files are in correct directory
- Restart MCreator completely
AI generation fails
- Verify internet connection
- Check API key configuration
- Try simpler prompts first
Textures not generating
- Ensure sufficient disk space
- Check workspace permissions
- Verify image generation settings
Sounds not working
- Check audio codec support
- Verify sound file paths
- Test with simple sound effects
We welcome contributions! Please see our Contributing Guide for details.
git clone https://github.com/mcreator/ai-mod-generator-plugin.git
cd ai-mod-generator-plugin
./gradlew build./gradlew test- Follow Java conventions
- Use meaningful variable names
- Add Javadoc comments
- Include unit tests
- Fabric 1.20.1 support
- Custom model generation
- Advanced procedure templates
- Multi-language support
- Entity generation
- Dimension creation
- Biome generation
- Structure generation
- Visual scripting interface
- Collaborative features
- Mod marketplace integration
- Advanced AI models
This project is licensed under the MIT License - see the LICENSE file for details.
- MCreator team for the excellent modding platform
- OpenAI for AI capabilities
- Minecraft modding community for inspiration
- Beta testers and contributors
If you find this plugin helpful, consider:
- ⭐ Starring the repository
- 🐛 Reporting bugs and issues
- 💡 Suggesting new features
- 🤝 Contributing code or documentation
- 💬 Sharing with the community
Made with ❤️ for the Minecraft modding community
Transform your ideas into amazing Minecraft mods with the power of AI!