Hot Bath

Hot Bath — 4.0 Major Update

Dirtiness System

A brand-new hygiene mechanic that tracks how dirty your character gets over time.

• Gradual dirt accumulation over 5 in-game days (base rate), influenced by multiple environmental factors:
  • Biome: Nether (1.6x), Badlands/Desert/Swamp (1.5x), Jungle (1.3x), Mushroom Island (0.8x), Ocean/River (0.85x)
  • Activity: Sprinting (1.3x), Crawling (1.4x), Swimming (0.7x), Flying (0.9x)
  • Weather: Rain (0.6x) and Thunderstorms (0.5x) help wash you off
  • Depth: Deep caves below Y=0 (1.4x), caves below Y=50 (1.2x)
  • Ground type: Dirt/Sand blocks slightly increase accumulation
• Instant dirt events: Getting hurt (+2%), killing mobs (+3%), killing bosses (+8%), nearby explosions (+5%), mining (+0.5%)
• Visual dirt overlay on player model with 10 procedural patterns, progressively covering legs → body → arms → head
• Fly particles spawn around the player after staying at 100% dirtiness for 2+ in-game days
• Bathing cleans you up: Standing in any hot bath fluid cleans you in ~20 seconds; moving in the water speeds it up to ~15 seconds
• Debug commands: /dirtiness get, /dirtiness set, /dirtiness clean
• Can be toggled off in config

Datapack-Driven Custom Fluids

Create unlimited custom bath fluids via datapacks — no code or recompilation required.

• Datapack path: data/<namespace>/hotbath/custom_fluids/<name>.json
• Fully configurable properties:
  • Color (RGB), opacity, luminosity (0–15)
  • Temperature (°C), viscosity, density
  • Still and flowing textures (defaults to grayscale tinting)
  • Particle toggles: splash, bubbles, steam
  • Potion effects with configurable duration, amplifier, ambient, and icon visibility
  • Trigger time (seconds before effects apply)
  • Nutrition and thirst values (for compat mod integration)
• Built-in localization: Define translations for multiple languages directly in the JSON (en_us, zh_cn, ja_jp, etc.) with locale fallback chains
• Full item support: Custom fluid buckets, drinkable bottles, and splash bottles are automatically generated
• Fluid spreading: Custom fluids propagate their identity through BlockEntity data when flowing
• Waterlogging support: Any block can be waterlogged with custom fluids
• Hot reload: Fluids update when datapacks are reloaded
• Public API (CustomFluidAPI): Other mods can query, create, and apply custom fluid effects programmatically
• Guide book (Patchouli): Includes documentation, JSON format reference, and example fluids (Golden Bath, Slime Bath, Blazing Bath, Ender Bath, Enchanted Bath, Milk Tea Bath, Silent Spring Bath)

Mod Compatibility

All integrations are optional — Hot Bath detects installed mods at runtime and enables features automatically. If a compat fails, it is disabled gracefully with an in-game notification.

Alex's Mobs

• Dirty player interactions: Dirty players attract flies, mosquitoes (aggressive), and cockroaches (loitering)
• Raccoons: Wash items 1.5x faster in hot bath fluids; increased tame chance near hot baths
• Capuchin monkeys: Attracted to hot springs, receive Regeneration buff, easier to tame (inspired by Japanese macaques)

Alex's Caves

• Gummy Bears take damage in hot water (melting mechanic)
• Herbal Bath can cure the IRRADIATED effect
• Gammaroach attracted to dirty players
• Raycat sits near hot springs

Serene Seasons

• Bathing in winter grants bonus Resistance (Early/Late Winter: Level I, Mid Winter: Level II)
• Ice and snow melt near hot bath fluids

Twilight Forest

• Bathing in hot water removes Frost effects and grants frost resistance
• Firefly particle effects appear around bath pools in the Twilight Forest dimension
• Ice-type mobs (Ice Crystal, Stable/Unstable Ice Core, Snow Guardian, Snow Queen) take damage in hot water

Farmer's Delight

• Bathing grants the Comfort effect (regenerates 1 HP every 4 seconds, ignoring hunger level)

Patchouli

• In-game Hot Bath Guide book with dynamic page visibility based on which compat mods are active