Skip to content

crabsatellite/hotBath

Repository files navigation

100w.png

Hot-bath Mod

GitHub

Mod Download

Introduction

Welcome to Hot Bath Mod! Take a break from your adventures and soak in a relaxing hot bath. It's not just about hygiene; it's about buffs, healing, and magical effects! Whether you need to recover health, remove negative effects, or just warm up, we have the perfect bath for you.

Recommended Mods

  • 🛁 Official Extension | ShowerCore 🛁 Ready to take your hygiene to the next level? 🚿✨ Introducing ShowerCore, the official HotBath extension that brings the splash! We're talking fully functional Bathtubs, refreshing Showers, and the absolute necessity—Rubber Ducks! 🦆💦 Don't just bathe, celebrate cleanliness!

  • 🌟 Highly Recommended | Fluidlogged 🌟
    Modrinth Link
    Fluidlogged enables custom fluid blocks to have a waterlogged effect with blocks like stairs, slabs, and more, allowing hotbath fluids to integrate naturally into various structures.
    Note: Starting from HotBath 4.0.0 (1.21.1), the mod handles waterlogging natively — Fluidlogged is no longer needed for 1.21.1 users.

Known Issues

  • Optifine Incompatibility:
    Optifine may cause rendering issues with fluid colors in this mod. For example, fluids like milk bath may not display their correct colors and appear watery. This is a known incompatibility with Optifine, which affects the rendering of many mods. We recommend using alternative shader mods such as Sodium or Oculus for better compatibility.

Update 4.0 (1.20.1 Forge / 1.21.1 NeoForge)

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), 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)

Example Datapack Downloads:


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 when washing items in hot bath fluids
  • 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
  • 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

Update 3.0 (1.20.1 Forge / 1.21.1 NeoForge+)

New Items: Bath Water Bottles

Drinkable Bottles:

  • Hot Water Bottle Hot Water Bottle: SpeedSpeed.png I (45s)
  • Honey Bath Water Bottle Honey Bath Water Bottle: AbsorptionAbsorption.png I (45s)
  • Milk Bath Water Bottle Milk Bath Water Bottle: Randomly remove 1 negative effect
  • Herbal Bath Water Bottle Herbal Bath Water Bottle: Heal 3 heartsHealth.png + ResistanceResistance.png I (45s)
  • Peony Bath Water Bottle Peony Bath Water Bottle: LuckLuck.png I (45s)
  • Rose Bath Water Bottle Rose Bath Water Bottle: StrengthStrength.png I (45s)

Splash Bath Water Bottles:

  • Effect: Thrown like a splash potion. Upon impact, it grants a Level 2 "Cold Resistance" buff (30s) Cold Resistance to players hit.
  • Hot Water Splash Hot Water Bottle: SpeedSpeed.png II (30s)
  • Honey Splash Honey Bath Bottle: AbsorptionAbsorption.png II (30s)
  • Milk Splash Milk Bath Bottle: Remove 2 negative effects
  • Herbal Splash Herbal Bath Bottle: ResistanceResistance.png II (30s) + Heal 2 heartsHealth.png
  • Peony Splash Peony Bath Bottle: LuckLuck.png II (30s)
  • Rose Splash Rose Bath Bottle: StrengthStrength.png II (30s)

Splash Bath Water Brewing Recipes

Add Gunpowder to any Bath Water Bottle to create its splash version.

splash_hot_water_bottle_composite_eng.png

Fluid Interactions

  • Bubble Columns: Soul Sand creates upward bubbles, Magma Blocks create downward bubbles.
  • Visuals: Custom bubble and drip particles matching the fluid color.

Mod Integrations

Note: These three mods all introduce temperature mechanics. To avoid conflicts or redundant features, it is recommended to install only one of them at a time.

  • Tough As Nails:
    • Bottles provide warming effect.
    • HotBath fluids provide warming effect.
  • Cold Sweat:
    • Bottles increase body temp to ~36°C.
    • HotBath fluids maintain body temp at ~37°C.
  • Legendary Survival Overhaul:
    • Bottles restore thirst Hydration and give "Hot Drink" buff Hot Drink.
    • HotBath fluids provide "Cold Resistance" Cold Resistance and "Thermostatic" buffs Thermostatic.

