Foodables

A comprehensive culinary expansion mod for Minecraft 1.21.5

Transform your Minecraft culinary experience with 125+ new items, advanced food processing systems, and immersive farming mechanics. Foodables brings a comprehensive vanilla-plus approach to food, farming, and cooking that seamlessly integrates with your Minecraft world.

---

🍎 Features

Food & Culinary System

• 53 Unique Food Items - From simple fruits to complex multi-ingredient dishes
• Balanced Nutrition System - Tiered progression from basic foods (2-3 hunger) to premium meals (12+ hunger)
• Advanced Food Processing - Baking, drying, juicing, and multi-step crafting systems
• Smart Saturation Values - Complex recipes reward players with better saturation efficiency
• Always-Edible Drinks - Juices and beverages that can be consumed even when full

Farming & Agriculture

• 7 Fruit Trees - Apple, Banana, Lemon, Lime, Mango, Orange, and Peppercorn trees with natural generation
• 5 New Crops - Tomato, Lettuce, Brown Onion, Red Onion, and Garlic with full growth cycles
• 2 Berry Bushes - Blueberry and Blackberry bushes that generate naturally in forest biomes
• Tree Harvesting - Trees drop fruits when the leaves are breaking over time

Advanced Processing Systems

• Drying Rack Network - 10 wood variants (including new Pale Oak) for jerky production
• Food Preservation - Create jerky and dried foods with enhanced saturation and storage benefits
• Multi-Stage Cooking - Complex recipes requiring multiple ingredients and processing steps
• Tool Integration - 5 specialized tools (Mortar & Pestle, Knife, Juicer, Whisk, Crusher) for advanced crafting

World Generation Integration

• Natural Tree Generation - Fruit trees spawn organically in appropriate biomes
• Berry Bush Clusters - Discover berry patches throughout forest regions
• Salt Ore Deposits - Underground salt mining for food preservation and seasoning
• Configurable Generation - Toggle any world generation feature via in-game configuration

---

📦 Installation

Requirements

• Minecraft: 1.21.5
• Mod Loader: Fabric Loader 0.16.14+
• Fabric API: Latest version for 1.21.5 (Download)
• Java: 21 or higher
• Cloth Config: 18.0.0+ (Download) - Required for configuration GUI

Step-by-Step Installation

1. Install Fabric Loader - Download and run the Fabric Installer
2. Download Dependencies:
   • Fabric API (Required)
   • Cloth Config (Required for config menu)
3. Download Foodables - Get the latest version from CurseForge
4. Install Mods - Place all .jar files in your Minecraft mods folder
5. Launch Game - Start Minecraft using the Fabric profile

Recommended Companion Mods

• REI (Roughly Enough Items) - Essential for viewing Foodables recipes and drying rack processes
• AppleSkin - Enhanced hunger and saturation display to understand food values
• Mod Menu - Required for accessing Foodables configuration options

---

⚙️ Configuration

Access Foodables configuration through Mod Menu → Foodables Config

World Generation Options

Setting	Default	Description
Tree Generation	Enabled	Controls fruit tree spawning in new chunks
Berry Bush Generation	Enabled	Toggles natural berry bush patch generation
Ore Generation	Enabled	Controls salt ore deposit spawning underground

Important Notes:

• Configuration changes require a world reload to take effect
• Only affects newly generated chunks - existing areas remain unchanged
• Disable features to reduce world generation load or for custom modpack balance

---

🎮 Getting Started

Your First Foodables Experience

1. Explore and Gather - Find fruit trees and berry bushes by adventuring through your world
2. Basic Farming - Collect seeds by breaking short grass to start your own crops
3. Tool Crafting - Create a Knife and Mortar & Pestle for basic food processing
4. Drying Rack Setup - Build drying racks for jerky production
5. Advanced Cooking - Progress to complex multi-ingredient recipes for maximum nutrition

Food Progression Guide

• Early Game: Focus on raw fruits, vegetables, and basic cooked foods (2-4 hunger)
• Mid Game: Build processing infrastructure and create complex dishes (5-8 hunger)
• Late Game: Master multi-ingredient recipes and jerky production (9-12+ hunger)

---

🔧 Troubleshooting

Common Issues & Solutions

🚨 Game crashes on startup

• Verify Fabric API and Cloth Config are installed for MC 1.21.5
• Ensure all mods match your Minecraft version exactly
• Confirm Java 21+ is installed and selected in launcher
• Check launcher logs for specific error messages

🌳 Trees or ores not generating in my world

• Check configuration settings in Mod Menu → Foodables Config
• Remember: only NEW chunks will have Foodables generation
• Try exploring unexplored areas or create a new world for testing
• Verify world generation is enabled in configuration

📖 Recipes not showing in REI/recipe viewers

• Ensure REI version is compatible with Minecraft 1.21.5
• Restart Minecraft after installing recipe viewing mods
• Check that Foodables is loading properly (items appear in creative menu)
• Try refreshing REI with Ctrl+O in-game

🖼️ Missing textures or broken item models

• Verify mod file downloaded completely and isn't corrupted
• Check for conflicting resource packs that might override Foodables textures
• Try reinstalling the mod with a fresh download
• Ensure no other mods are conflicting with Foodables item registration

⚡ Performance issues or lag

• Consider disabling world generation features in heavily modded packs
• Reduce render distance when exploring for the first time with Foodables
• Check if other mods are conflicting with Foodables world generation

Getting Additional Help

• 🐛 Bug Reports: GitHub Issues - Use provided templates
• 💬 Community Support: Discord Server - Get help from the community
• 📖 Detailed Guides: Foodables Wiki - Comprehensive documentation
• 📧 Direct Contact: Check mod page for developer contact information

---

🎯 Mod Philosophy

Foodables follows a "Vanilla Plus" design philosophy:

• Seamless Integration - All features feel like natural extensions of Minecraft
• Balanced Progression - New content enhances rather than replaces vanilla systems
• Quality Over Quantity - Every item and feature serves a meaningful purpose
• Performance Conscious - Designed to work well in modpacks and multiplayer environments

---

🤝 Community & Support

Follow Development

• Twitch: Watch live development - See features being built in real-time
• YouTube: Update videos and tutorials - Stay updated with new releases
• Twitter: Development updates - Quick updates and sneak peeks

Contributing

• Bug Reports: Help improve the mod by reporting issues with detailed information
• Feature Suggestions: Share ideas that align with the vanilla-plus philosophy
• Translations: Help make Foodables accessible to more players worldwide

---

📊 Version Information

• Current Version: 1.21.5-1.0.0
• Minecraft Compatibility: 1.21.5
• Mod Loader: Fabric
• License: MIT
• Development Status: Active development with regular updates

Note: This mod is built exclusively for Fabric. There are currently no plans for Forge ports or backporting to earlier Minecraft versions.

---

📜 License & Credits

Foodables is licensed under the MIT License. See LICENSE.txt for full details.

Special Thanks:

• The Fabric community for excellent development tools and documentation
• All contributors, testers, and community members who help improve Foodables
• Minecraft modding community for inspiration and technical guidance

---

Transform your culinary adventures today - Download Foodables and discover what Minecraft cooking should be!