# X_PlayTime

A FiveM resource that tracks and displays player playtime statistics.

## Features

- Track player playtime across sessions
- Display playtime statistics in a beautiful UI
- Show top players by playtime
- Command for players to check their playtime
- Admin commands to manage playtime data
- Multi-language support

## Installation

1. Download the resource
2. Extract it to your server's resources folder
3. Add `ensure X_PlayTime` to your server.cfg
4. Restart your server

## Configuration

Edit the `configuration/config.lua` file to customize:

- Command names
- Command cooldowns
- Notification system
- Default language
- Admin permissions

## Commands

- `/playtime` - Shows your current playtime
- `/playtimetop` - Shows the top players by playtime
- `/playtimeui` - Opens the playtime UI

### Admin Commands

- `/playtimecheck [playerId]` - Check a player's playtime
- `/playtimeset [playerId] [minutes]` - Set a player's playtime
- `/playtimeadd [playerId] [minutes]` - Add minutes to a player's playtime
- `/playtimeremove [playerId] [minutes]` - Remove minutes from a player's playtime
- `/playtimereset [playerId]` - Reset a player's playtime

## Exports

### Client Exports

```lua
-- Get local player's playtime in minutes
exports.X_PlayTime:GetLocalPlaytime()

-- Get local player's formatted playtime string
exports.X_PlayTime:GetLocalFormattedPlaytime()

-- Open the playtime UI
exports.X_PlayTime:OpenPlaytimeUI()
```

### Server Exports

```lua
-- Get a player's playtime in minutes
exports.X_PlayTime:GetPlayerPlaytime(source)

-- Get a player's formatted playtime string
exports.X_PlayTime:GetPlayerFormattedPlaytime(source)

-- Set a player's playtime
exports.X_PlayTime:SetPlayerPlaytime(source, minutes)

-- Add minutes to a player's playtime
exports.X_PlayTime:AddPlayerPlaytime(source, minutes)

-- Reset a player's playtime
exports.X_PlayTime:ResetPlayerPlaytime(source)
```

## Support

For support, please open an issue on our GitHub repository or contact us on Discord. 