Classic Features (Items & Recipes)

Bath HerbBath Herb.png

How to get:

  • Buy 1 bath herb for 10 emeraldsEmerald.png from Novice Farmer Villagers.
  • Buy 1 bath herb for 15 emeraldsEmerald.png from Wandering Traders.

Important Notes

  • Aquatic Life: Fish (except tropical fish) and octopuses will take damage in HotBath fluids. Aquatic creatures will not spawn naturally.
  • Placement: Coral, Conduits, and Sea Grass cannot be placed in HotBath fluids.
  • Fishing: You cannot catch items by fishing in HotBath fluids.

The Buckets

Hot Water Hot Water Bucket.png

Description: Soaking your feet is really comfortable.

Recipe: Water BucketWater Bucket.png + Smelting (Any Fuel)

Effects:

  • Bathing for 15s gives SpeedSpeed.png I (20s).
  • Hidden Achievement [Foot Health]: Bathe 100 times. Reward: 100 XP.

Milk Bath Milk Bath Bucket.png

Description: It's not for drinking.

Recipe: Hot Water Bucket + Milk BucketMilk Bucket.png

milk_bath_bucket composite.png

Effects:

  • Restores HealthHealth.png (0.25/2s) and HungerHunger.png (1/15s).
  • Bathing for 15s removes all negative effects (except Bad LuckBad Luck.png).
  • Hidden Achievement [Milk Skin]: Bathe 100 times. Reward: 100 XP.

Herbal Bath Herbal Bath Bucket.png

Description: Bah, why is this so bitter?

Recipe: Hot Water Bucket + Bath Herb x2

bath_herb_composite.png

Effects:

  • Restores HealthHealth.png (0.25/2s).
  • Bathing for 15s removes all negative effects.
  • Bathing for 5s gives ResistanceResistance.png I (10s).
  • Damages Undead mobs (0.5/s).
  • Hidden Achievement [Chronic Invalid]: Bathe 100 times. Reward: 100 XP.

Peony Bath Peony Bath Bucket.png

Description: It would be better if there was a beauty.

Recipe: Hot Water Bucket + Peony x2Peony.png

peony_bath_bucket composite.png

Effects:

  • Restores HealthHealth.png (0.25/2s).
  • Bathing for 15s removes negative effects and Bad OmenBad Omen.png.
  • Bathing for 15s gives Knockback Resistance (+0.05, 30s) and Attack Speed (+10%, 15s).
  • Special: After 50 baths, every subsequent bath gives LuckLuck.png I (45s).

Honey Bath Honey Bath Bucket.png

Description: This bath is a little bit sticky.

Recipe: Hot Water Bucket + Honeycomb BlockHoneycomb Block.png

honey_bath_bucket composite.png

Effects:

  • Restores HealthHealth.png (0.25/s) and HungerHunger.png (1/4s).
  • Gives SlownessSlowness.png I (10s) while bathing.
  • Bathing for 15s removes negative effects (except Slowness/Bad Luck).
  • Bathing for 15s gives AbsorptionAbsorption.png II (20s).

Rose Bath Rose Bath Bucket.png

Description: What a romantic treat.

Recipe: Hot Water Bucket + Rose Bush x8Rose Bush.png

rose_bath_bucket composite.png

Effects:

  • Restores HealthHealth.png (0.25/s).
  • Bathing for 15s removes negative effects and Bad OmenBad Omen.png.
  • Bathing for 15s gives StrengthStrength.png I (20s).
  • Hidden Achievement [Rose Body Fragrance]: Bathe 100 times. Reward: 100 XP.

Hot-bath Mod (中文介绍)

简介

欢迎来到 Hot Bath Mod (热浴模组)!在紧张的冒险之余,来泡个舒服的热水澡吧。这不仅仅是为了清洁,更是为了获得增益、治疗和神奇的效果!无论你是需要恢复生命、移除负面效果,还是仅仅想暖暖身子,我们都有适合你的浴汤。

