Hookah for RedM

Place it. Mix your flavours. Bring your gathering spots to life.

Add an interactive hookah experience to your RedM server, with two included models, a hand-following hose, animated puffs, flavour-coloured smoke and a live refill panel. Set up fixed hookahs in saloons and lounges, or let players carry their own and choose where to settle down.

Players take the mouthpiece, refill water and tobacco, create their own flavour blends and enjoy a shared scene that nearby players can see and hear.

At a glance: Red & gold models · Placeable inventory items · Four tobacco flavours · Water & tobacco management · English & Spanish · VORP integration & RSG bridge

What your players can do

Take the mouthpiece and enjoy the scene

• A hose that follows the player's hand: the mouthpiece attaches to the hand while the hose curves between the player and the hookah.
• Animated smoking: each puff combines a smoking animation, inhale/exhale sounds and coloured smoke visible to nearby players.
• One user per hookah: a shared occupancy lock prevents multiple players from taking the same mouthpiece at once.
• The mouthpiece returns when the player walks beyond the hose's reach. The occupancy lock is also released on death or disconnection.

Choose flavours and create your own mix

Four tobacco types are configured by default:

Adding another flavour blends it with the tobacco already in the bowl. The panel shows the mix as percentages, and each puff selects a flavour according to those proportions. Its smoke takes that flavour's colour.

Want a fresh blend? Empty the bowl to remove the remaining tobacco while keeping the water. Flavours, inventory items and colours can be customized in the configuration.

Manage water and tobacco

• Separate reserves for every hookah: each puff consumes water and tobacco. Both must be available to smoke.
• A live NUI refill panel displays reserve gauges, remaining puffs, the current blend and available refill items.
• Add water, add a flavour or empty the bowl directly from the panel. Refilling consumes the corresponding inventory items.
• Reserve changes appear live when other players smoke or refill. The panel closes when the player moves away.

Place it, pick it up and take it with you

• Use a hookah inventory item to open placement mode with a transparent preview.
• Choose a surface, rotate the hookah smoothly or in steps, then confirm or cancel placement.
• Configurable distance, slope and per-character placement limits.
• Owner-only pickup: the character who placed the hookah can return it to their inventory.
• Picking it up stores its water, tobacco and flavour mix in item metadata. Placing that item again restores its reserves.

Built for server owners

Two models and flexible placement

The package includes red and golden hookah models, along with the resource's streamed assets and sounds. No separate model pack is required.

Define fixed locations in Config.puntos, or use the included compatible base models in your map-placement tools. Fixed locations use distance-based spawning and cleanup through ox_lib points.

Configurable gameplay and integrations

• Adjust tank capacity, initial reserves, consumption per puff, refill amounts and item names.
• Configure flavours, smoke colours and intensity, animation settings, sound radius and controls.
• Use native RedM prompts, with optional sleepless_interact options alongside them.
• English and Spanish included, with JSON locale files for translations and additional languages.
• Server-side checks for puff distance, hose occupancy, cooldowns and reserves; inventory checks for refills and ownership checks for pickup.
• Developer events and a mouthpiece export allow custom integrations with stress, effects, achievements or other systems. These integrations are not included by default.
• Optional debug tools for testing models, placement, hand offsets, smoke, colours and animations.

Persistence: what is saved?

Fixed and compatible map hookahs: water, tobacco and flavour reserves are saved through resource KVP storage.

Player-placed hookahs are temporary. They are not restored after a server or resource restart. Players must pick them up beforehand; otherwise the placed hookah and its consumed placement item are lost. Picking one up preserves its reserves in the returned item's metadata.

Requirements & compatibility

Choose one framework setup. Other frameworks or inventories require adapting the editable bridge files. The escrowed resource requires the appropriate asset entitlement on the Cfx account associated with your server license key.

Quick installation

1. Place ys_cachimba in your server's resources/ folder.
2. Start ox_lib, your chosen framework and its inventory before ensure ys_cachimba.
3. Register the hookah, water and tobacco items. VORP item SQL and RSG item definitions are included in sql/; add any missing water/plain tobacco items and the inventory images.
4. Set your framework, item names, flavours and optional fixed locations in config.lua.
5. Select English with setr ox:locale "en", or Spanish with setr ox:locale "es". English is the default.
6. Start the resource, give players the configured items and refill a hookah to begin.

The included README covers setup, controls, configuration, editable files and developer integrations.

Default controls