Simple Water Breathing Potion

Stop holding your breath and start exploring. Simple Water Breathing adds a vanilla-friendly recipe for a 5-minute Water Breathing Potion.
Back to Files

MGG-Simple-Water-Breathing-0.2.4.jar

File nameMGG-Simple-Water-Breathing-0.2.4.jar
Uploader
MrGreenGamesMrGreenGames
Uploaded
Sep 11, 2026
Downloads
46
Size
157.1 KB
File ID
8856161
Type
R
Release
Supported game versions
  • 0.6

What's new

Water Breathing System
- Reworked the Water Breathing effect to use a dedicated Java-based oxygen system.
- Replaced the original static +10% Oxygen status modifier.
- While the Water Breathing effect is active and the player is submerged, oxygen is now held at approximately 95% capacity.
- Oxygen changes are temporarily suppressed while underwater with the effect active, preventing normal drowning-related oxygen loss.
- Normal oxygen behavior is restored when the effect is no longer actively controlling the player's oxygen.
- Water Breathing continues to last 5 minutes.
- Drinking another potion refreshes the effect duration rather than stacking multiple durations.

Potion Recipe
- Changed the recipe from the standard empty potion bottle to the Small Empty Potion Bottle.
- The recipe now requires:
  - 1 Small Potion Bottle
  - 1 Water Essence
- Crafting remains available through the Alchemy Bench.

Potion Consumption
- Added a dedicated Water Breathing potion consumption interaction rather than relying on the standard stamina-potion interaction.
- Normal secondary-use now handles drinking the potion in Adventure mode.
- Crouch + secondary-use preserves the ability to use/place the bottle rather than triggering the drinking interaction.
- Updated the successful drinking sound to the proper potion-consumption sound.

Empty Bottle Return
- Drinking a Water Breathing Potion now returns 1 Small Empty Potion Bottle to the player.
- If the potion is consumed successfully, the bottle is returned after the effect is applied.

Stack Size
- Reduced the maximum Water Breathing Potion stack size from 30 to 10.

In-Game Guide
- Added the new command:

  /mggwaterbreathing

- The command requires no permission.
- Added an in-game guide showing:
  - Potion recipe
  - How to drink/use the potion
  - Water Breathing duration
  - Effect behavior

Item Information
- Added a proper item description explaining the potion's purpose, duration, and recipe.
- Added the Small Potion Bottle requirement to the displayed recipe information.
- Added a glass physical-material definition to the potion.
- Added an interaction hint to the potion item.
- Removed the older explicit IsUsable item flag in favor of the updated interaction system.

Mod Architecture
- Converted the mod from an asset-only ZIP package into a JAR-based Hytale mod with a Java plugin component.
- Added the WaterBreathingPlugin main class.
- Added dedicated oxygen-management systems for applying and safely releasing the Water Breathing behavior.
- The existing asset pack is now bundled directly inside the JAR.

Compatibility
- Updated supported Hytale server version from:

  >=0.5.0 <0.7.0

  to:

  >=0.6.4 <0.7.0

This mod has no additional files