🏠 Dodi Housing - Complete Housing System for RedM

An advanced and complete housing system for RedM with multiple features, including usable furnitures, monthly payment system, custom crafting, and much more.

 📋 Main Features

 🔑 Core Housing System

- Door Locks: with Global State for perfect sync

- Key System: for friends/family

- Dynamic blips:  showing house status (available, owned, with key)

 🪑 Usable Furnitures System

- Safe: - Store money securely

- Chests:  - Various sizes, to store items

-  Stove:  Cook recipes

- Grill & Campfire:  For barbecue and cooking

- Bed: - Sleep and recover energy

- Paintings: - Admire art

-  Chairs/Sofas: - Sit and relax

-  Expandable system:  - Easily add new furnitures with examples

  💰 Monthly Payment System

Players must pay a monthly fee to the Government to keep their properties:

1. Phase 1 - Friendly Warning

- Well-dressed men appear on the property

- Stand still with a "Talk" prompt

- Explain the need for monthly payment

2. Phase 2 - Pressure

- Conversation changes tone after 1 month without payment

- Well-dressed men + armed men patrol the property

- Last chance to pay

3. Phase 3 - Enforcement

- No payment for a prolonged period

- Assets are removed from DB and map progressively

- Total loss of property after all assets are confiscated

🧹 Cleaning & Maintenance System

- Progressive dirt:  - House gets dirty over time and with use of stove, etc.

-  Cleaning tools:  - Requires item to clean house dirt

- * Realistic consequences* :

  - Rats spawn at high dirt levels

  - Loss of health and stamina in a dirty house

🔨 Furniture Crafting System

-  Custom UI:  for furniture crafting

- Easy Config:  - Easily configure what can be crafted

- Job locks:  - Crafting furniture requires a specific, configurable job

- Craftable furnitures:  - Customizable recipes in config.lua

🔨 Food Crafting System

- Stove:  for cooking food recipes

-  Grill/Campfire: for barbecue recipes

- **New Recipes** - Easily follow config examples to add more crafts

 🏪 Furniture Shop

-  Outdoor fair:  interactive shop

-  3D preview: of items before purchase

-  Configurable system:  to easily add new items

- Dynamic prices:  based on rarity, utility, and cents

💾 Data Persistence

- **MySQL Database** for storage

- **Furnitures persist** - furniture persists after server restart

- **Responsive spawn/despawn** for optimization

 🎮 Commands

- `/givekey [ID]` - Give house key to another player

- `/removekey [ID]` - Remove house key from a player

⚙️ Setup

### Dependencies

- **VORP Core** or **RSG Core**

- **MySQL** for database

- **Compatible inventory** (VORP/RSG)

 Installation

1. Extract the files to `resources/`

2. SQL is automatically installed

3. Configure `config.lua` as needed

4. Add `ensure dodi_housing` to your `server.cfg`

5. Restart the server

🛠️ Development

Adding New Furnitures

1. Add the configuration in `config.lua`

2. Implement the usage logic in `usable_actions.lua`

3. Set up animations and props as needed and follow the examples in `usable_actions.lua`

 🎨 UI Customization

The system has a custom UI in HTML/CSS/JS located in `/html/`.

To customize:

1. Edit `html/html.html` for structure

2. Modify CSS styles as needed

3. Implement JavaScript logic for interactions

 📊 Performance

- **Optimized** for servers with many players

- **LOD system** for distant furnitures

- **Smart cache** to reduce database queries

- **Efficient threads** with dynamic sleep

 🆘 Support

For technical support or questions:

- Check the configuration in `config.lua`

- Check server logs for errors

- Test in a development environment first

DEPENDENCIES: https://github.com/dodibanScripts/gizmo/tree/main

VIDEO:
https://youtu.be/DDF6kriEgVI

---

**Developed for RedM/VORP/RSG by Dodiban Scripts 🔥 🤠**

*A complete system that transforms the housing experience on your server!*

## Support

For support, bug reports, or feature requests, please open an issue ticket on Discord.

## Credits

Created by Dodiban Scripts

For RedM Framework

## License

This resource is protected under copyright law. Unauthorized distribution or modification is prohibited.