Foodables

A comprehensive culinary expansion for Minecraft 1.21.5

Transform your Minecraft culinary adventures with over 125 new items, advanced food processing systems, and engaging farming mechanics. Foodables offers a comprehensive vanilla-plus approach to food, agriculture, and cooking that seamlessly integrates into your game world.

🍎 Key Features

Culinary System and Food

• 53 unique food items — from simple fruits to complex multi-ingredient dishes
• Balanced nutrition system — gradual 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-available drinks — juices and other beverages that can be consumed even when full

Farming and Agriculture

• 7 fruit trees — apple, banana, lemon, lime, mango, orange trees and pepper bushes with natural generation
• 5 new crops — tomatoes, lettuce, brown onion, red onion, and garlic with complete growth cycles
• 2 types of berry bushes — blueberries and blackberries that naturally appear in forest biomes
• Tree harvesting — trees drop fruits when leaves are broken over time

Advanced Processing Systems

• Drying rack network — 10 variants from different wood types (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 and pestle, knife, juicer, whisk, crusher) for advanced crafting

World Generation Integration

• Natural tree generation — fruit trees appear organically in suitable biomes
• Berry bush clusters — find berry patches throughout forest regions
• Salt ore deposits — underground salt mining for food preservation and seasoning
• Configurable generation — enable or disable any world generation features through in-game configuration

📦 Installation

Requirements

• Minecraft: 1.21.5
• Mod loader: Fabric Loader 0.16.14+
• Fabric API: Latest version for 1.21.5
• Java: 21 or higher
• Cloth Config: 18.0.0+ — required for configuration GUI

Step-by-Step Installation

1. Install Fabric Loader — download and run Fabric Installer
2. Download dependencies:
   • Fabric API (required)
   • Cloth Config (required for configuration menu)
3. Download Foodables — get the latest version
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

Important notes:

• Configuration changes require a world reload to take effect
• Only affects new 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 traveling 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 and 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 and Solutions

🚨 Game crashes on startup

• Verify Fabric API and Cloth Config are installed for MC 1.21.5
• Ensure all mods exactly match your Minecraft version
• 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 first exploring 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

📊 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 and Credits

Foodables is licensed under the MIT license.

Special thanks to:

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

Transform your culinary adventures today — download Foodables and discover what Minecraft cooking should be!