Number Guess

## 📸 Screenshots



Number Guess

---

Number Guess is a daily number guessing game for Discord. Players guess a hidden number with higher/lower hints, compete on leaderboards, and earn gift code rewards. Configure everything through the web dashboard at https://008870.xyz — no slash commands required for gameplay.

---

## ⚙️ How to Set Up

Step 1 — Invite the bot
Add Number Guess to your server and grant the following permissions in your Game Channel(s): View Channel, Send Messages, Embed Links, Read Message History, Manage Messages, Add Reactions, Manage Channel, Manage Permissions.

Step 2 — Open the Dashboard
Visit 008870.xyz and log in with Discord. Select your server to open the configuration panel.

Step 3 — Configure Game Channels
Under Game Channels, select the channel(s) where the game will run. Set your Admin Notification Channel to receive alerts and system messages.

Step 4 — Set Admin & Mention Roles
Configure Admin Role for permission management and Mention Roles for reward and alert notifications. You can include @everyone if desired.

Step 5 — Configure Difficulty & Rewards
Set the Game Difficulty (number of digits), Reward Cooldown (days between reward claims), and Alert Threshold for low reward code stock warnings.

Step 6 — Upload Reward Codes & Save
Upload gift codes under the Reward System section, then click Save Configuration. The bot starts the game immediately.

---

## 🤖 How It Works (Automatic)

Once configured, Number Guess runs on its own:

- Players type numbers in the game channel to guess the hidden number
- Bot replies instantly with Higher / Lower hints
- Round ends when someone guesses correctly — points are awarded automatically
- New round starts immediately with a fresh hidden number
- Reward claimed when a player reaches the score threshold for the cycle
- Vote Mode — players vote on difficulty before each round (PRO)
- Leaderboards update in real time — weekly, monthly, and global rankings

---

## ✨ Features

- ✅ Fully automatic — players just type numbers to play
- ✅ Configurable difficulty (2–8 digit numbers)
- ✅ Gift code reward system with cooldown control
- ✅ Weekly, monthly, and global leaderboards
- ✅ Vote Mode — players vote on next round difficulty (PRO)
- ✅ Automatic cycle reminders to keep players engaged
- ✅ Low stock alerts sent to admin channel
- ✅ Country flag display on leaderboards
- ✅ Web dashboard — no commands needed for setup

---

## 📋 Plans

| Feature | FREE | BASIC | PRO |
|---|---|---|---|
| Game Channels | 1 | 3 | 5 |
| Reward Code Storage | 50 | 200 | Unlimited |
| Reward Cooldown | 15 days | 1–30 days | 1–30 days |
| Max Difficulty | 8 digits | 8 digits | 8 digits |
| Daily Win Quota | 50 | 200 | Unlimited |
| Vote Mode | ❌ | ❌ | ✅ |
| Custom Reminders | ❌ | ✅ | ✅ |

Upgrade at https://008870.xyz.