Healthy Diet

Healthy Diet Wiki

Give food a purpose beyond filling the hunger bar. Healthy Diet adds server-configurable nutrition groups, limits on repeatedly eating the same food, and temperature-aware shelf life. Players can see how a food affects their diet and how long it will keep; server owners can tailor vanilla and modded foods through in-game editors and datapack entries. Optional integrations connect refrigeration, seasons, ambient temperature and item information when the corresponding mods are present.

Compatibility: Choose a file from the Files tab that matches your Minecraft version and loader; use compatible builds on multiplayer clients and servers. Features described here are configurable and may vary by published file and server settings. Check the actual file before installing.

Why play with Healthy Diet?

Finding one efficient food should not be the end of a survival world's food choices. Healthy Diet lets a server create a real reason to cook, trade, preserve and vary your meals:

• Balance your diet. Foods contribute to one or more configurable nutrition groups. Group stages and multi-group conditions can grant attribute modifiers, potion effects or commands chosen by the server.
• Change your menu. Optional per-food short-term repetition limits and long-term aversion make reliance on a single item less rewarding. A server decides which foods use these rules and how strong they are.
• Think about storage. Foods configured with a shelf life track remaining time. Temperature, seasonal settings, refrigeration, dimension-specific rates and expiry results can all matter, depending on the server's setup.
• Understand what is happening. An in-game nutrition screen, rich item tooltips, a temperature diagnostic and a local HTML food viewer make complex rules inspectable instead of invisible.

This is a server-owned rules system, not a forced preset. A new setup includes six nutrition groups—Dairy, Fruits, Grains, Protein, Sugar and Vegetables—and bundled example food entries. Owners can edit or replace them, including assigning rules to items from other mods. The actual food values on a server are its own configuration, not universal numbers promised by this page.

For players: start in three commands

1. /headiet opens your nutrition screen. Watch how different foods affect your groups and how your current values relate to configured stages.
2. Hold a food and run /hdinfo. The server sends the matching item's configuration snapshot to a local browser viewer on your computer. /hdinfo minecraft:apple queries an item's default stack instead. The viewer can show nutritional values, effects and shelf-life data without changing server files.
3. /hdtemperature explains available ambient-temperature sources and their contributions when you need to diagnose food storage or integration behavior.

Run /hdhelp for the complete in-game command list and argument hints. These player queries do not require OP. Tooltips can show the configured nutrition and freshness information directly on items; the server owner decides which lines are always shown and which are revealed with Shift.

Nutrition, stages and bonuses

A food may feed several groups at once; the bundled apple entry, for example, contributes to Fruits and Sugar. Groups have configurable names, icons, colors, initial values and decay. The default Protein group's internal ID is healthy_diets_default_meat—IDs are not necessarily the names shown to players.

Owners can divide a group's range into named stages with descriptions and commands on entry. Separate rules can combine conditions across multiple groups to apply attributes or potion effects. These are configuration tools: a bonus is awarded only when its rule actually matches, not just because the mod is installed.

Variety without blanket penalties

• foodCooldown is an item-level short-term repetition setting with configurable use and recovery behavior.
• foodFatigue is a separate item-level long-term aversion setting based on a player's food-use history.

An item without these settings is not automatically subject to both. Servers can adjust or remove them, and administrators have commands to manage a player's recorded aversion.

Freshness and temperature

Configured foods can have individual lifetimes, food temperatures, changes over time, dimension multipliers, cold retention, temperature curves and custom temperature-zone effects. The expiry result comes from each food's configuration rather than a single hard-coded spoiled item. Some supported placed foods also have placed-block timing and eating behavior.

Ambient temperature may draw on Healthy Diet's own calculation and, if installed and enabled, Legendary Survival Overhaul or Ecliptic Seasons. With the relevant furniture integration, refrigerators and freezers can affect storage conditions. A fridge only helps when the integration, server settings and device state actually make it functional; players can inspect available diagnostic information instead of guessing. Jade can show shelf-life information for supported dropped foods.

Optional integration notes

• Legendary Survival Overhaul: Additional ambient/player-temperature information where available.
• Ecliptic Seasons: Seasonal and climate inputs for relevant temperature and preservation settings.
• Refurbished Furniture: Fridge/freezer storage integration. The NeoForge line also checks for its framework when reporting readiness.
• Jade: Shelf-life information on supported dropped items.

These are optional integrations for their respective features, not mandatory dependencies for basic nutrition play. Availability and versions of other mods must be checked separately for the Minecraft version you use.

For server owners: visual editing and datapacks

Hold an item and use /hdui (OP4) to open its config hub. It separates general item settings from matching item variants, then provides access to nutrition, hunger overrides, effects, conditional rules, eating commands, repetition limits, shelf life, quality, rarity and tooltip presentation. /hdui create manages nutrition groups, quality levels and rarities; /hdui stage manages stages and combined bonuses. /hdui tooltip opens the tooltip editing flow, including variant selection when appropriate.

Healthy Diet also supports datapack-backed content, including namespace-separated item, nutrition group, stage, bonus and block right-click definitions. Block rules use datapack JSON; the old /hdblock command is gone. Do not interpret the presence of block JSON as an existing visual block editor. /hdreload reloads this mod's configuration and pushes applicable changes to online players without a full vanilla datapack reload. Startup-registered quality items and some locally read display settings have different restart/refresh requirements.

Current configuration is rooted in config/healthy_diet/. Important parts include server.json (gameplay, privacy and shelf-merge settings), display.json (local presentation), colors/, shelf_life/, fatigue/, temperature/ and datapack/. Older instructions referring to shelf_env/, rarity_and_colors/ or separate legacy server settings files do not describe the shared current layout. Always back up existing worlds and configs before a version change.

Display and TitlePro

Quality and rarity definitions can use colors, gradients and segmented text, while the visual tooltip editor controls the information shown on an item. TitlePro, included in the same mod, is a separate screen-text system for titles, tables and color overlays. It can be triggered by item events or administrator commands and is not required for the basic nutrition loop.

Compatibility and documentation

Use the Files tab to select a published file for your Minecraft version and loader. Multiplayer servers and clients should use compatible builds; optional integrations depend on compatible third-party mods. This mod is licensed All Rights Reserved.

Detailed player and server guides are available in the GitHub Wiki in English and Simplified Chinese.