Gentle Metabolism 2.2.0-beta.2 — Minecraft 1.20.1 / NeoForge

This file is only for Minecraft Java 1.20.1, NeoForge 47.1.106, and Java 17. These are the tested baselines, not a promise that every newer loader version works. No Fabric API or other external mod dependency is required. NeoForge 47.1.106 uses Forge-named internal metadata; regular Minecraft Forge was not tested. Install the matching build on both the server and every client; do not mix Fabric and NeoForge editions or Minecraft versions.

New in all four beta.2 builds

• Rebuilt ceramic toilet with a hollow bowl, layered interior, shaped base, separate tank lid and rear-hinged seat lid. Directional collision and selection shapes follow the model. Existing IDs, stored contents and grime are preserved; the visual update does not clean or empty old toilets.
• Raw-water and purified-water bottles use the vanilla glass-bottle shape, with pale green and pale blue liquid respectively. Water safety, drinking and empty-bottle return rules are unchanged.
• Real small fly mobs replace the old black fly-dot particles. Flies can be saved, killed or eaten by vanilla frogs using their normal tongue behavior. They have animated wings, a creative spawn egg, bounded natural spawning and finite lifetimes; no loot or froglights are produced. Closing a dirty toilet reduces attraction and natural spawning, but does not clean it.
• Swing to shoo nearby flies for about 6 seconds. Nearby unfrightened flies can cause a brief annoyance icon and occasional soft buzzing. This does not damage, slow, alter metabolism values, shake the camera or force player input.
• Gray-green odor particles around waste and dirty toilets are separate from real flies. Particle settings control odor; Minimal does not hide flies. Odor emission is range- and count-limited.
• Successful brushing grants about 60 seconds of toilet freshness, suppressing odor and attraction without deleting stored contents. Existing flies can leave or seek other sources rather than disappearing instantly. Successful toilet use or new waste ends freshness. Repeated unnecessary brushing does not waste durability.
• Server configuration options fliesEnabled and flyAnnoyanceEnabled control flies and annoyance separately; both default to true. penaltiesEnabled=false also disables annoyance and buzzing. Natural new spawning respects doMobSpawning.
• Updated English and Simplified Chinese guide text. Durations are game-tick based (seconds assume normal 20 TPS).

Hygiene and composting

Retained from NeoForge beta.1: 32-use soap gives 10 minutes of clean hands, halving food-induced diarrhea probability; successful excretion removes the effect. It does not purify untreated water. Shovel-turn an eligible compost batch once to advance it by about 15 seconds and raise fertilizer output from 3 to 4, using durability only on success. Includes live body-state guide explanations and state-change HUD synchronization.

Validation and upgrade limits

Each of the four builds passed 46 unit tests and 94 required Minecraft GameTests, plus independent production-server save/restart checks that preserved old toilet contents and verified fly persistence/cleanup. Core graphical-client checks were completed separately for each build, including real fly rendering, natural attraction, annoyance and actual hand-swing shooing. For NeoForge 1.20.1, toilet/bottle GUI checks were performed earlier the same day before the fly update; those static resources were unchanged, while final fly interactions were rechecked.

An additional single-client connection to a separate local dedicated server was tested on Fabric 1.21.1 only. This does not establish two-real-client multiplayer coverage or equivalent network testing on the other three builds. Cloud audio playback was unavailable, so buzzing was not verified by listening. Frog tongue behavior passed server GameTests on all four builds; clear free-AI tongue screenshots were captured on Fabric, not all four editions.

Upgrade from NeoForge 2.2.0-beta.1 only in a backed-up copy with the same Minecraft version and loader. Remove the old mod JAR before installing this one. Preserved IDs and data fields do not establish safe cross-loader migration. Never open a 1.21.1 world in 1.20.1. This is a Beta; long-duration multiplayer, every modpack, shader and resource pack are not guaranteed.

中文简述

本文件仅用于 Minecraft 1.20.1 / NeoForge 47.1.106 / Java 17。不需要 Fabric API。服务端与每位客户端均需安装匹配版本，不要混装加载器版本。

四版共同更新中空陶瓷马桶、原版瓶形生水/净水瓶、真实可保存苍蝇与青蛙吐舌捕食、挥击驱散、无数值惩罚的短暂烦躁、独立气味粒子及清洁刷约60秒清新。闭盖只减弱气味和吸引，不能清污；再次成功如厕或投入新污物会结束清新。粒子“最少”只关闭气味，不删除苍蝇。洗手、铲子翻堆、手册状态解释及HUD差分同步本轮同步到Fabric，NeoForge继续保留原有功能。先备份并在同版本、同加载器的世界副本测试，不能据此保证跨加载器迁移或长期多人稳定性。

Created with an AI coding assistant, including implementation, documentation and original pixel-art assets. Code and original assets use the MIT License, copyright (c) 2026 HOOH. This mod uses fictional game mechanics, not real-world health or sanitation advice. Not an official Minecraft product; not approved by or associated with Mojang or Microsoft.