# GOD - ATM Owner

### Overview

Transform your FiveM server's economy with a fully interactive ATM ownership system! 💰🏦

> **GOD -** ATM Owner script is a comprehensive ATM management solution designed for FiveM servers, providing realistic ATM ownership mechanics, tax collection, employee management, and revenue tracking for immersive roleplay experiences.

***

### Key Features

#### 🏦 ATM Ownership System

* **Purchase ATMs**: Buy available ATMs across the map to become an owner
* **Ownership Limits**: Configurable maximum ATMs per player (default: 2)
* **Rent System**: Pay rent every 15 days to maintain ownership
* **Auto-Reclaim**: Expired ATMs (10+ days overdue) are automatically reclaimed
* **Transfer Ownership**: Transfer your ATMs to other players

#### 💰 Revenue & Tax System

* **Tax Collection**: Set custom tax rates (0-39% based on owner level)
* **Automatic Tax Detection**: Auto-detects bank transactions near ATMs
* **Revenue Tracking**: Real-time revenue tracking with detailed statistics
* **Revenue Withdrawal**: Withdraw accumulated revenue as cash or bank deposit
* **Transaction Logs**: Complete transaction history with filtering

#### 👥 Employee Management

* **Hire Employees**: Invite players to manage your ATMs
* **Permission System**: Granular permissions (manage, withdraw, tax, logs, employees)
* **Level-Based Access**: Different permission levels for different roles
* **Employee Tracking**: View employee activity and earnings

#### 📊 Level & Progression System

* **XP-Based Levels**: Gain XP from ATM ownership, transactions, and revenue
* **Level Benefits**: Higher levels unlock higher tax rate limits
* **Progress Tracking**: Visual progress bar showing level advancement
* **15 Levels**: From Level 1 (0-10% tax) to Level 15+ (0-39% tax)

#### 🗺️ Map Integration

*

#### 🎨 Modern UI

* **Beautiful Interface**: Modern, responsive web-based UI
* **Real-Time Updates**: Live data synchronization
* **Filtering & Search**: Advanced filtering by location, price, status
* **Charts & Analytics**: Revenue charts with daily/weekly statistics

#### ⚡ Performance Optimized

* **Chunked Streaming**: Efficient coordinate synchronization using latent events
* **Queue System**: Prevents network overflow on server restart
* **Optimized Queries**: Efficient database queries with proper indexing
* **0.00ms resmon usage** - Zero impact on server performance

***

### Framework Compatibility

* <mark style="color:$danger;">**QBCore**</mark> - Full support with native integration
* <mark style="color:$warning;">**ESX**</mark> - Complete compatibility with es\_extended
* <mark style="color:green;">**Qbox**</mark> - Full support for qbox\_core framework

***

### Requirements

* <mark style="color:$success;">**ox\_lib**</mark> - Required dependency for progress bars, notifications, and UI components
* <mark style="color:purple;">**ic3d\_lib**</mark> - Required dependency for framework abstraction
* <mark style="color:blue;">**oxmysql**</mark> - Required dependency for database operations
* FiveM server with one of the supported frameworks
* MySQL database

***

### Use Cases

* **Business Ownership**: Players can own and manage multiple ATMs as a business
* **Passive Income**: Generate revenue from ATM transactions
* **Economic Roleplay**: Create realistic economic scenarios with tax systems
* **Employee Management**: Hire and manage employees for your ATM business
* **Competitive Gameplay**: Level up to unlock higher tax rates and more features

***

### Technical Details

* **Language**: Lua 5.4
* **Game**: GTA V (FiveM)
* **Resource Type**: Client & Server Script
* **Network Synchronization**: Full server-client sync with chunked streaming
* **Database**: MySQL with optimized queries and proper indexing
* **UI Framework**: Custom HTML/CSS/JavaScript with real-time updates

***

**Get ready to revolutionize your server's economy with a system designed for realism, engagement, and high-stakes business management!** 🚀💰