help

leaderboard roles

View server rankings with sorting and time filters

leaderboard users

profile

reminder compare @user

reminder register

Open interactive settings panel (interval, language, status preferences, quiet hours)

reminder settings

reminder start

View your stats, streak, and achievements

reminder status

reminder stop

setup channel

setup view

stats server

support

# 💧 HydroMate 💧
## Your Hydration Companion

Stay hydrated while you game, work, or chat on Discord. HydroMate helps you build a real hydration habit — with smart reminders that fit your schedule, not interrupt it.

## Why HydroMate?

- **Smart reminders** — Only notifies you when you're actually at your computer. Detects your Discord status automatically.
- **Easy to start** — Add the bot → click 'Get Started' → first reminder in under 2 minutes.
- **Fully customizable** — Set your own interval (1–4 hours), pick which statuses get reminders, set quiet hours for sleep.
- **More than water** — reminders include posture checks, eye breaks, and movement tips to keep you feeling good all day.
- **Streaks & achievements** — Build daily streaks, unlock 12 achievements, compete on server leaderboards.
- **7 languages** — English, Türkçe, Português (BR), Español, Русский, Deutsch, Français — auto-detected from your Discord settings.

## Features

### 💧 Smart Reminders
- Status-aware: online, idle, DND, or offline — you choose
- Custom intervals: 1–4 hours, whatever fits your day
- Quiet hours with timezone support — no 3 AM pings
- DM or channel delivery — your preference

### 🔥 Gamification
- Daily streaks with emoji tiers (🔥 → 💎)
- Streak freeze — miss a day without losing your streak. Life happens.
- 12 unlockable achievements
- Milestone celebrations at 7, 14, 30, 60, 100+ days

### 🏆 Social & Competitive
- Paginated leaderboards with time filters (Today / Week / Month / All Time)
- Sort by streak, completion rate, or total sips
- Role-based competition
- Head-to-head comparison with `/reminder compare`
- Server-wide hydration stats and score

### ⚙️ Easy Configuration
- Interactive settings panel — everything in one place
- Auto language detection from Discord locale
- Admin channel setup with `/setup channel`

## Quick Start

1. **Add HydroMate** to your server (auto-setup creates a channel for you)
2. Click **"Get Started"** in the welcome message (or `/reminder register`)
3. Your first reminder arrives within minutes
4. Click **"Hydrated!"** when you drink water — build your streak!

## Commands

**Everyone:**
- `/reminder register` — Sign up for reminders
- `/reminder start` / `stop` — Activate or pause reminders
- `/reminder status` — View your stats, streak, and achievements
- `/reminder settings` — Open interactive settings panel
- `/reminder compare @user` — Compare stats with a friend
- `/leaderboard users` — Server rankings with sorting and time filters
- `/leaderboard roles` — Role competition standings
- `/profile` — View detailed hydration profile
- `/stats server` — Server-wide statistics
- `/help` — Full command guide
- `/support` — Get help & join support server

**Admins:**
- `/setup channel #channel` — Set or change reminder channel
- `/setup view` — View current bot configuration

Ready to build the habit? Add **[HydroMate](https://discord.com/oauth2/authorize?client_id=1060477247699550218&permissions=277025737808&integration_type=0&scope=bot+applications.commands)** and drink your first glass today. 💧

## Need Help?

Join our [Support Server](https://discord.gg/sRUWQSNg44) — we're happy to help!

---

Made with 💙 by @okk_oguzkagan
Stay Hydrated, Stay Healthy 💪

HydroMate

HydroMate helps users stay hydrated and maintain healthy habits with automated reminders.

Voting for HydroMate

Do you want to support us?