promotional bannermobile promotional banner
premium banner
This mod was written by AI **Eat The World** is a mod focused on improving Minecraft's food system, making your dining experience richer and more fun!

Description

# Eat The World - Food Diversity & Bento Box System

**This mod was written by AI**

## ๐ŸŽ What is this mod?

**Eat The World** is a mod focused on improving Minecraft's food system, making your dining experience richer and more fun!

### ๐ŸŽฏ Core Philosophy
- **Encourage Food Diversity**: No more mindlessly eating a single food type - try various cuisines!
- **Portable Meal Management**: Bento boxes let you enjoy meals anytime, anywhere
- **Progressive Challenge**: Food effects diminish with repeated consumption but can recover

---

## ๐Ÿฅ˜ Main Features

### 1. Food Effect Diminishing System โญ Core Feature

**Simply put:** Eating the same food repeatedly reduces its effectiveness. Foods get a marker system - each time you eat a food, its marker level increases by 1, but it recovers after some time (configurable).

**Specific Effects:**
- ๐Ÿฅ– **Marker Level 1**: 100% effect (normal hunger and saturation)
- ๐Ÿฅ– **Marker Level 2**: 80% effect (slightly reduced)
- ๐Ÿฅ– **Marker Level 3**: 60% effect (noticeably reduced)
- ๐Ÿฅ– **Marker Level 4**: 40% effect (significantly reduced)
- ๐Ÿฅ– **Marker Level 5+**: 20% effect (minimum effect)

**Recovery Mechanism:**
- โฐ Every 10 minutes (12000 game ticks), all foods' marker levels decrease by 1
- ๐Ÿ”„ After not eating a certain food for a while, its effect fully recovers
- ๐Ÿ’พ **Data Persistence**: Food marker data is automatically saved and persists after restarting

**Eating Speed:**
- ๐ŸŒ High marker level foods also eat slower (reflecting "don't want to eat" feeling)

### 2. Smart Bento Box System ๐Ÿฑ

**What is a Bento Box?**
- A portable container that can store 27 different types of food
- Right-click to eat directly without opening your inventory
- Intelligently selects optimal food or rotates in order
- **Perfect compatibility with other mods**: Eating from the bento box triggers Diet, SolCarrot, and other mod effects

**Crafting Recipe:**
```
Iron Ingot  Iron Ingot  Iron Ingot
Paper       Paper       Paper
Iron Ingot  Iron Ingot  Iron Ingot
```

**Usage:**
- ๐Ÿฝ๏ธ **Normal Right-click**: Eat directly from the bento box
- ๐Ÿ“ฆ **Sneak + Right-click**: Open bento box interface to add/remove food

**Full Feature Support:**
- โœ… **Potion Effects**: Enchanted golden apples, pufferfish, and other buff foods fully supported
- โœ… **Container Return**: Mushroom stew returns bowl, milk bucket returns bucket, etc. (disabled by default, enable in config)
- โœ… **Mod Compatibility**: Supports special effects and container returns for most mod foods

**Two Eating Modes:**

#### ๐Ÿง  Smart Mode (Default, Recommended)
- Prioritizes foods you haven't eaten yet
- If all eaten, selects the one with lowest "tiredness"
- If tiredness is equal, selects the one with highest hunger value
- **Best for**: Players who want optimized dietary effects

#### ๐Ÿ”„ Sequential Mode
- Eats foods in slot order (1โ†’2โ†’3โ†’...โ†’27โ†’1)
- Blue highlight shows the next food to eat
- **Best for**: Players who prefer regular eating patterns

### 3. Natural Regeneration System โค๏ธ

**Enabled by default**, provides a more balanced healing mechanism:

**Healing Conditions:**
- ๐Ÿ– Hunger level reaches 18 (max 20)
- ๐Ÿ’ง Saturation greater than 0
- โฐ Heals 1 health point (half heart) every 2 seconds (40 game ticks)
- ๐Ÿ’จ Each heal costs 10 exhaustion (higher than vanilla)

**Why this design?**
- Encourages maintaining high hunger and saturation
- Healing speed is moderate, not too fast or slow
- Works with food diminishing system to encourage diverse diet

### 4. Action Exhaustion System ๐Ÿƒ

**Enabled by default**, makes various actions consume more hunger:

- ๐Ÿƒ **Sprinting**: 1.0 exhaustion per second
- ๐Ÿฆ˜ **Jumping**: 1.0 exhaustion per jump
- โš”๏ธ **Attacking**: 1.0 exhaustion per attack
- ๐Ÿ’” **Taking Damage**: Damage ร— 0.5 exhaustion (max 5.0 per hit)

**Why this design?**
- Makes combat and exploration more challenging
- Encourages carrying sufficient food
- Works with bento box system to make portable food management valuable

### 5. Reset Command ๐Ÿ”ง

If you encounter abnormal food marker data, use the reset command:

**Command:** `/eattheworld reset`

**Functions:**
- Clear all food marker data
- Reset consumption counts
- Clear last consumption times
- Immediately sync to client

**Use Cases:**
- When food markers display abnormally
- When you want to restart the food diversity challenge
- When data becomes incompatible after mod updates

---

## ๐ŸŽฎ Quick Start Guide

### Step 1: Install the mod
1. Ensure you have **Minecraft 1.20.1** + **Forge**
2. Place `eattheworld-1.0.0.jar` in `.minecraft/mods/` folder
3. Launch the game

