discord-live-bot-status-advanced/README.md

Advanced real-time Discord bot status tracker with embed dashboard and pagination

# 🟢 LiveBotStatus — Real-Time Discord Bot Monitoring

**LiveBotStatus** is a plug-and-play module to track and display **real-time status** of your own Discord bot (uptime, ping, status, guild/user count, etc.) using a beautiful embed sent to a channel of your choice.

> ✅ Self-contained. No external dashboard needed.  
> ✅ Fully real-time & auto-updating every 15 seconds.  
> ✅ Includes manual `/refreshbotstatus` command.

---

## 📦 Installation

```bash
npm i discord-live-bot-status-advanced
```

---

## 🚀 Usage

In your bot's entry file (e.g., `index.js`):

```js
  const LiveBotStatus = require('discord-live-bot-status-advanced');

  const token = process.env.DISCORD_TOKEN;
  const channelId = process.env.DISCORD_CHANNEL_ID;

 LiveBotStatus({ token, channelId });
```

---

## 📊 Live Embed Preview

Once your bot goes online, it will post an embed like:

```
🤖 Live Bot Status Dashboard

🟢 YourBotName
Status: online
Servers: 34
Users: 8,432
Ping: 42ms
Uptime: 2d 3h 15m 12s
Commands: 0
Last Updated: 10 June 2025, 6:30 PM
```

The embed automatically refreshes every **15 seconds**.

---

## 🛠 Features

| Feature              | Description                                     |
|----------------------|-------------------------------------------------|
| 🔁 Auto Refresh       | Embed updates every 15 seconds with live data   |
| 💬 Slash Command      | Use `/refreshbotstatus` to manually update      |
| 📶 Ping               | Live WebSocket ping of your bot                 |
| 📡 Status             | Online, idle, dnd, offline                      |
| 🕒 Uptime             | Automatically tracks bot uptime                 |
| 👥 Guild & User Count | Live stats from your bot's guilds and users     |
| 🧠 Command Count      | (Optional) You can update this manually later   |

---

## 🧩 Slash Commands Setup

This module automatically registers the `/refreshbotstatus` command.

> No additional setup required.

---

## 🧪 Development Notes

- Built with [discord.js v14](https://discord.js.org).
- Works perfectly in Pterodactyl, Render, Railway, VPS, or even local.
- Supports 100% uptime environments.

---

## 🤝 Discord Server Join

**Join: For support, discussions, or to stay updated, join our** [Discord Server](https://discord.gg/GwQrc2rDyg).
---

## ❓ FAQ

**Q: Will this track other bots in my server?**  
A: No. This module is designed to **track only the bot that installs it**, ensuring data privacy and reliability.

**Q: Can I track multiple bots?**  
A: This version is single-bot only by design. Multi-bot dashboard support may come in a future version.

**Q: Can I customize the embed?**  
A: Absolutely! Fork the module and adjust the `_createEmbed()` method for your style.

**Q: Who Made This Package?**  
A: This package was created by HJGaming (also known as Arbotix Codez).
If you use this code or package in any form, you must give proper credit to the original creator.
Failure to do so may result in copyright claims or takedown notices. Respect open-source contributions!.

---

## 💡 To-Do / Ideas

- [ ] Web dashboard (optional)
- [ ] Historical data/logs
- [ ] Bot restart detection
- [ ] Command tracking API

---

## 📄 License

MIT License © 2025