Overview

DiscordSRVvc is a standalone Discord voice chat plugin for Paper and Folia servers. It bridges Discord voice channels with Minecraft players using proximity audio, mute/deafen sync, and offline nametags.

Features

• Bidirectional voice chat between Discord voice channels and Minecraft players.
• Proximity audio system. Volume fades based on distance between players.
• Mute and deafen sync. Muting in Discord syncs to Minecraft, and vice versa.
• Offline nametags. Floating nametags appear for Discord users speaking while offline in Minecraft.
• Multi-channel support. Players can switch between up to 6 voice channels using in-game commands.
• SQLite database for persistent storage of player links, channel assignments, and mute states.
• Native Opus codec support for high-quality audio transmission.
• No external dependencies required. Standalone operation.

Requirements

• Server: Paper 1.21.1 – 26.2 (or any Paper fork like Purpur, Pufferfish)
• Folia: Supported
• Java: 21+

Installation

1. Download the latest DiscordSRVvc.jar from the releases page.
2. Place it in your server's plugins/ folder.
3. Restart your server.
4. Configure config.yml with your Discord bot token and voice channel ID.
5. Use /vc join and /vcadmin commands.

Commands

Player Commands

• /vc join <channel> – Join a voice channel
• /vc list – List available channels
• /vc leave – Leave your current channel
• /vc current – Show your current channel
• /vc switch <channel> – Switch to another channel
• /vc mute – Mute yourself
• /vc deafen – Deafen yourself

Admin Commands

• /vcadmin reload – Reload configuration
• /vcadmin info – Show plugin info

Configuration

discord:
  bot-token: "YOUR_BOT_TOKEN_HERE"
  voice-channel-id: "123456789012345678"
  guild-id: "123456789012345678"

minecraft:
  voice-radius: 20
  max-speakers: 5
  audio-quality: "medium"
  use-note-blocks: true

database:
  enabled: false
  type: "sqlite"
  path: "plugins/DiscordSRVvc/players.db"

updates:
  check-interval: 86400
  auto-download: false