### Step 2: Craft a Bento Box
1. Gather materials: 6 iron ingots + 3 paper
2. Craft according to the recipe
3. Sneak + right-click to open, add various foods

### Step 3: Start Experiencing
1. Normal right-click to eat from the bento box
2. Observe food effect changes (food diminishing enabled by default)
3. Try diverse diet for best effects
4. Food "tiredness" automatically recovers every 10 min (12000 game ticks)

---

## ๐Ÿค” FAQ

### Q: Will this mod make the game very difficult?
A: No! The food diminishing system encourages diverse diet but won't starve you. Even at 20% effect, food is still useful. Recovery is fast (1 level per 10 min), and the bento box makes carrying multiple foods convenient.

### Q: What if food markers always show "recovering soon"?
A: This issue is fixed in the latest version. Countdown now displays accurately and markers recover immediately when complete. If you still encounter issues, use `/eattheworld reset` to reset all food marker data.

### Q: Can I have just the bento box without food diminishing?
A: Of course! Set `food.decrement.enabled` to `false` in the config file to disable food diminishing and use only the bento box.

### Q: Can I adjust the difficulty?
A: Yes! You can adjust diminishing rates, recovery times, and other parameters in the config file.

### Q: Does it support multiplayer?
A: Fully supported! Both server and client need to have this mod installed.

### Q: Is it compatible with other mods?
A: Compatible with most mods, especially optimized for:
- **AppleSkin**: Food values display perfectly synced
- **Diet**: Nutrition system perfectly compatible (eating from bento box correctly adds nutrition)
- **Spice of Life: Carrot Edition**: Food diversity system perfectly compatible

---

## ๐ŸŽฏ Gameplay Experience Changes

### ๐Ÿ”ฅ Before Installing This Mod:
- Find one efficient food (like steak, golden carrot)
- Mass produce this food
- Eat the same food until game end
- Other foods basically unused

### โœจ After Installing This Mod:
- ๐ŸŒพ **Early Game**: Eat everything, bread, apples, raw meat all useful
- ๐Ÿฅฉ **Mid Game**: Start planning food combinations, build diverse farms
- ๐Ÿฑ **Late Game**: Use bento box to manage multiple foods, enjoy culinary journey
- ๐Ÿ† **Achievement**: Upgrade from "filling stomach" to "gourmet"

### ๐ŸŽจ Strategic Depth:
- **Agricultural Planning**: No longer just wheat farming, all crops have value
- **Food Storage**: Consider food diversity rather than quantity
- **Exploration Motivation**: Finding new food sources becomes meaningful
- **Trading Value**: Different foods have unique value in trading

---

## ๐Ÿ† Who Should Use This Mod?

### โœ… Recommended For:
- Players who enjoy agriculture and food systems
- Those wanting more challenging but not overly difficult experience
- Strategy-minded players
- Players wanting more depth in Minecraft
- Multiplayer servers (increases cooperation and trading fun)

### โŒ May Not Suit:
- Players wanting simple casual gameplay (but can disable food diminishing)
- Those disliking complex system management
- Players used to "one food type" approach

---

## ๐Ÿ“‹ Version Information

- **Minecraft Version**: 1.20.x series (1.20.0 - 1.20.5)
- **Mod Loader**: Forge
- **Mod Version**: 1.0.0
- **Dependencies**: None (but AppleSkin recommended for better display)

## ๐ŸŒ Supported Languages

This mod supports 15 languages:

- ๐Ÿ‡บ๐Ÿ‡ธ English (US)
- ๐Ÿ‡จ๐Ÿ‡ณ Chinese Simplified
- ๐Ÿ‡น๐Ÿ‡ผ Chinese Traditional
- ๐Ÿ‡ฏ๐Ÿ‡ต Japanese
- ๐Ÿ‡ฐ๐Ÿ‡ท Korean
- ๐Ÿ‡ซ๐Ÿ‡ท French
- ๐Ÿ‡ฉ๐Ÿ‡ช German
- ๐Ÿ‡ช๐Ÿ‡ธ Spanish
- ๐Ÿ‡ฎ๐Ÿ‡น Italian
- ๐Ÿ‡ง๐Ÿ‡ท Portuguese (Brazil)
- ๐Ÿ‡ท๐Ÿ‡บ Russian
- ๐Ÿ‡ต๐Ÿ‡ฑ Polish
- ๐Ÿ‡ณ๐Ÿ‡ฑ Dutch
- ๐Ÿ‡ธ๐Ÿ‡ช Swedish
- ๐Ÿ‡น๐Ÿ‡ท Turkish

---

## ๐ŸŽ‰ Summary

**Eat The World** isn't a mod that makes the game harder, but one that makes the food system more fun and deeper. It encourages you to:

- ๐ŸŒ **Explore the world** to find various foods
- ๐ŸŒฑ **Develop agriculture** to grow diverse crops
- ๐Ÿฑ **Plan strategically** for food combinations
- ๐Ÿ‘ฅ **Socialize** and trade foods with other players

If you're tired of the monotonous "mindlessly eating steak" experience and want to make Minecraft's food system richer and more interesting, this mod is for you!

**Start your culinary journey now!** ๐Ÿš€

---

*Need help? Check the config file for detailed configuration options.*