Feat: aliano_alcohol_script_v1

Author: alinmb

LICENSE

@@ -0,0 +1,17 @@
+Copyright (c) 2025 Aliano (alinmb on GitHub)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to use,
+copy, modify, and distribute the Software, subject to the following conditions:
+
+1. The original author of the Software, "Aliano (alinmb on GitHub)", must be clearly credited in all copies or substantial portions of the Software, including within the source code, any documentation, and any public presentation of derivative works.
+
+2. The name of the script must remain unchanged. You are not permitted to rename the script or redistribute it under a different name, even after modifications.
+
+3. The original copyright and this license notice must be retained in all copies or substantial portions of the Software.
+
+4. You may not remove or alter any mention of the original author in the code or associated files.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

README.md

@@ -0,0 +1,102 @@
+![Bannière du script alcool](https://i.ibb.co/Qj1V4VHK/aliano-alcohol-script-fivem.png)
+
+# **Aliano Alcohol System**
+
+Developed by **Aliano** ([@alinmb](https://github.com/alinmb))  
+You are allowed to use and modify this script, but you **must**:
+
+- Keep the original name of the script.
+- Clearly credit me as the author, even after modifications.
+
+Thank you for respecting these conditions so everyone can benefit from this script under the best conditions!
+
+**A realistic alcohol consumption script with dynamic effects and advanced animation handling fully configurable.**
+
+---
+
+## **📌 Description**
+
+- **14 different alcohol usable items** (vodka, beer, whiskey, etc.)
+- **Realistic visual and physical effects** (progressive drunkenness, impaired movement, blackouts)
+- **Thirst management** (dynamic hydration per sip)
+- **Smooth animations** (holding bottles, drinking, stumbling)
+- **OX Inventory compatibility** (custom items, props and icons)
+- **Sip system** (multiple sips per bottle for enhanced realism)
+- **Drunk driving** (vehicle swerving, random braking)
+
+---
+
+## **✨ Features**
+
+### **1. Alcohol Consumption**
+
+- **Sip-by-sip drinking** with synchronized animations
+- **Props**
+- **Increased thirst** after consumption (configurable)
+
+### **2. Drunkenness Effects**
+
+- **3 intoxication levels**: mild, moderate, severe
+- **Impaired movement** (staggering, random falls)
+- **Visual effects** (blur, distortion, impaired vision)
+- **Blackouts** when overconsuming
+
+### **3. Hangover Management**
+
+- **After-effects** (dizziness, headaches)
+- **Gradual recovery**
+
+### **4. Drunk Driving**
+
+- **Steering deviation**
+- **Random braking**
+- **Excessive honking** (when heavily drunk)
+
+### **5. Compatibility**
+
+- **OX Inventory** (custom items + icons)
+- **Standalone**
+- **Standalone (only 1 thing to change -> thirst level, the line is already ready)**
+- **ESX**
+- **QBCore**
+- **Multilingual** (French, English)
+
+---
+
+## **🎯 Requirements**
+
+- **[OX Inventory](https://github.com/overextended/ox_inventory)** (for items)
+
+---
+
+## **⚙️ Configuration**
+
+- **Modify `config.lua`** to adjust:
+  - Effect duration
+  - Bottle threshold for effects
+  - Sips per bottle
+  - Drunkenness intensity
+  - Thirst added per consumption
+
+---
+
+## **📜 Commands**
+
+- **`/alcoholstatus`** → Check current alcohol level
+- **`/resetalcoholeffects`** → Reset effects (admin)
+
+---
+
+## **🎥 Preview Youtube**
+
+✅ **Drinking animation**  
+✅ **In-game drunkenness effects**  
+✅ **Staggering movement**  
+✅ **Impaired driving**
+
+[![Présentation YouTube du script](https://img.youtube.com/vi/GmC_OriAPfA/maxresdefault.jpg)](https://www.youtube.com/watch?v=GmC_OriAPfA)
+
+---
+
+**A realistic and immersive script for your RP servers! Don't forget to start the script in your server.cfg file.**  
+_See you soon! Aliano._