{"id":49697193,"url":"https://github.com/kgbcupcake/nourished","last_synced_at":"2026-06-03T03:00:34.777Z","repository":{"id":356426233,"uuid":"1226029434","full_name":"kgbcupcake/nourished","owner":"kgbcupcake","description":"🌿 Nourished — a lightweight nutrition system for NeoForge 1.21.1. What's in this release:  Six food group tracking system (Fruits, Vegetables, Proteins, Grains, Sugars, Dairy) Dynamic nutrition-based buff and debuff system Diminishing returns on repeated foods via memory system Full Diet Screen with cal","archived":false,"fork":false,"pushed_at":"2026-05-30T20:42:17.000Z","size":493452,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-30T21:11:21.079Z","etag":null,"topics":["cloth-config","datapack","food","hud","java","minecraft","minecraft-1-21-1","minecraft-mod","modding","neoforge","neoforge-mod","nutrition","survival"],"latest_commit_sha":null,"homepage":"https://modrinth.com/mod/nourished/versions","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kgbcupcake.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-30T22:40:55.000Z","updated_at":"2026-05-30T19:19:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kgbcupcake/nourished","commit_stats":null,"previous_names":["kgbcupcake/nourished"],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/kgbcupcake/nourished","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kgbcupcake%2Fnourished","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kgbcupcake%2Fnourished/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kgbcupcake%2Fnourished/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kgbcupcake%2Fnourished/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kgbcupcake","download_url":"https://codeload.github.com/kgbcupcake/nourished/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kgbcupcake%2Fnourished/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33845770,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-03T02:00:06.370Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloth-config","datapack","food","hud","java","minecraft","minecraft-1-21-1","minecraft-mod","modding","neoforge","neoforge-mod","nutrition","survival"],"created_at":"2026-05-08T02:21:22.441Z","updated_at":"2026-06-03T03:00:34.771Z","avatar_url":"https://github.com/kgbcupcake.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Main Menu](Assets/nourished_banner.png)\n\nI got sick of Minecraft's food system. There are other nutrition mods out there, but none of them did what I wanted or were updated for modern Minecraft, so I decided to build my own.\n\n---\n\n❤️ What you gain\nWhen you have all five food groups are above 75%, you get:\n\nHealth Boost I — passively while balanced\nRegeneration I — passively while balanced\n\nWhen all five food groups are above 75%, you get:\n\n| Group | Neglect Penalty | Balance Buff |\n|---|---|---|\n| 🌾 Grains | Weakness I | ✓ |\n| 🥦 Vegetables | Slowness I | ✓ |\n| 🥩 Proteins | Mining Fatigue I | ✓ |\n| 🍎 Fruits | Unluck I | ✓ |\n| 🍬 Sugars | — | — |\n| 🥛 Dairy | — | ✓ |\n\n---\n\nSugars and Dairy have no penalty effect by default — these groups are tracked and affect your balance score but do not apply a debuff when depleted. Dairy still counts toward the balance buff. This is configurable.\n\n\n## 🍽️ Eating at full hunger\n\nVanilla hunger normally blocks eating at full hunger; Nourished still counts nutrition when your bar is full. Light foods — berries, fruits, and snacks — can be eaten for nutrients without restoring hunger. Heavy meals follow vanilla rules by default.\n\nBoth behaviors are configurable: `blockHeavyMeals` and `blockLightFood` toggles give server admins full control.\n\nAll effects are fully configurable and can be disabled per-module.\n\nDiminishing returns apply - eating the same food repeatedly gives less credit each time, encouraging real variety.\n\n\n---\n\n## The HUD\n\nThe HUD is the heart of the mod. Five color-coded bars sit on screen while you play - you always know where you stand without opening a menu.\n\n![HUD Edit Mode](Assets/nourished-MiniHud.gif)\n\nNote: The HUD and Diet Screen screenshots were taken using the PureBDCraft resource pack. The UI is fully functional on vanilla textures but will appear in the default Minecraft style without a resource pack installed.\n\n**Drag it anywhere.** Press the keybind to enter edit mode and reposition the HUD exactly where you want it. Scale it, anchor it to any corner, or hide bars that are at zero.\n\n---\n\n## The Diet Screen\n\nOpen it from your inventory for a full breakdown - trend arrows, balance score, active effects, calorie tracking, and a reset timer.\n\n![Diet Screen](Assets/nourished-MainMenu.gif)\n\nNote: The HUD and Diet Screen screenshots were taken using the PureBDCraft resource pack. The UI is fully functional on vanilla textures but will appear in the default Minecraft style without a resource pack installed.\n\n---\n\n## Modularity\n\nEvery feature in Nourished is a module toggle. Turn off decay, effects, the HUD, toasts, calorie tracking, or the diet screen independently. Modpack authors can lock modules server-side.\n\n## 🔧 Configurable to your server\n\nEverything ships with sensible defaults. Everything can be changed:\n\n- Toggle individual modules on or off\n- Adjust decay rates and thresholds per nutrient\n- Add, remove, or replace effects via `effects.json`\n- Override anything through datapacks — no file editing needed\n- Control eating behavior with `blockHeavyMeals` and `blockLightFood` toggles\n- Save and share full config snapshots with a single share code\n\n---\n\n## 🤝 Broad Mod Compatibility\n\nIf a mod adds food with `FoodProperties`, Nourished handles it automatically. No data files to write, no configs to edit.\n\n| Mod                         | Status                                   |\n| --------------------------- | ---------------------------------------- |\n| Farmer's Delight            | ✅ Full                                  |\n| Pam's HarvestCraft 2        | ✅ Full                                  |\n| Create: Food                | ✅ Full                                  |\n| Croptopia                   | ✅ Full                                  |\n| Farmer's Croptopia          | ✅ Full                                  |\n| Croptopia Delight           | ✅ Full                                  |\n| Farm \u0026 Charm                | ✅ Full                                  |\n| Ender's Delight             | ✅ Full                                  |\n| L_Ender's Delight           | ✅ Full                                  |\n| Ars Delight                 | ✅ Full                                  |\n| Autochef's Delight          | ✅ Full                                  |\n| Spice of Life: Onion        | ✅ Full                                  |\n| KubeJS                      | ✅ Full scripting support                |\n| Peak Stamina                | ✅ Nutrition affects stamina             |\n| JEI / REI / EMI             | ✅ Tooltips in recipe viewers            |\n| Legendary Survival Overhaul | ⚠️ Effects disabled (LSO takes priority) |\n| Any mod with FoodProperties | ✅ Auto-classified                       |\n\n---\n\n## 🌐 For mod developers\n\nNourished ships a stable public API if you want to integrate with it:\n\n```java\nfloat level = NourishedAPI.getNutrientLevel(player, \"proteins\");\nNourishedAPI.registerNutrient(definition);\nNourishedAPI.registerFoodClassification(foodId, \"proteins\", 0.15f);\n```\n\nAPI elements are marked `@Stable`, `@Experimental`, or `@Internal` so you know exactly what you can rely on.\n\nRead [`API.md`](API.md) for the full public API and [`PHILOSOPHY.md`](PHILOSOPHY.md) for compatibility and stability guarantees. Addons can register custom nutrients, food classifications, and diet events through Java or KubeJS, and can also ship datapack-only integrations without writing Java code. See the example addon project for a minimal end-to-end integration pattern.\n\n---\n\n## 📦 Datapack Support\n\nEverything in Nourished can be driven by datapacks with zero Java code:\n\nNutrients — define custom food groups\nFood classification — assign items to nutrient bars via item tags under data/nourished/tags/item/nutrients/\nEffects — add or replace buff/debuff rules via effects.json\nFood overrides — override specific item nutrition values via food_overrides.json\nFood values — adjust category multipliers via food_values.json\nColors — customize HUD bar colors via colors.json\nThe built-in Food Scanner tool auto-classifies unknown foods and can write a ready-to-use datapack directly into your save with one click.see [`API.md`](API.md).\n\n---\n\n## 🟨 KubeJS Support\n\nFull KubeJS scripting support for custom nutrient events, food classifications, and diet hooks — no Java required.\n\n```js\nNourishedEvents.onNutrientChanged(event =\u003e {\n    if (event.nutrient === 'proteins' \u0026\u0026 event.level \u003c 0.25) {\n        event.player.tell('Eat some protein!')\n    }\n})\n```\n\n---\n\n## 🚧 Current Focus\n\n- Balancing nutrient decay\n- Expanding datapack support\n- Improving multiplayer syncing\n- Additional compat integrations\n- More HUD customization\n\n---\n\n## Requirements\n\n- Minecraft **1.21.1**\n- NeoForge **21.1.x**\n- Java **21**\n\n---\n\n## License\n\nMIT\n\n## Links\n\n- [Modrinth](https://modrinth.com/mod/nourished)\n- [Contributing](docs/CONTRIBUTING.md)\n- [API.md](API.md)\n- [PHILOSOPHY.md](PHILOSOPHY.md)\n- [ARCHITECTURE.md](ARCHITECTURE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkgbcupcake%2Fnourished","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkgbcupcake%2Fnourished","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkgbcupcake%2Fnourished/lists"}