⏱️ Job Time Tracker

A powerful and fully automated job tracking system for FiveM servers. Track player work time in real-time, send Discord notifications, and generate detailed daily and weekly reports — all with minimal setup.

🚀 Features

• 👥 Multi-Framework Support Works seamlessly with both ESX and QBCore

• ⏱️ Real-Time Job Tracking Automatically detects when players start and stop working

• 📊 Discord Integration Sends join/leave notifications and detailed reports via webhooks

• 📈 Daily & Weekly Reports Automatic summaries of work time per player

• 🔄 State Persistence Continues tracking even after server/resource restarts

• 🌍 Multi-Language Support Built-in support for English and Slovenian

• 🔧 Highly Configurable Easily add jobs, customize webhooks, and adjust report times

• 🐛 Debug Mode Detailed logging for easy troubleshooting

• 🛡️ Network Resilience Handles disconnects and reconnects without data loss

⚙️ How It Works

The system automatically:

1. Detects when a player switches to a tracked job
2. Starts tracking their work session
3. Saves session duration to the database
4. Sends Discord webhook notifications
5. Generates scheduled daily & weekly reports

📊 Discord Webhooks

🔔 Join / Leave Notifications

Get notified when players start or stop working:

🟢 Started Work - Police
Player: JohnDoe
Work Time: 15 minutes 30 seconds

🔴 Ended Work - Police
Player: JohnDoe
Work Time: 1 hour 10 minutes

📅 Daily Report

📊 Daily Report - Police

Player | Time
JohnDoe | 2 hours 15 minutes
JaneDoe | 1 hour 40 minutes

📆 Weekly Report

📊 Weekly Report - Police

Player | Time
JohnDoe | 10 hours 25 minutes
JaneDoe | 8 hours 10 minutes

🔧 Configuration

Simple and flexible configuration:

• Choose your framework (ESX / QBCore)
• Add tracked jobs
• Set webhook URLs per job
• Customize report times
• Enable debug mode if needed

Example:

Config.Framework = 'esx'

Config.TrackedJobs = {
    police = "Police",
    ambulance = "EMS",
    mechanic = "Mechanic",
}

⚡ Setup

1. Add the resource to your server
2. Configure jobs in config.lua
3. Add Discord webhooks
4. Start the resource

refresh
start cfx_job_time_tracker

🧠 Smart Features

• ✔️ Prevents spam with minimum tracking time
• ✔️ Automatically restores tracking after restart
• ✔️ Handles player disconnects safely
• ✔️ Lightweight and optimized for performance

📌 Requirements

• ESX or QBCore framework
• oxmysql (or compatible database system)
• Discord webhooks

💬 Support

If you encounter any issues, enable debug mode and check console logs — most problems are configuration-related.

✅ Perfect For

• Roleplay servers
• Police / EMS / Job tracking
• Staff activity monitoring
• Economy balancing & analytics

🔥 Take control of your server’s job activity with accurate tracking and clean Discord reporting.