# README

> **New Haven Gaming Bot** is a fully custom Discord bot built exclusively for the New Haven Gaming server. It covers economy, pets, fun, moderation, and automatic server tracking — all in one place.

***

## Ping Roles

The server has three opt-in ping roles. You can toggle each one yourself by clicking the button on any relevant post — no need to ask a mod.

| Role              | What it's for                                | How to get it                                        |
| ----------------- | -------------------------------------------- | ---------------------------------------------------- |
| **Updates**       | Server updates, rule changes, important news | Click 🔔 Get Update Pings on any update post         |
| **Announcements** | General announcements and events             | Click 🔔 Get Announcement Pings on any announcement  |
| **Bot Updates**   | New bot features, changes, and fixes         | Click 🔔 Get Bot Update Pings on any bot update post |

Clicking the button again removes the role. It works as a toggle — you're always in control.

***

## Economy System

The economy system revolves around a server coin currency. Here's how it works at a high level.

### Earning Coins

There are several reliable ways to earn coins every day:

* **`/daily`** — Your main income source. Claim every 24 hours. Maintaining a streak rewards bonus coins — the longer you keep it going, the more you earn.
* **`/weekly`** — A larger payout once a week.
* **`/monthly`** — The biggest passive reward, claimable once a month.
* **`/work`** — Work a shift for a steady payout with a short cooldown.
* **`/beg`** — Small random amount, no cooldown.
* **`/crime`** — Higher risk, higher reward. You can lose coins if caught.

### Gathering & Selling

Three gathering activities produce items you can sell:

* **`/fish`** — Catches fish of varying rarity (Common, Rare, Legendary, etc.)
* **`/hunt`** — Hunts animals in the woods
* **`/mine`** — Mines ores and gems

Once you have items, sell them with `/sell <item>` or dump everything at once with `/sellall`. Items sit in your `/inventory` until you sell them.

### Gambling & Games

Several commands let you wager coins for a chance at bigger rewards:

| Command      | Risk level                                 |
| ------------ | ------------------------------------------ |
| `/cointoss`  | 50/50                                      |
| `/gamble`    | Random multiplier                          |
| `/highlow`   | Low risk, jackpot on exact match           |
| `/slots`     | Slot machine odds                          |
| `/blackjack` | Skill-based card game                      |
| `/cockfight` | 50/50 or challenge a member                |
| `/horse`     | Pick a horse, higher odds = bigger payout  |
| `/bankrob`   | Multiplayer heist — crew shares the reward |
| `/poker`     | Multiplayer Texas Hold'em                  |

### Spending Coins

* **`/shop`** — Browse what's available to buy on the server
* **`/buy <item>`** — Purchase an item; it goes into your `/inventory`
* **`/give <user> <amount>`** — Send coins directly to another member
* **`/giveitem <user> <item>`** — Give an inventory item to someone

### Checking Your Balance

* **`/balance`** — Your current coin count
* **`/leaderboard`** — See where you rank on the server

***

## Pet System

You can adopt one companion pet at a time. Pets have stats that change based on how well you care for them.

### Adopting a Pet

Browse available pets with `/pet shop` and adopt one with `/pet adopt`. Each pet costs a set number of coins.

### Caring for Your Pet

* **`/pet feed`** — Keep your pet's hunger up. Available every **4 hours**.
* **`/pet play`** — Boost your pet's happiness. Available every **6 hours**.

Neglecting your pet will lower its mood over time. Check its current state anytime with `/pet status`.

### Other Actions

* **`/pet name <name>`** — Give your pet a custom name
* **`/pet release`** — Release your pet for a partial coin refund

***

## Tracking Systems

The bot automatically tracks several stats for every member — no setup needed.

### Voice Time

Time spent in voice channels is tracked in the background. Accumulating enough VC time earns you voice levels. Check your stats with `/voicetime check` and see the top members with `/voicetime leaderboard`.

### Message Count

Every message you send in the server is counted. View your total with `/messages check` and compare with the server with `/messages leaderboard`.

### Invites

When a new member joins using your invite link, you get credit. See your invite count with `/invites check` and the top inviters with `/invites leaderboard`.

### Reputation

Once per day you can give a reputation point to any member with `/rep give <user>`. Check anyone's rep score with `/rep check`. Rep is a way to recognise helpful or positive members.

### Profile

`/profile [user]` pulls all tracking stats together into one embed — coins, rep, VC time, voice level, messages sent, and invite count — for a full picture of any member's activity on the server.

***

## Starboard

When a message receives enough ⭐ reactions, it gets automatically reposted in the starboard channel. The star threshold and target channel are configured by staff using `/starboard set`.


---

# 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://newhavendiscord.gitbook.io/new-haven-gaming-bot/readme.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.