⚙️ Advanced Discord Voice Channel Queue Bot

A production-grade Discord bot built for developers who need a fully synchronized voice channel queue.
It assigns numbered positions in real-time, updates instantly on join/leave, restores original nicknames, and persists data to survive restarts.
Designed to handle race conditions, Discord event delays, and permission limitations — without breaking sync. 🔄

---

✨ Features

• 🏎️ Real-time numbering – Assigns queue positions the moment someone joins the configured voice channel.
• 🔄 Automatic renumbering – Updates instantly when members join or leave.
• ♻️ Original nickname restore – Brings back exact nicknames upon leaving.
• 💾 Persistent storage – Saves queue state and nicknames in queue_data.json and reloads on startup.
• 🛡️ Per-guild locking – Prevents race conditions during simultaneous events.
• ⚡ Robust event handling – Handles Discord API lag or out-of-order events without losing sync.
• 🚫 No duplicate numbers – Nicknames always built from stored originals.
• 🎯 Permission fallback – Tracks queue even without nickname permissions.

---

📦 Installation

1️⃣ Requirements

• Node.js v18+
• A Discord bot with the following:
  • Manage Nicknames
  • View Channels
  • Connect
  • Guild Members Intent enabled in the Developer Portal