推荐模组

  • 🛁 官方扩展 | 洗浴核心 (ShowerCore) 🛁 准备好让你的洗浴体验焕然一新了吗?🚿✨ 隆重推出 洗浴核心 (ShowerCore) —— HotBath 的 官方 延伸模组,带你嗨翻浴室!这里有功能齐全的 浴缸、清爽无比的 淋浴,还有绝对不能少的灵魂伴侣——小黄鸭!🦆💦 别只是洗澡,要 享受 洗澡!

  • 🌟 强烈推荐 | Fluidlogged 🌟
    Modrinth 链接
    Fluidlogged 可以让自定义流体方块(如本模组的浴水)与楼梯、台阶等方块共存(含水效果),让你的浴室设计更加自然美观。
    注意: 从 HotBath 4.0.0 (1.21.1) 起,模组已内置含水功能 — 1.21.1 用户不再需要 Fluidlogged。

已知问题

  • 不支持 Optifine:
    Optifine 可能会导致本模组中的流体颜色渲染出现问题,例如牛奶浴等流体可能不会显示正确的颜色,呈现出水样效果。这是 Optifine 与许多模组不兼容的已知问题。我们建议使用 Sodium (钠)Oculus 等替代光影模组以获得更好的兼容性。

4.0 重大更新 (1.20.1 Forge / 1.21.1 NeoForge)

脏污度系统

全新的卫生系统,追踪你的角色随时间变脏的程度。

  • 渐进式脏污积累,基础速率为 5 个游戏日达到最脏,受多种环境因素影响:
    • 生物群系: 下界 (1.6x)、恶地/沙漠/沼泽 (1.5x)、丛林 (1.3x)、海洋/河流 (0.85x)
    • 活动状态: 疾跑 (1.3x)、匍匐 (1.4x)、游泳 (0.7x)、飞行 (0.9x)
    • 天气: 雨天 (0.6x) 和雷暴 (0.5x) 能帮助冲洗
    • 深度: Y=0 以下的深层洞穴 (1.4x)、Y=50 以下的洞穴 (1.2x)
    • 地面类型: 泥土/沙子方块会略微增加积累速度
  • 瞬时脏污事件: 受伤 (+2%)、击杀生物 (+3%)、击杀 Boss (+8%)、附近爆炸 (+5%)、挖矿 (+0.5%)
  • 视觉污垢覆盖层: 玩家模型上有 10 种程序化污垢图案,按腿部 → 躯干 → 手臂 → 头部渐进显示
  • 苍蝇粒子: 100% 脏污度持续 2 个以上游戏日后,苍蝇会在玩家周围生成
  • 泡澡清洁: 站在任何温泉液体中约 20 秒即可完全清洁;在水中移动可加速至约 15 秒
  • 调试命令:/dirtiness get/dirtiness set/dirtiness clean
  • 可在配置中关闭

数据包驱动的自定义液体

通过数据包创建无限自定义浴液 — 无需编程或重新编译。

  • 数据包路径: data/<namespace>/hotbath/custom_fluids/<name>.json
  • 完全可配置的属性:
    • 颜色 (RGB)、透明度、亮度 (0–15)
    • 温度 (°C)、粘度、密度
    • 静止和流动纹理(默认灰度着色)
    • 粒子开关: 水花、气泡、蒸汽
    • 药水效果(可配置持续时间、等级、环境效果和图标可见性)
    • 触发时间(效果生效前所需秒数)
    • 营养值和口渴值(用于兼容模组联动)
  • 内置本地化: 直接在 JSON 中定义多语言翻译(en_uszh_cnja_jp 等),支持语言回退链
  • 完整物品支持: 自动生成自定义液体桶、饮用瓶和喷溅瓶
  • 流体传播: 自定义液体通过 BlockEntity 数据在流动时传播其身份标识
  • 含水支持: 任何方块都可以被自定义液体含水
  • 热重载: 数据包重载时液体即时更新
  • 公共 API (CustomFluidAPI): 其他模组可以通过编程查询、创建和应用自定义液体效果
  • 指南书 (Patchouli): 包含文档、JSON 格式参考和示例液体(黄金浴、史莱姆浴、烈焰浴、末影浴、附魔浴、奶茶浴、寂静之泉浴)

示例数据包下载:


模组兼容

