Better Diving Mod — Reference

Core Mechanics

The mod introduces three fundamental changes to how players interact with water:

1. Movement Overhaul

• 360-Degree Swimming: Players now swim in the direction they are looking. Looking up while moving forward will cause the player to ascend naturally.
• No Automatic Sinking: Players will hover in place when they stop moving, rather than slowly sinking to the bottom.
• Surface Speed: Swimming at the water's surface provides a speed bonus, making long-distance travel across oceans more efficient.

2. Oxygen System

• Extended Breath: The base oxygen capacity is increased from the vanilla 15 seconds to 45 seconds.
• Numerical HUD: A custom GUI replaces the vanilla bubbles with a precise timer showing remaining seconds of air.
• Depth Penalty: Diving deeper than 30 blocks increases oxygen consumption. For every 30 blocks of depth, the efficiency of your lungs decreases, requiring specialized masks to mitigate.
• Enchantment Synergy: Each level of the Respiration enchantment adds an additional 15 seconds of air (up to +45 seconds at level III).

3. Mining & Interaction

• Underwater Efficiency: By default, breaking blocks underwater is 60% as fast as on land (compared to the much slower vanilla rate).
• Aqua Affinity: This enchantment increases underwater mining efficiency to 80%.
• Gear Bonuses: Wearing specific diving gear (like Wetsuit Leggings) can restore mining speed to 100%.

Crafting & Materials

The mod uses a tiered crafting system where basic materials are refined into high-tech components.