@tryty/easydc-js 1.1.0 → 1.2.2

package/src/plugins/voice.js

@@ -0,0 +1,1030 @@
+'use strict';
+
+const { BotError } = require('../errors');
+
+const has = (v) => v !== undefined && v !== null && String(v).trim() !== '';
+
+function truthy(v) {
+  if (typeof v === 'boolean') return v;
+  const s = String(v ?? '').trim().toLowerCase();
+  return ['true', 'yes', '1', 'on', 'ya'].includes(s);
+}
+
+function formatDuration(ms) {
+  if (!ms || !Number.isFinite(ms) || ms <= 0) return '00:00';
+  const totalSeconds = Math.floor(ms / 1000);
+  const hours = Math.floor(totalSeconds / 3600);
+  const minutes = Math.floor((totalSeconds % 3600) / 60);
+  const seconds = totalSeconds % 60;
+  const pad = (n) => String(n).padStart(2, '0');
+  if (hours > 0) return `${hours}:${pad(minutes)}:${pad(seconds)}`;
+  return `${pad(minutes)}:${pad(seconds)}`;
+}
+
+function parseDurationMs(str) {
+  if (!str) return 0;
+  const s = String(str).trim();
+  if (s.includes(':')) {
+    const parts = s.split(':').map((p) => parseInt(p, 10) || 0);
+    if (parts.length === 2) return (parts[0] * 60 + parts[1]) * 1000;
+    if (parts.length === 3) return (parts[0] * 3600 + parts[1] * 60 + parts[2]) * 1000;
+  }
+  const sec = parseFloat(s.replace(/s$/i, ''));
+  if (Number.isFinite(sec)) return Math.floor(sec * 1000);
+  return 0;
+}
+
+function formatTrack(raw, requester = '') {
+  if (!raw) return null;
+  const info = raw.info ?? {};
+  return {
+    encoded: raw.encoded ?? raw.track ?? '',
+    title: info.title ?? 'Tidak diketahui',
+    author: info.author ?? 'Tidak diketahui',
+    length: Number(info.length ?? info.duration ?? 0),
+    identifier: info.identifier ?? '',
+    isSeekable: Boolean(info.isSeekable),
+    isStream: Boolean(info.isStream),
+    uri: info.uri ?? '',
+    artworkUrl: info.artworkUrl ?? null,
+    requester,
+  };
+}
+
+function extractResult(res, requester = '') {
+  if (!res) return { type: 'empty', tracks: [] };
+  // Lavalink v4
+  if (res.loadType === 'track') {
+    return { type: 'track', tracks: [formatTrack(res.data, requester)].filter(Boolean) };
+  }
+  if (res.loadType === 'playlist') {
+    const list = (res.data?.tracks ?? []).map((t) => formatTrack(t, requester)).filter(Boolean);
+    return { type: 'playlist', name: res.data?.info?.name ?? 'Playlist', tracks: list };
+  }
+  if (res.loadType === 'search') {
+    const list = (Array.isArray(res.data) ? res.data : []).map((t) => formatTrack(t, requester)).filter(Boolean);
+    return { type: 'search', tracks: list };
+  }
+  if (res.loadType === 'empty') {
+    return { type: 'empty', tracks: [] };
+  }
+  // Lavalink v3
+  if (res.loadType === 'TRACK_LOADED') {
+    return { type: 'track', tracks: [formatTrack(res.tracks?.[0], requester)].filter(Boolean) };
+  }
+  if (res.loadType === 'PLAYLIST_LOADED') {
+    const list = (res.tracks ?? []).map((t) => formatTrack(t, requester)).filter(Boolean);
+    return { type: 'playlist', name: res.playlistInfo?.name ?? 'Playlist', tracks: list };
+  }
+  if (res.loadType === 'SEARCH_RESULT') {
+    const list = (res.tracks ?? []).map((t) => formatTrack(t, requester)).filter(Boolean);
+    return { type: 'search', tracks: list };
+  }
+  return { type: 'empty', tracks: [] };
+}
+
+/**
+ * Antrean musik per server (guild)
+ */
+class GuildQueue {
+  constructor(guildId, manager) {
+    this.guildId = guildId;
+    this.manager = manager;
+    this.player = null;
+    this.tracks = [];
+    this.current = null;
+    this.loop = 'off'; // 'off' | 'track' | 'queue'
+    this.volume = 100;
+    this.paused = false;
+  }
+
+  get isPlaying() {
+    return Boolean(this.current);
+  }
+
+  async play() {
+    if (!this.player) return;
+    if (!this.current) {
+      this.current = this.tracks.shift() ?? null;
+    }
+    if (!this.current) return;
+
+    try {
+      const trackData = this.current.encoded;
+      await this.player.playTrack({ track: { encoded: trackData } });
+      this.paused = false;
+    } catch (e) {
+      console.error(`[easydc-voice] Gagal memutar lagu: ${e.message}`);
+      this.current = null;
+      if (this.tracks.length > 0) {
+        await this.play();
+      }
+    }
+  }
+
+  async skip() {
+    if (!this.player || !this.current) return null;
+    const skipped = this.current;
+    if (this.loop === 'track') this.loop = 'off';
+    await this.player.stopTrack();
+    return skipped;
+  }
+
+  async stop() {
+    this.tracks = [];
+    this.current = null;
+    this.loop = 'off';
+    this.paused = false;
+    if (this.player) {
+      try {
+        await this.player.stopTrack();
+      } catch { /* abaikan jika sudah berhenti */ }
+    }
+  }
+
+  destroy() {
+    this.tracks = [];
+    this.current = null;
+    this.player = null;
+  }
+}
+
+/**
+ * Voice & Music Manager
+ */
+class VoiceManager {
+  constructor(bot, options = {}) {
+    this.bot = bot;
+    this.options = {
+      nodes: options.nodes ?? [],
+      defaultSearchEngine: options.defaultSearchEngine ?? 'ytsearch',
+      shoukakuOptions: options.shoukakuOptions ?? {},
+      driver: options.driver ?? null,
+      ...options,
+    };
+    this.shoukaku = null;
+    this.queues = new Map();
+  }
+
+  _loadDriver() {
+    if (this.options.driver) return this.options.driver;
+    try {
+      // eslint-disable-next-line global-require
+      return require('shoukaku');
+    } catch (e) {
+      throw new BotError('Package "shoukaku" tidak ditemukan. Jalankan: npm install shoukaku', { cause: e });
+    }
+  }
+
+  initShoukaku(client) {
+    if (this.shoukaku || !this.options.nodes.length) return;
+    const { Shoukaku, Connectors } = this._loadDriver();
+    this.shoukaku = new Shoukaku(
+      new Connectors.DiscordJS(client),
+      this.options.nodes,
+      this.options.shoukakuOptions,
+    );
+
+    this.shoukaku.on('ready', (name) => {
+      console.log(`[easydc-voice] Node Lavalink "${name}" terhubung dan siap.`);
+    });
+    this.shoukaku.on('error', (name, error) => {
+      console.error(`[easydc-voice] Node Lavalink "${name}" error: ${error?.message ?? error}`);
+    });
+    this.shoukaku.on('close', (name, code, reason) => {
+      console.warn(`[easydc-voice] Node Lavalink "${name}" terputus (${code}): ${reason}`);
+    });
+
+    client.on('voiceStateUpdate', (oldS, newS) => {
+      if (newS.member?.id === client.user?.id && !newS.channelId) {
+        const q = this.queues.get(newS.guild.id);
+        if (q) {
+          q.destroy();
+          this.queues.delete(newS.guild.id);
+        }
+      }
+    });
+  }
+
+  getQueue(guildId) {
+    let queue = this.queues.get(guildId);
+    if (!queue) {
+      queue = new GuildQueue(guildId, this);
+      this.queues.set(guildId, queue);
+    }
+    return queue;
+  }
+
+  bindPlayerEvents(queue, player) {
+    player.on('end', async (data) => {
+      const reason = data?.reason ?? data;
+      if (reason === 'replaced') return;
+
+      if (queue.loop === 'track' && queue.current && reason === 'finished') {
+        await queue.play();
+        return;
+      }
+      if (queue.loop === 'queue' && queue.current && reason === 'finished') {
+        queue.tracks.push(queue.current);
+      }
+
+      queue.current = null;
+      if (queue.tracks.length > 0) {
+        await queue.play();
+      }
+    });
+
+    player.on('exception', (err) => {
+      console.error(`[easydc-voice] Exception pada player: ${err?.message ?? err}`);
+      queue.current = null;
+      if (queue.tracks.length > 0) queue.play().catch(() => {});
+    });
+
+    player.on('closed', () => {
+      queue.destroy();
+      this.queues.delete(queue.guildId);
+    });
+  }
+
+  async joinVoice(guild, channelId) {
+    if (this.shoukaku && this.options.nodes.length) {
+      const player = await this.shoukaku.joinVoiceChannel({
+        guildId: guild.id,
+        channelId,
+        shardId: guild.shardId ?? guild.shard?.id ?? 0,
+        deaf: true,
+      });
+      const queue = this.getQueue(guild.id);
+      queue.player = player;
+      this.bindPlayerEvents(queue, player);
+      return player;
+    }
+
+    // Opsi C: Tanpa Lavalink, kirim Opcode 4 langsung
+    if (guild.shard) {
+      guild.shard.send({
+        op: 4,
+        d: {
+          guild_id: guild.id,
+          channel_id: channelId,
+          self_mute: false,
+          self_deaf: true,
+        },
+      });
+    }
+    return null;
+  }
+
+  async leaveVoice(guild) {
+    const queue = this.queues.get(guild.id);
+    if (queue) {
+      await queue.stop();
+      queue.destroy();
+      this.queues.delete(guild.id);
+    }
+    if (this.shoukaku && this.options.nodes.length) {
+      try {
+        await this.shoukaku.leaveVoiceChannel(guild.id);
+      } catch { /* abaikan */ }
+      return;
+    }
+    if (guild.shard) {
+      guild.shard.send({
+        op: 4,
+        d: {
+          guild_id: guild.id,
+          channel_id: null,
+          self_mute: false,
+          self_deaf: false,
+        },
+      });
+    }
+  }
+
+  hookBot() {
+    const self = this;
+
+    const origBind = this.bot._bind;
+    this.bot._bind = function (client, discord) {
+      origBind.call(this, client, discord);
+      if (self.options.nodes.length > 0) {
+        self.initShoukaku(client);
+      }
+    };
+
+    const origDestroy = this.bot.destroy;
+    this.bot.destroy = async function () {
+      await self.destroy();
+      return origDestroy.call(this);
+    };
+  }
+
+  async destroy() {
+    for (const queue of this.queues.values()) {
+      queue.destroy();
+    }
+    this.queues.clear();
+  }
+
+  installFunctions() {
+    const bot = this.bot;
+    const manager = this;
+
+    const resolveGuild = (ctx, guildId) => {
+      if (has(guildId)) {
+        const g = bot.client?.guilds?.cache?.get(String(guildId).trim());
+        if (g) return g;
+      }
+      if (ctx.guild) return ctx.guild;
+      throw new BotError('Perintah ini hanya bisa dipakai di dalam server');
+    };
+
+    const register = (spec) => {
+      bot.addFunction(spec);
+      const raw = String(spec.name).replace(/^\$/, '').toLowerCase();
+      const def = bot.registry.get(raw);
+      if (def) def.category = 'Voice';
+    };
+
+    // =========================================================================
+    // 1. KONEKSI VOICE DASAR (Opsi C)
+    // =========================================================================
+
+    register({
+      name: '$joinVC',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[channelID?]',
+      description: 'Bergabung ke voice channel (default: channel pengirim)',
+      run: async (ctx, [channelId]) => {
+        const guild = resolveGuild(ctx);
+        const targetId = has(channelId) ? String(channelId).trim() : ctx.member?.voice?.channelId;
+        if (!targetId) {
+          throw new BotError('Kamu harus berada di voice channel atau masukkan ID voice channel tujuan');
+        }
+        await manager.joinVoice(guild, targetId);
+        return '';
+      },
+    });
+
+    register({
+      name: '$leaveVC',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Keluar dari voice channel',
+      run: async (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        await manager.leaveVoice(guild);
+        return '';
+      },
+    });
+
+    register({
+      name: '$isVoiceConnected',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'true/false: apakah bot sedang terhubung ke voice channel',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        return String(Boolean(guild.members?.me?.voice?.channelId));
+      },
+    });
+
+    register({
+      name: '$voiceChannelID',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'ID voice channel tempat bot berada saat ini',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        return guild.members?.me?.voice?.channelId ?? '';
+      },
+    });
+
+    register({
+      name: '$voiceDeaf',
+      brackets: 'optional',
+      min: 0,
+      max: 2,
+      signature: '[deaf?;guildID?]',
+      description: 'Atur (true/false) atau baca status deafen bot di voice channel',
+      run: async (ctx, [deaf, guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const me = guild.members?.me;
+        if (!me?.voice?.channelId) throw new BotError('Bot tidak sedang berada di voice channel');
+        if (has(deaf)) {
+          const val = truthy(deaf);
+          await me.voice.setDeaf(val);
+          return String(val);
+        }
+        return String(Boolean(me.voice.deaf));
+      },
+    });
+
+    register({
+      name: '$voiceMute',
+      brackets: 'optional',
+      min: 0,
+      max: 2,
+      signature: '[mute?;guildID?]',
+      description: 'Atur (true/false) atau baca status mute bot di voice channel',
+      run: async (ctx, [mute, guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const me = guild.members?.me;
+        if (!me?.voice?.channelId) throw new BotError('Bot tidak sedang berada di voice channel');
+        if (has(mute)) {
+          const val = truthy(mute);
+          await me.voice.setMute(val);
+          return String(val);
+        }
+        return String(Boolean(me.voice.mute));
+      },
+    });
+
+    // =========================================================================
+    // 2. PEMUTARAN & KONTROL MUSIK (Opsi B)
+    // =========================================================================
+
+    register({
+      name: '$play',
+      brackets: 'required',
+      min: 1,
+      max: 2,
+      signature: '[query;source?]',
+      description: 'Putar lagu atau tambah ke antrean lewat Lavalink',
+      run: async (ctx, [query, source]) => {
+        const guild = resolveGuild(ctx);
+        if (!manager.shoukaku || !manager.options.nodes.length) {
+          throw new BotError('Fitur musik membutuhkan server Lavalink. Konfigurasikan opsi "nodes" di voice({ nodes: [...] })');
+        }
+
+        const botVC = guild.members?.me?.voice?.channelId;
+        const userVC = ctx.member?.voice?.channelId;
+        if (!botVC && !userVC) {
+          throw new BotError('Kamu harus berada di voice channel terlebih dahulu');
+        }
+        const targetVC = botVC || userVC;
+
+        const queue = manager.getQueue(guild.id);
+        if (!queue.player || !botVC) {
+          await manager.joinVoice(guild, targetVC);
+        }
+
+        const node = manager.shoukaku.getIdealNode();
+        if (!node) throw new BotError('Tidak ada server Lavalink yang terhubung');
+
+        const requester = ctx.user?.username ?? ctx.user?.tag ?? 'Seseorang';
+        const isUrl = /^https?:\/\//i.test(query.trim());
+        const searchEngine = has(source) ? source.trim() : manager.options.defaultSearchEngine;
+        const identifier = isUrl ? query.trim() : `${searchEngine}:${query.trim()}`;
+
+        const res = await node.rest.resolve(identifier);
+        const result = extractResult(res, requester);
+
+        if (!result.tracks.length) {
+          throw new BotError(`Tidak ada lagu yang ditemukan untuk "${query.trim()}"`);
+        }
+
+        if (result.type === 'playlist') {
+          queue.tracks.push(...result.tracks);
+          if (!queue.isPlaying) await queue.play();
+          return `${result.tracks.length} lagu dari ${result.name}`;
+        }
+
+        const track = result.tracks[0];
+        queue.tracks.push(track);
+        if (!queue.isPlaying) {
+          await queue.play();
+        }
+        return track.title;
+      },
+    });
+
+    register({
+      name: '$pause',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Jeda pemutaran musik',
+      run: async (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        if (!queue?.player || !queue.isPlaying) return '';
+        if (!queue.paused) {
+          await queue.player.setPaused(true);
+          queue.paused = true;
+        }
+        return 'true';
+      },
+    });
+
+    register({
+      name: '$resume',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Lanjutkan pemutaran musik yang dijeda',
+      run: async (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        if (!queue?.player || !queue.isPlaying) return '';
+        if (queue.paused) {
+          await queue.player.setPaused(false);
+          queue.paused = false;
+        }
+        return 'true';
+      },
+    });
+
+    register({
+      name: '$stopMusic',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Hentikan musik dan kosongkan antrean',
+      run: async (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        if (queue) await queue.stop();
+        return '';
+      },
+    });
+
+    register({
+      name: '$skip',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Lewati lagu yang sedang diputar',
+      run: async (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        if (!queue?.isPlaying) return '';
+        const skipped = await queue.skip();
+        return skipped?.title ?? '';
+      },
+    });
+
+    register({
+      name: '$seek',
+      brackets: 'required',
+      min: 1,
+      max: 2,
+      signature: '[posisi;guildID?]',
+      description: 'Lompat ke posisi tertentu (contoh: 1:30 atau 90)',
+      run: async (ctx, [posStr, guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        if (!queue?.player || !queue.current) {
+          throw new BotError('Tidak ada lagu yang sedang diputar');
+        }
+        if (!queue.current.isSeekable) {
+          throw new BotError('Lagu ini tidak mendukung fitur seek (siaran langsung / stream)');
+        }
+        const ms = parseDurationMs(posStr);
+        const target = Math.max(0, Math.min(ms, queue.current.length));
+        await queue.player.seekTo(target);
+        return formatDuration(target);
+      },
+    });
+
+    register({
+      name: '$volume',
+      brackets: 'optional',
+      min: 0,
+      max: 2,
+      signature: '[angka?;guildID?]',
+      description: 'Atur (0-150) atau lihat volume pemutar musik',
+      run: async (ctx, [volStr, guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        if (!queue) return '100';
+
+        if (has(volStr)) {
+          const v = Math.max(0, Math.min(150, parseInt(volStr, 10) || 100));
+          queue.volume = v;
+          if (queue.player) {
+            if (typeof queue.player.setGlobalVolume === 'function') {
+              await queue.player.setGlobalVolume(v);
+            } else if (typeof queue.player.setVolume === 'function') {
+              await queue.player.setVolume(v);
+            }
+          }
+          return String(v);
+        }
+        return String(queue.volume);
+      },
+    });
+
+    register({
+      name: '$loop',
+      brackets: 'optional',
+      min: 0,
+      max: 2,
+      signature: '[mode?;guildID?]',
+      description: 'Atur perulangan: off, track, queue',
+      run: (ctx, [mode, guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        if (!queue) return 'off';
+
+        if (has(mode)) {
+          const m = mode.trim().toLowerCase();
+          if (['off', 'none', 'false', '0'].includes(m)) queue.loop = 'off';
+          else if (['track', 'song', 'single', '1'].includes(m)) queue.loop = 'track';
+          else if (['queue', 'all', 'playlist', '2'].includes(m)) queue.loop = 'queue';
+          else throw new BotError(`Mode loop "${mode}" tidak valid. Pilihan: off, track, queue`);
+        }
+        return queue.loop;
+      },
+    });
+
+    // =========================================================================
+    // 3. ANTREAN (QUEUE) & PENGATURANNYA
+    // =========================================================================
+
+    register({
+      name: '$queue',
+      brackets: 'optional',
+      min: 0,
+      max: 2,
+      signature: '[halaman?;guildID?]',
+      description: 'Daftar antrean lagu saat ini',
+      run: (ctx, [pageStr, guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        if (!queue || (!queue.current && !queue.tracks.length)) {
+          return 'Antrean kosong.';
+        }
+
+        const page = Math.max(1, parseInt(pageStr, 10) || 1);
+        const perPage = 10;
+        const totalPages = Math.ceil(queue.tracks.length / perPage) || 1;
+        const curPage = Math.min(page, totalPages);
+
+        const lines = [];
+        if (queue.current) {
+          lines.push(`▶️ **${queue.current.title}** (${formatDuration(queue.current.length)})`);
+        }
+
+        const start = (curPage - 1) * perPage;
+        const end = start + perPage;
+        const pageTracks = queue.tracks.slice(start, end);
+
+        pageTracks.forEach((t, i) => {
+          lines.push(`${start + i + 1}. ${t.title} (${formatDuration(t.length)})`);
+        });
+
+        if (totalPages > 1) {
+          lines.push(`\n— Halaman ${curPage}/${totalPages} (Total ${queue.tracks.length} antrean) —`);
+        }
+        return lines.join('\n');
+      },
+    });
+
+    register({
+      name: '$queueLength',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Jumlah lagu di dalam antrean',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        return String(queue?.tracks?.length ?? 0);
+      },
+    });
+
+    register({
+      name: '$shuffle',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Acak urutan antrean lagu',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        if (!queue || queue.tracks.length <= 1) return String(queue?.tracks?.length ?? 0);
+
+        for (let i = queue.tracks.length - 1; i > 0; i--) {
+          const j = Math.floor(Math.random() * (i + 1));
+          [queue.tracks[i], queue.tracks[j]] = [queue.tracks[j], queue.tracks[i]];
+        }
+        return String(queue.tracks.length);
+      },
+    });
+
+    register({
+      name: '$clearQueue',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Hapus semua lagu antrean tanpa menghentikan lagu saat ini',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        if (!queue) return '0';
+        const count = queue.tracks.length;
+        queue.tracks = [];
+        return String(count);
+      },
+    });
+
+    register({
+      name: '$removeTrack',
+      brackets: 'required',
+      min: 1,
+      max: 2,
+      signature: '[nomor;guildID?]',
+      description: 'Hapus satu lagu dari antrean berdasarkan nomor urut',
+      run: (ctx, [numStr, guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        if (!queue || !queue.tracks.length) throw new BotError('Antrean sedang kosong');
+
+        const index = parseInt(numStr, 10) - 1;
+        if (Number.isNaN(index) || index < 0 || index >= queue.tracks.length) {
+          throw new BotError(`Nomor lagu tidak valid. Antrean hanya memiliki ${queue.tracks.length} lagu`);
+        }
+        const [removed] = queue.tracks.splice(index, 1);
+        return removed?.title ?? '';
+      },
+    });
+
+    // =========================================================================
+    // 4. INFORMASI LAGU & STATUS
+    // =========================================================================
+
+    register({
+      name: '$nowPlaying',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Judul lagu yang sedang diputar',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        return queue?.current?.title ?? '';
+      },
+    });
+
+    register({
+      name: '$songTitle',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Judul lagu yang sedang diputar (alias $nowPlaying)',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        return queue?.current?.title ?? '';
+      },
+    });
+
+    register({
+      name: '$songDuration',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Durasi total lagu saat ini (format mm:ss / hh:mm:ss)',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        return queue?.current ? formatDuration(queue.current.length) : '';
+      },
+    });
+
+    register({
+      name: '$songPosition',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Posisi pemutaran lagu saat ini (format mm:ss / hh:mm:ss)',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        return queue?.current && queue.player ? formatDuration(queue.player.position ?? 0) : '00:00';
+      },
+    });
+
+    register({
+      name: '$songURL',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'URL lagu yang sedang diputar',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        return queue?.current?.uri ?? '';
+      },
+    });
+
+    register({
+      name: '$songAuthor',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Pembuat/artis lagu yang sedang diputar',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        return queue?.current?.author ?? '';
+      },
+    });
+
+    register({
+      name: '$songThumbnail',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'URL gambar thumbnail lagu yang sedang diputar',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        return queue?.current?.artworkUrl ?? '';
+      },
+    });
+
+    register({
+      name: '$songRequester',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Username pengirim yang meminta lagu saat ini',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        return queue?.current?.requester ?? '';
+      },
+    });
+
+    register({
+      name: '$isPlaying',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'true/false: apakah bot sedang memutar lagu',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        return String(Boolean(queue?.isPlaying));
+      },
+    });
+
+    register({
+      name: '$isPaused',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'true/false: apakah musik sedang dijeda',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        return String(Boolean(queue?.paused));
+      },
+    });
+    register({
+      name: '$songRemaining',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Sisa durasi lagu yang sedang diputar (format mm:ss / hh:mm:ss)',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        if (!queue?.current || !queue.player) return '00:00';
+        const pos = queue.player.position ?? 0;
+        const remaining = Math.max(0, queue.current.length - pos);
+        return formatDuration(remaining);
+      },
+    });
+
+    register({
+      name: '$voiceChannelName',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Nama voice channel tempat bot berada saat ini',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const chId = guild.members?.me?.voice?.channelId;
+        if (!chId) return '';
+        const ch = guild.channels?.cache?.get(chId);
+        return ch?.name ?? '';
+      },
+    });
+
+    register({
+      name: '$isUserInVoice',
+      brackets: 'optional',
+      min: 0,
+      max: 2,
+      signature: '[userID?;guildID?]',
+      description: 'true/false: apakah user sedang berada di voice channel',
+      run: (ctx, [userId, guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const member = has(userId) ? guild.members?.cache?.get(String(userId).trim()) : ctx.member;
+        return String(Boolean(member?.voice?.channelId));
+      },
+    });
+
+    register({
+      name: '$userVoiceChannelID',
+      brackets: 'optional',
+      min: 0,
+      max: 2,
+      signature: '[userID?;guildID?]',
+      description: 'ID voice channel tempat user berada saat ini',
+      run: (ctx, [userId, guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const member = has(userId) ? guild.members?.cache?.get(String(userId).trim()) : ctx.member;
+        return member?.voice?.channelId ?? '';
+      },
+    });
+
+    register({
+      name: '$voiceMembersCount',
+      brackets: 'optional',
+      min: 0,
+      max: 2,
+      signature: '[channelID?;guildID?]',
+      description: 'Jumlah member yang berada di voice channel',
+      run: (ctx, [channelId, guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const targetId = has(channelId) ? String(channelId).trim() : guild.members?.me?.voice?.channelId;
+        if (!targetId) return '0';
+        const channel = guild.channels?.cache?.get(targetId);
+        return String(channel?.members?.size ?? 0);
+      },
+    });
+
+    register({
+      name: '$voicePing',
+      brackets: 'optional',
+      min: 0,
+      max: 1,
+      signature: '[guildID?]',
+      description: 'Ping koneksi audio Lavalink ke Discord (ms)',
+      run: (ctx, [guildId]) => {
+        const guild = resolveGuild(ctx, guildId);
+        const queue = manager.queues.get(guild.id);
+        const ping = queue?.player?.ping ?? -1;
+        return String(ping >= 0 ? ping : 0);
+      },
+    });
+
+    register({
+      name: '$lavalinkStatus',
+      brackets: 'none',
+      description: 'Status koneksi node Lavalink (connected / disconnected)',
+      run: () => {
+        if (!manager.shoukaku || !manager.options.nodes.length) return 'disconnected';
+        const ideal = manager.shoukaku.getIdealNode();
+        return ideal ? 'connected' : 'disconnected';
+      },
+    });
+  }
+}
+
+/**
+ * Plugin Voice & Musik untuk Bot.
+ */
+function voice(options = {}) {
+  return {
+    name: 'voice',
+    install(bot) {
+      const manager = new VoiceManager(bot, options);
+      manager.installFunctions();
+      manager.hookBot();
+    },
+  };
+}
+
+module.exports = { voice, VoiceManager };