HookahCraft is a Bukkit plugin that adds an immersive hookah-smoking mechanic to Minecraft servers. Players can interact with a brewing stand placed on glass using a custom "Mouthpiece" item (a renamed stick) to simulate smoking a hookah. The plugin introduces a dynamic system where the duration of smoking affects the potion effects applied to the player, with configurable stages that range from beneficial effects like Regeneration to negative effects like Nausea and Blindness for prolonged use. Visual and audio effects, such as particles and sounds, enhance the experience, while air levels are gradually depleted to simulate breath-holding.

How It Works:

1. Setup: The plugin creates a config.yml file on first load, defining settings like the mouthpiece name, particle types, air reduction rate, and puff stages with associated effects and thresholds.
2. Interaction: Players right-click a brewing stand (placed on a glass block) while holding a stick named as the configured "Mouthpiece." This initiates the smoking process.
3. Smoking Mechanics:
   • The plugin checks if the player continues holding the mouthpiece and is looking at the brewing stand.
   • Every 0.5 seconds (10 ticks), the player’s air level decreases based on the configured rate, and particles (e.g., smoke) spawn above the brewing stand with a bubbling sound.
   • If the player switches items, stops looking at the brewing stand, runs out of air, or leaves the game, the smoking stops.
4. Puff Stages: The plugin evaluates the smoking duration when the player stops:
   • If the duration is too short (below the too-fast-threshold), a warning message is sent, and no effects are applied.
   • Otherwise, the plugin selects a puff stage based on the duration (e.g., 2.5s, 3s, 4s, or 6.5s) and applies corresponding potion effects (e.g., Regeneration for short puffs, Slowness/Nausea for longer ones) and particles at the player’s face.
5. Cleanup: When the plugin is disabled or a player quits, all active smoking tasks are canceled, and data is cleared to prevent memory leaks.