A robust Minecraft plugin that introduces Gluten Free Bread variants, providing players with healthy alternatives to traditional wheat-based bread. Each variant offers unique crafting recipes and enchanting effects when consumed.

• Features
• Bread Variants
• Installation
  • Requirements
  • Quick Install
  • Build from Source
• Usage
  • Crafting Recipes
    • Plain Gluten Free Bread
    • Sweet Gluten Free Bread
    • Spicy Gluten Free Bread
    • Savory Gluten Free Bread
  • Commands
  • Examples
• Configuration
• Contributing
  • Developer Quick Start
• Permissions
• Overconsumption Protection
• Resource Pack Support
• Technical Details
  • Architecture
  • Compatibility
  • Performance
• API Usage
• Troubleshooting
  • Possible Issues
  • Debug Mode
• 🎓 Learn AI Powered Plugin Development
  • What You'll Learn
  • Course Topics
  • Booking Information
    • 1-on-1 Coaching Sessions Available
    • What's Included
  • Get Started
• License

• Four Bread Variants: Plain, Sweet, Spicy, and Savory gluten-free bread
• Custom Recipes: Each variant requires unique ingredients
• Beneficial Effects: Different potion effects based on bread type
• Overconsumption Protection: Prevents abuse with negative effects
• Comprehensive Commands: Admin tools for management
• Configuration Support: Customizable effects and settings
• Performance Optimized: Event-driven architecture with caching

All breads feature:

• Glowing appearance (harmless enchantment effect)
• Custom lore describing their benefits
• Unique colors for easy identification

• Java: 21 or higher
• Server: Paper 1.21.6+, Spigot 1.21+, or Bukkit 1.21+
• Maven: For building from source

1. Download the latest JAR from releases
2. Place in your server's plugins/ directory
3. Restart your server
4. Configure in plugins/GlutenFreeBread/config.yml if needed

# Clone the repository
git clone https://github.com/carmelosantana/minecraft-gluten-free-bread
cd gluten-free-bread

# Build the plugin
make build

# Install to test server
make install

B B B
E E E
B B B

Where: B = Beetroot, E = Egg

B B B
E H E
B B B

Where: B = Beetroot, E = Egg, H = Honey Bottle

B B B
E P E
B B B

Where: B = Beetroot, E = Egg, P = Blaze Powder

B B B
E M E
B B B

Where: B = Beetroot, E = Egg, M = Brown Mushroom

All commands require glutenfreebread.admin permission:

• /gfbread help - Show command help
• /gfbread give <type> [amount] - Give yourself bread
• /gfbread give <type> <player> <amount> - Give bread to another player
• /gfbread list - List all available bread types
• /gfbread clear [player] - Clear active effects
• /gfbread reload - Reload configuration
• /gfbread version - Show plugin information

Available types: plain, sweet, spicy, savory

/gfbread give sweet 5           # Give yourself 5 sweet breads
/gfbread give spicy Player 10   # Give Player 10 spicy breads
/gfbread clear                  # Clear your effects
/gfbread list                   # Show all bread types

Edit plugins/GlutenFreeBread/config.yml:

consumption:
  threshold: 5 # Minimum hunger level for effects

recipe:
  enabled: true # Enable custom recipes

logging:
  debug: false # Debug logging

breads:
  plain:
    effects:
      regeneration:
        duration: 10 # seconds
        amplifier: 0 # level - 1
  sweet:
    effects:
      regeneration:
        duration: 10
        amplifier: 1
      speed:
        duration: 15
        amplifier: 0
  # ... (other bread types)

Please review Contributing Guidelines for developer documentation. Including;

• Development environment setup
• Code standards and testing procedures
• Pull request process
• Server management and Docker support
• Troubleshooting

# Set up development environment
make setup

# Quick development cycle
make dev

# Run tests
make test

# Test in Docker
make docker-test

• glutenfreebread.craft - Allow crafting (default: true)
• glutenfreebread.consume - Allow consuming (default: true)
• glutenfreebread.admin - Admin commands (default: op)

The plugin tracks consumption to prevent abuse:

• Limit: 5 breads per 5 minutes
• Effects: Nausea and Slowness when exceeded
• Reset: Automatically clears after time window

The plugin includes custom model data for resource pack compatibility:

• Plain: 1000
• Sweet: 1001
• Spicy: 1002
• Savory: 1003

• Event driven: Minimal performance impact
• Cached items: Prebuilt ItemStacks for efficiency
• Persistent data: Reliable item identification
• Adventure API: Modern text components

• Paper: 1.21.6+ (recommended)
• Java: 21+
• Geyser/Floodgate: Compatible

• Cached ItemStack instances
• Efficient consumption tracking
• Minimal event processing overhead
• Cleanup on player disconnect

For developers wanting to integrate:

// Check if item is gluten-free bread
if (GlutenFreeBreadItem.isAnyGlutenFreeBread(itemStack)) {
    String type = GlutenFreeBreadItem.getBreadType(itemStack);
    // Handle bread consumption
}

// Get plugin instance
GlutenFreeBreadPlugin plugin = (GlutenFreeBreadPlugin) Bukkit.getPluginManager().getPlugin("GlutenFreeBread");
Map<String, GlutenFreeBreadItem> breads = plugin.getBreadItems();

Plugin not loading:

• Check Java version (requires 21+)
• Verify Paper/Spigot version (1.21+)
• Check server logs for errors

Recipes not working:

• Ensure recipe.enabled: true in config
• Restart server after config changes
• Check if other plugins conflict

Commands not working:

• Verify permissions
• Check command syntax
• Ensure plugin is enabled

Enable debug logging in config.yml:

logging:
  debug: true

Want to build your own Minecraft plugins? I built our plugin collection using generative AI, and I can teach you how to do the same!

• AI Assisted Coding: How to effectively use AI tools like GitHub Copilot, ChatGPT, and Claude for plugin development
• Plugin Architecture: Best practices for structuring robust, maintainable Minecraft plugins
• Modern Development: Paper API, Maven build systems, Docker testing, and CI/CD workflows
• Problem Solving: How to break down complex features into manageable tasks
• Code Quality: Testing, debugging, and optimizing AI generated code

• Getting Started: Setting up your AI development environment
• Plugin Fundamentals: Events, commands, configuration, and permissions
• Advanced Features: Custom items, recipes, data persistence, and performance optimization
• Testing & Deployment: Docker containers, server management, and release workflows
• Real Projects: Build actual plugins from concept to completion

• Duration: 1-2 hour sessions
• Format: Screen share coding sessions via video call
• Family Friendly: Parents are welcome and encouraged to join sessions, especially for younger students and curious parents wanting to learn alongside their children.

• ✅ Live coding demonstration
• ✅ AI prompt engineering techniques
• ✅ Complete project setup and tooling
• ✅ Plugin publishing and distribution
• ✅ Follow up support and code review

Ready to accelerate your development with AI?

• Schedule your call - Book a session today!
• Discord - Ask questions, see examples.
• Public SMP Server - Join us at play.xp.farm and test our plugins live!

Turn your plugin ideas into reality in hours, not weeks!

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License.