所有联动均为可选 — Hot Bath 在运行时自动检测已安装的模组并启用对应功能。若联动失败,会优雅地禁用并在游戏内通知玩家。

Alex's Mobs

  • 脏污玩家互动: 脏污的玩家会吸引苍蝇、蚊子(攻击性)和蟑螂(徘徊)
  • 浣熊: 在温泉液体中洗物品速度提升 1.5 倍;在温泉液体中洗物品时更容易驯化
  • 卷尾猴: 被温泉吸引,获得再生 buff,更容易驯化(灵感来自日本猕猴)

Alex's Caves

  • 软糖熊在热水中受到伤害(融化机制)
  • 草药浴可以治愈辐射效果
  • 伽马蟑螂被脏污的玩家吸引
  • 辐射猫在温泉旁坐下

Serene Seasons(四季)

  • 冬季泡澡获得额外抗性提升(初冬/晚冬: I 级,仲冬: II 级)
  • 温泉附近的冰雪会融化

Twilight Forest(暮色森林)

  • 泡热水澡移除冰冻效果
  • 暮色森林维度的浴池周围出现萤火虫粒子效果
  • 冰系怪物(冰晶、稳定/不稳定冰核、雪卫兵、雪女王)在热水中受到伤害

Farmer's Delight(农夫乐事)

  • 泡澡获得舒适(Comfort)效果(每 4 秒恢复 1 HP,无视饥饿值)

Patchouli

  • 游戏内 Hot Bath 指南书,根据已启用的兼容模组动态显示/隐藏对应页面

3.0 版本更新 (1.20.1 Forge / 1.21.1 NeoForge+)

新物品:浴水瓶

饮用型浴水瓶:

  • 热水瓶 Hot Water Bottle: 速度Speed.png I (45 秒)
  • 蜂蜜浴水瓶 Honey Bath Water Bottle: 伤害吸收Absorption.png I (45 秒)
  • 牛奶浴水瓶 Milk Bath Water Bottle: 随机移除 1 个负面效果
  • 草药浴水瓶 Herbal Bath Water Bottle: 恢复 3 心生命值Health.png + 抗性提升Resistance.png I (45 秒)
  • 牡丹浴水瓶 Peony Bath Water Bottle: 幸运Luck.png I (45 秒)
  • 玫瑰浴水瓶 Rose Bath Water Bottle: 力量Strength.png I (45 秒)

喷溅型浴水瓶:

  • 效果: 像喷溅药水一样投掷。撞击后,给予被击中的玩家 2 级“抗寒”buff (30 秒) Cold Resistance
  • 热水 Splash Hot Water Bottle: 速度Speed.png II (30 秒)
  • 蜂蜜 Splash Honey Bath Bottle: 伤害吸收Absorption.png II (30 秒)
  • 牛奶 Splash Milk Bath Bottle: 移除 2 个负面效果
  • 草药 Splash Herbal Bath Bottle: 抗性提升Resistance.png II (30 秒) + 恢复 2 心生命值Health.png
  • 牡丹 Splash Peony Bath Bottle: 幸运Luck.png II (30 秒)
  • 玫瑰 Splash Rose Bath Bottle: 力量Strength.png II (30 秒)

喷溅药水酿造配方

所有种类的浴水瓶加入 火药 即可酿造为喷溅型浴水瓶。

splash_hot_water_bottle_composite_chn.png

流体交互

  • 气泡柱: 灵魂沙产生上升气泡,岩浆块产生下沉气泡。
  • 视觉效果: 自定义气泡和滴水粒子,颜色与流体一致。

模组联动

注意: 这三个模组都引入了温度机制。为了避免冲突或功能冗余,建议每次只安装其中一个

  • Tough As Nails:
    • 浴水瓶提供升温效果。
    • HotBath 流体提供升温效果。
  • Cold Sweat:
    • 浴水瓶将体温升至约 36°C。
    • HotBath 流体将体温维持在约 37°C。
  • Legendary Survival Overhaul:
    • 浴水瓶恢复口渴值 Hydration 并给予“热饮”buff Hot Drink
    • HotBath 流体提供“抗寒” Cold Resistance 和“恒温”buff Thermostatic

