Foodables

 # Foodables **A comprehensive culinary expansion mod for Minecraft 1.21.5** [](https://minecraft.net) [](https://fabricmc.net) [](LICENSE.txt) [](https://www.curseforge.com/minecraft/mc-mods/foodables-fabric) 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](https://modrinth.com/mod/fabric-api)) - **Java**: 21 or higher - **Cloth Config**: 18.0.0+ ([Download](https://modrinth.com/mod/cloth-config)) - Required for configuration GUI ### Step-by-Step Installation 1. **Install Fabric Loader** - Download and run the [Fabric Installer](https://fabricmc.net/use/installer/) 2. **Download Dependencies**: - [Fabric API](https://modrinth.com/mod/fabric-api) (Required) - [Cloth Config](https://modrinth.com/mod/cloth-config) (Required for config menu) 3. **Download Foodables** - Get the latest version from [CurseForge](https://www.curseforge.com/minecraft/mc-mods/foodables-fabric) 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)](https://modrinth.com/mod/rei)** - Essential for viewing Foodables recipes and drying rack processes - **[AppleSkin](https://modrinth.com/mod/appleskin)** - Enhanced hunger and saturation display to understand food values - **[Mod Menu](https://modrinth.com/mod/modmenu)** - 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](https://github.com/CanINotUseTruth/Foodables/issues) - Use provided templates - 💬 **Community Support**: [Discord Server](https://discord.gg/K3nuDENu) - Get help from the community - 📖 **Detailed Guides**: [Foodables Wiki](https://github.com/CanINotUseTruth/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](https://www.twitch.tv/truthst) - See features being built in real-time - **YouTube**: [Update videos and tutorials](https://www.youtube.com/channel/UC5sAtcZ0gJC26Sq5MuF8v0w) - Stay updated with new releases - **Twitter**: [Development updates](https://twitter.com/TruthStreams) - 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](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!*