🚽 ToiletReal

Ever wondered where all that food and drink in Minecraft actually goes?
ToiletReal introduces realistic bladder and bowel management, animated porcelain toilets, custom fluid physics, and hygiene mechanics to your survival world!

!Minecraft !Loaders !GeckoLib

---

🎮 Quick Controls Cheat Sheet

Action	How to do it	Notes
Sit on Toilet	Right-Click seat	Lid must be open
Open / Close Lid	Shift + Right-Click (or Left-Click)	Prevents accidental sits
Flush	Right-Click tank or top	Cleans the bowl with 3D audio
Push / Strain Faster	Hold Space or W (Seated)	Speeds up relief with straining sound
Use Urinal	Right-Click urinal	Hands-free; step away to finish
Relieve Outdoors (Pee)	Hold Z (Standing)	Parabolic stream; extinguishes fire! (Rebindable)
Relieve Outdoors (Squat)	Hold Shift + Z (Crouching)	Empties bowel; uses 1 Paper/Leaves to wipe
Unclog Toilet	Hold Right-Click with Plunger	3-second animated pumping clears clog

---

💧 Core Features

1. The Needs Meters

• Bladder (Yellow): Fills when drinking (water, potions, milk, soups, fruit).
• Bowel (Brown): Fills when eating solid foods (raw meat, rotten flesh, and heavy meals fill faster).
• Urgency & Accidents: Bars pulse at 80%. Reaching 100% gives a 10-second countdown. If ignored, an involuntary accident occurs, leaving puddles/piles and visible stains on your clothing for 1 minute!
• Washing Off: Stains wash off instantly in water (swimming, rain, or water cauldrons).

2. Porcelain Plumbing & Clogs

• Toilet Bowl: Fully animated sit-down porcelain toilet. Water color changes dynamically (clean blue, yellow, or dirty brown).
• Urinal & Dividers: Wall-mounted urinals for quick relief. Place privacy dividers on the sides or standalone.
• Clogging & The Plunger: Flushing solid waste has a 1 in 5 chance to back up! A clogged toilet jams open with visible waste. Stand close with a Plunger and hold Right-Click for 3 seconds to clear it. Features custom 1st & 3rd-person pumping animations!

3. Outdoors & Survival Utilities

• Extinguish Flames: Your outdoor stream arcs up to 3 blocks and actively puts out campfires, soul fire, lit mobs, and yourself if burning!
• Wiping System: When squatting outdoors (Shift + Z), carry Paper, Leaves, or modded toilet paper in your inventory to wipe clean and avoid stains.
• Organic Fertilizer: Solid waste can be crafted into Bone Meal (1 pile = 3 Bone Meal).

4. Customizable HUD (Move Anywhere!)

• Sleek, unobtrusive status bars sitting beside the vanilla HUD.
• Overlapping with other mods? (e.g. Thirst Was Taken):
  • Open the Visual HUD Editor (via Cloth Config in Mod Menu / Mods list) to drag & drop the bars anywhere on your screen with 5px grid snapping (G key).
  • Or use quick in-game commands: /pgctoilet hud anchor ABOVE_HEALTH (moves above health hearts) or /pgctoilet hud offset <x> <y>.

---

🛠️ Recipes

Crafting

Item / Block	Recipe	Description
Toilet Bowl	6 Quartz Blocks + 1 Iron Trapdoor + 1 Water Bucket	Full porcelain toilet
Urinal	5 Quartz Blocks + 1 Iron Ingot	Wall-mounted urinal unit
Urinal Divider (x3)	6 Smooth Quartz Slabs	Privacy partitions
Plunger	2 Sticks + 1 Red Concrete	Clears clogged toilets (64 uses)
Bone Meal (x3)	1 Poop Block (Shapeless)	Natural crop fertilizer

Brewing (Awkward Potion Base)

Potion	Ingredient	Effect
Diuretic Potion	Dandelion	Accelerates bladder accumulation (+1.0/s for 1m)
Laxative Potion	Brown Mushroom or Poop Block	Accelerates bowel accumulation (+1.0/s for 1m)
Splash / Lingering	Add Gunpowder / Dragon's Breath	Area-of-effect variants

---

📦 Requirements & Compatibility

• Supported Versions: 1.20.1 and 1.21.1
• Supported Loaders: Fabric, Forge, NeoForge
• Required Dependency: GeckoLib 4
• Optional Dependency: Cloth Config (for in-game visual HUD positioning screen)
• Multiplayer Friendly: 100% compatible with dedicated servers! Animations, meters, stains, and custom sounds sync across all players.