# 📋 FiveLua Motels — Advanced Motel System

[TR] Türkçe kurulum ve özellikler kılavuzu aşağıdadır.  

[EN] English installation and features guide is listed below.

---

## 🇹🇷 Türkçe (Turkish)

### ✨ Özellikler

*   **Modern & Premium Arayüz:** Kullanıcı dostu ve göz alıcı NUI tasarımı.

*   **Çoklu Motel Desteği:** Sınırsız motel tanımlayabilme (Örn: Pinkcage, Sandy Shores vb.).

*   **Tema ve Stil Çeşitliliği:** Her motel için ayrı tema renkleri (pink, lime, emerald, purple, cyan, yellow, vintage, white) ve logolar.

*   **Detaylı Oda Yönetimi & Misafir İzinleri:** Anahtar, Depo, Yükseltme, Kıyafet Odası, Yatak, Duş ve Oda Yönetimi gibi yetkilerin misafirlere özel olarak verilip/kaldırılabilmesi.

*   **Dinamik Profil Resimleri:** Oyuncunun Steam avatarı veya anlık oyun içi ped headshot (Mugshot) fotoğrafı.

*   **Gelişmiş Depo Yükseltme:** UI üzerinden slot ve ağırlık ön izlemeli depo geliştirme.

*   **Özelleştirilebilir Uyku & Duş Fonksiyonları:**

    *   **Uyku:** Can yenileme, stres azaltma, karakter değiştirme (logout) veya oyundan çıkış.

    *   **Duş:** Barut temizleme (gunpowder) veya stres azaltma.

### ⚙️ Kurulum

1.  Resource klasörünüze `fivelua-motels` dosyasını yükleyin.

2.  Klasör içindeki `sql.sql` dosyasını veritabanınıza (Database) aktarın (import).

3.  `shared/config.lua` dosyasını açıp sunucunuzun ayarlarına (koordinatlar, fiyatlar, oda stilleri vb.) göre düzenleyin.

4.  `shared/configserver.lua` dosyasından Steam Web API anahtarınızı girin. (Steam avatarları için gereklidir).

5.  Eğer standart dışı veya özelleştirilmiş bir hud/envanter/kıyafet paketi kullanıyorsanız `editable/c_framework.lua` ve `editable/s_framework.lua` dosyalarından fonksiyonları uyarlayın.

6.  `server.cfg` dosyanıza `ensure fivelua-motels` satırını ekleyin.

7.  Sunucunuzu başlatın veya scripti restart edin.

---

## 🇬🇧 English (English)

### ✨ Features

*   **Modern & Premium UI:** Eye-catching, user-friendly, responsive NUI interface.

*   **Multi-Motel Support:** Define unlimited motels (e.g. Pinkcage, Sandy Shores, etc.).

*   **Themes & Custom Branding:** Separate theme colors (pink, lime, emerald, purple, cyan, yellow, vintage, white) and custom logos for each motel.

*   **Granular Guest Permissions:** Give or revoke permissions (Key, Stash, Upgrade, Outfit, Sleep, Shower, Management) to guest players individually.

*   **Dynamic Avatars:** Choose between the player's Steam avatar or live in-game ped headshot (Mugshot) photos.

*   **Advanced Stash Upgrades:** Upgrade room stash weight & slots with previews directly inside the UI.

*   **Custom Sleep & Shower Actions:**

    *   **Sleep:** Regenerate health, relieve stress, logout character, or quit the game.

    *   **Shower:** Clean weapon gunpowder/dirty hands or relieve stress.

### ⚙️ Installation

1.  Drag and drop `fivelua-motels` into your resources directory.

2.  Import the `sql.sql` file into your database.

3.  Open `shared/config.lua` and adjust configurations (coords, pricing, room styles, etc.).

4.  Add your Steam Web API Key in `shared/configserver.lua` (Required for Steam profile avatars).

5.  If using custom clothing, inventory, or notifications, adapt the functions in `editable/c_framework.lua` and `editable/s_framework.lua`.

6.  Add `ensure fivelua-motels` to your `server.cfg`.

7.  Start the server or restart the resource.

For map : https://discord.gg/AuMWVe9vXB