经典功能 (物品与配方)

洗浴用药草 (Bath Herb)Bath Herb.png

获取方式:

  • 新手级农民村民处用 10 个绿宝石Emerald.png购买。
  • 流浪商人处用 15 个绿宝石Emerald.png购买。

注意事项

  • 水生生物: 热带鱼以外的鱼类和章鱼在 HotBath 方块中会受到伤害。水中生物不会自然生成。
  • 放置限制: 珊瑚、潮涌核心、海草等无法放置在 HotBath 方块中。
  • 钓鱼: 在 HotBath 方块中无法钓起任何物品。

各种浴桶

热水桶 (Hot Water Bucket)Hot Water Bucket.png

描述: 泡脚好舒服。

制作: 水桶Water Bucket.png + 任意燃料烧炼

功效:

  • 浸泡 15 秒获得 速度Speed.png I (20 秒)。
  • 隐藏进度 [足力健]: 浸泡 100 次。奖励: 100 经验。

牛奶浴桶 (Milk Bath Bucket)Milk Bath Bucket.png

描述: 这不是用来喝的。

制作: 热水桶 + 牛奶桶Milk Bucket.png

milk_bath_bucket composite.png

功效:

  • 恢复 生命值Health.png (0.25/2 秒) 和 饥饿值Hunger.png (1/15 秒)。
  • 浸泡 15 秒移除除霉运外的所有负面效果。
  • 隐藏进度 [牛奶肌]: 浸泡 100 次。奖励: 100 经验。

中草药浴桶 (Herbal Bath Bucket)Herbal Bath Bucket.png

描述: 呸呸,好苦啊。

制作: 热水桶 + 洗浴用药草 x2

bath_herb_composite.png

功效:

  • 恢复 生命值Health.png (0.25/2 秒)。
  • 浸泡 15 秒移除所有负面效果。
  • 浸泡 5 秒获得 抗性提升Resistance.png I (10 秒)。
  • 对亡灵生物造成伤害 (0.5/秒)。
  • 隐藏进度 [药罐子]: 浸泡 100 次。奖励: 100 经验。

牡丹浴桶 (Peony Bath Bucket)Peony Bath Bucket.png

描述: 浴桶已备好,美人何处觅。

制作: 热水桶 + 牡丹 x2Peony.png

peony_bath_bucket composite.png

功效:

  • 恢复 生命值Health.png (0.25/2 秒)。
  • 浸泡 15 秒移除负面效果和不祥之兆Bad Omen.png
  • 浸泡 15 秒获得 击退抗性 (+0.05, 30 秒) 和 攻击速度 (+10%, 15 秒)。
  • 特殊: 累计浸泡 50 次后,每次浸泡获得 幸运Luck.png I (45 秒)。

蜂蜜浴桶 (Honey Bath Bucket)Honey Bath Bucket.png

描述: 这个汤浴有点粘。

制作: 热水桶 + 蜜脾块Honeycomb Block.png

honey_bath_bucket composite.png

功效:

  • 恢复 生命值Health.png (0.25/秒) 和 饥饿值Hunger.png (1/4 秒)。
  • 浸泡时获得 缓慢Slowness.png I (10 秒)。
  • 浸泡 15 秒移除负面效果 (除缓慢/霉运)。
  • 浸泡 15 秒获得 伤害吸收Absorption.png II (20 秒)。

玫瑰浴桶 (Rose Bath Bucket)Rose Bath Bucket.png

描述: 浪漫的享受。

制作: 热水桶 + 玫瑰丛 x8Rose Bush.png

rose_bath_bucket composite.png

功效:

  • 恢复 生命值Health.png (0.25/秒)。
  • 浸泡 15 秒移除负面效果和不祥之兆Bad Omen.png
  • 浸泡 15 秒获得 力量Strength.png I (20 秒)。
  • 隐藏进度 [玫瑰体香]: 浸泡 100 次。奖励: 100 经验。


About

Minecraft mod adding therapeutic bath fluids with healing, buffs, and temperature mod integrations — 1.8M+ downloads on CurseForge. Supports Forge 1.20.1 & NeoForge 1.21.1+

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages