ToiletReal

Immersive physiological needs, interactive sanitation blocks, and survival mechanics for Minecraft.

---

Overview

ToiletReal introduces realistic bladder and bowel management mechanics to Minecraft. Players accumulate physical needs naturally by consuming food, water, potions, and soups. The mod provides interactive porcelain sanitation blocks with animated models, ballistics-based fluid physics, hygiene systems, and custom brewing recipes.

Built with a lightweight multi-loader architecture supporting both Fabric and Forge 1.20.1 with 100% feature parity.

---

Features

Physical Needs System

• Bladder Tracking: Fills progressively when drinking water, potions, soups, or high-hydration fruits (apples, melons).
• Bowel Tracking: Fills when eating solid meals, scaling based on meat content, hunger replenishment, and raw foods.
• Emergency Urgency: When either meter reaches capacity, an emergency countdown begins. If ignored, the player experiences involuntary relief accompanied by slowness, nausea, and localized puddles.
• Coexistence Logic: Relief spills intelligently coexist—urine puddles disperse laterally if placed over solid waste blocks.

Interactive Sanitation Blocks

• Animated Toilet Bowl: Fully functional porcelain toilet powered by GeckoLib keyframe animations. Right-click to open/close the lid or sit down.
• Active Elimination & Struggling: While seated, hold Space or W to actively strain, speeding up elimination with dynamic strain animations and camera feedback.
• Automated Flushing: Dismounting plays a realistic 3D acoustic flush sound effect.
• Urinal & Dividers: Approach and face the urinal to relieve bladder needs automatically. Turning away immediately halts the process. Dividers can be mounted directly on urinal sides or placed standalone.

Ballistics & Fluid Physics

• Parabolic Stream: Urine particles follow realistic parabolic arcs, inheriting player velocity, pitch, and yaw.
• Fire Extinguishment: The fluid stream actively extinguishes campfires, soul campfires, open flames, and burning mobs.
• Floor Puddles: Liquid settles into translucent golden puddles that can be directly built over without requiring manual breaking.

Hygiene & Dynamic Clothing Stains

• Visual Stains: Accidents apply visible 32×32 textured wet stains on front clothing and soiled stains on the back.
• Natural Cleaning: Stains wash off instantly when stepping into water, swimming, standing in rain, or submerging in water cauldrons.

Brewing & Agriculture

• Diuretic Potion: Brewed using Awkward Potion + Dandelion, Yellow Dye, or Golden Carrot. Temporarily accelerates bladder fill rate.
• Laxative Potion: Brewed using Awkward Potion + Poop Block or Brown Mushroom. Temporarily accelerates bowel fill rate.
• Organic Fertilizer: Solid waste blocks craft into Bone Meal (1 Poop Block = 3 Bone Meal).
• Splash & Lingering Variants: Full support for brewing splash and lingering variants with Gunpowder and Dragon's Breath.

Minimalist HUD & Audio

• Sleek HUD Bars: Modern, unobtrusive status meters with 3D bevel sheen and subtle urgency blinking.
• Chat-Aware Visibility: HUD automatically hides when typing in the chat screen to avoid interface overlap.
• 3D Spatial Audio: Custom directional sound effects with distance attenuation.

---

Brewing Recipes

Potion	Base	Ingredient	Effect
Diuretic Potion	Awkward Potion	Dandelion / Yellow Dye / Golden Carrot	Accelerates bladder accumulation
Laxative Potion	Awkward Potion	Poop Block / Brown Mushroom	Accelerates bowel accumulation
Splash Variants	Any Base Potion	Gunpowder	Area-of-effect application
Lingering Variants	Splash Potion	Dragon's Breath	Persistent cloud application

---

Crafting Recipes

Item / Block	Recipe	Description
Toilet Bowl	7 Quartz Blocks + 1 Iron Trapdoor + 1 Water Bucket	Interactive sit-down toilet
Urinal	5 Quartz Blocks + 1 Iron Ingot	Wall-mounted urinal unit
Urinal Divider	6 Smooth Quartz Slabs	Yields 3 urinal privacy dividers
Bone Meal (x3)	1 Poop Block	Organic crop fertilizer

---

Admin & Testing Commands

Command	Permission	Description
/pgctoilet showcase	OP (Level 2)	Spawns a complete testing platform with all blocks, items, crafting wall, and brewing stations.
/pgctoilet reset <player>	OP (Level 2)	Resets all physical needs meters and active timers for the target player.
/pgctoilet set <player> <bowel|bladder> <value>	OP (Level 2)	Sets the specified meter value for a player.
/pgctoilet stain <pee|poop|all|clear>	OP (Level 2)	Directly toggles clothing stain overlays for visual testing.
/pee	OP (Level 2)	Toggles manual fluid particle stream for testing.

---

Requirements & Compatibility

• Minecraft: 1.20.1
• Supported Loaders: Fabric / Forge
• Required Dependency: GeckoLib 4 (>= 4.4.4)
• Multiplayer: Fully compatible with dedicated servers. Client and server sync all animations, needs meters, and sounds.