> For the complete documentation index, see [llms.txt](https://botiv.gitbook.io/rdr2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://botiv.gitbook.io/rdr2/reward-loyalty-and-total-playtime.md).

# Reward Loyalty and Total playtime

### 🟧 Server Side

#### 🔌 Export: Get Player Game Time

Retrieve a player’s total playtime (in minutes and hours) with this export:

```lua
local TimePlayed = exports.bt_primeco:getPlayerGameTime(source)
print("Minute : " .. TimePlayed.minute .. " Hour : " .. TimePlayed.hour)
```

* Returns a table:
  * `minute` : Total minutes played
  * `hour` : Total hours played

***

### ⚙️ Configuration Example (`config.lua`)

```lua
Config = {
    discord_webhook  = "",            -- Discord webhook URL
    discord_log_name = "BT_PRIMECO",  -- Discord log title
    MAX_CONNECT_TIME = 240,           -- Minutes before FINAL_REWARD (default 4h)
    REFRESH_TIME     = 60,            -- Refresh interval (seconds)
    CUSTOM_REWARD    = false,         -- Set to true to use your own CustomReward function
    REWARD_PER_HOUR  = { TYPE = 0, MIN = 1, MAX = 3 }, -- Hourly reward
    FINAL_REWARD     = { TYPE = 2, MIN = 1, MAX = 1 }, -- Final reward after MAX_CONNECT_TIME
    MONEY_NAME       = "$",
    GOLD_NAME        = "Gold",
    ROL_NAME         = "Diams",
    THANKS_MESSAGE   = "Thank you for you fidelity :)",
    REWARD_MESSAGE   = "Reward for %s hours played",
    CURRENCY_MSG     = "+ %s %s"
}
```

***

### 📝 Custom Rewards

Set `CUSTOM_REWARD = true` to handle rewards yourself with the `CustomReward(source, timeSinceLastReboot, totalPlayTime)` function.

**Example for VORP:**

```lua
if timeSinceLastReboot == 2 then -- 2 hours since last reboot
    Character.addCurrency(1, 20) -- Add 20 Gold
end
if totalPlayTime == 100 then     -- 100 total hours
    Character.addCurrency(0, 50) -- Add 50 $
end
```

**Example for RedEM:**

```lua
if timeSinceLastReboot == 2 then
    User.AddMoney(20) -- Add 20 $
end
if totalPlayTime == 100 then
    User.AddBankMoney(50) -- Add 50 $ to bank account
end
```

***

### 📌 Notes

* Discord logging is supported for playtime/reward events.
* Currency types and reward values are fully configurable.
* Use the export to display or automate in-game playtime rewards, milestones, or loyalty perks.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://botiv.gitbook.io/rdr2/reward-loyalty-and-total-playtime.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.