# 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!** 🚀💰


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://god-studios.gitbook.io/god-studios/god-atm-owner.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.