# \ud83d\udd17 VelocityDiscord<\/p>\n
VelocityDiscord is a powerful and extensible plugin that connects your Velocity Proxy directly to Discord, allowing real-time communication and automation between your Minecraft network and your Discord server.<\/p>\n
The plugin is designed with stability, performance, and future expansion in mind, making it suitable for both small and large proxy-based networks.<\/p>\n
### \u2728 What does VelocityDiscord do?<\/p>\n
VelocityDiscord acts as a bridge between Velocity and Discord. It enables your proxy to send information, updates, and events directly to Discord channels, creating better transparency and interaction for staff and community members.<\/p>\n
The plugin provides a clean foundation that can be expanded with additional features such as player tracking, server status updates, moderation logs, and more.<\/p>\n
### \ud83d\ude80 Core Features<\/p>\n
– \ud83d\udd17 Discord Bot Integration
\n – Connects to Discord using a bot token
\n – Sends messages to configurable Discord channels<\/p>\n
– \ud83e\udde0 Velocity Proxy Integration
\n – Listens to core Velocity events
\n – Designed to support player, server, and network events<\/p>\n
– \u23f1 Task Scheduling
\n – Uses Velocity\u2019s scheduler for periodic tasks
\n – Ideal for automated updates such as Discord topic changes or status messages<\/p>\n
– \u2699\ufe0f Configuration System
\n – Simple and clear configuration setup
\n – Easily configurable Discord tokens and channel IDs<\/p>\n
– \ud83d\udee0 Technical Details
\n – Built specifically for Velocity Proxy
\n – Optimized for performance and long-term stability
\n – Proper lifecycle handling for plugin startup and shutdown
\n – Safe and structured scheduler usage
\n – Ready for production environments<\/p>\n
– \ud83c\udfaf Intended Use
\n – VelocityDiscord is perfect for:
\n – Minecraft networks using Velocity
\n – Staff teams that want Discord updates from the proxy
\n – Developers looking for a solid Discord integration base
\n – Servers planning advanced Discord automation in the future<\/p>\n
– \ud83d\udce6 Installation
\n – Download the plugin from Modrinth
\n – Place the .jar file in your Velocity plugins folder
\n – Start the proxy once to generate the configuration
\n – Configure your Discord bot token and channel IDs dont forget to enable all intents in the bot settings
\n – Restart Velocity<\/p>\n
– \ud83e\uddfe Notes
\n – This project is actively developed
\n – Feedback and feature requests are welcome
\n – Designed to grow alongside your network<\/p>\n
The standard config can you find below;<\/p>\n
“`
\nconfig-version: 2
\n# —————————————————–
\n# Config version
\n# Used for future migrations
\n# Do NOT change this manually
\n# —————————————————–<\/p>\n
# =====================================================
\n# VelocityDiscord – Configuration
\n# =====================================================
\n# Everything in this file can be customized
\n#
\n# Placeholders are automatically replaced.
\n# If something is configured incorrectly,
\n# the plugin will use safe default values.
\n# =====================================================<\/p>\n
# —————————————————–
\n# Discord bot settings
\n# —————————————————–
\ndiscord:<\/p>\n
# Discord bot token
\n # Obtain this via https:\/\/discord.com\/developers\/applications
\n # WARNING: NEVER share this with others
\n token: “PUT_DISCORD_BOT_TOKEN_HERE”<\/p>\n
# Discord guild (server) ID
\n # This is the Discord server where the bot is active
\n guild-id: 0<\/p>\n
# Discord channel ID for server notifications
\n # Also used as fallback when multiple servers share one channel
\n channel-id: 0<\/p>\n
# Discord bot status
\n # Examples:
\n # “Watching Velocity”
\n # “Playing Minecraft”
\n # “Listening to chat”
\n status: “Watching Velocity”<\/p>\n
# ————————————————- moderator: # ————————————————- # Chat format for messages sent from Discord # —————————————————– # Enable\/disable Minecraft chat \u2192 Discord # Chat format for messages sent from Minecraft # Servers whose chat should NOT be sent to Discord luckperms:<\/p>\n # Enable LuckPerms integration # Show LuckPerms prefix in Discord chat # Show LuckPerms suffix in Discord chat (optional) # What to do with color codes from LuckPerms # Fallback prefix if player has no LuckPerms prefix # —————————————————– # Send a message when a player # Send a message when a player # Send a message when a player # ————————————————- # Message when a player joins # Message when a player leaves # Message when a player switches servers # —————————————————– # Color for join messages (default green) # Color for leave messages (default red) # Color for switch messages (default yellow) # —————————————————– # —————————————————– # Backend server started # Velocity proxy started # Velocity proxy stopped # —————————————————– # How often the topic is forcibly updated (seconds) # Anti-spam delay (seconds) fallback-format: “\ud83c\udf10 Network online | \ud83d\udc65 {players} players online” # —————————————————– # Enable extra logging “`<\/p>\n","protected":false},"excerpt":{"rendered":" Discord intergration for Velocity<\/p>\n","protected":false},"featured_media":57470,"template":"","meta":{"_minecraft_slug":"discordvelocity","_minecraft_project_id":"F6EIebyk","_minecraft_author":"Assausive","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":132,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"discordvelocity.zip","_minecraft_size_bytes":61237927,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T18:57:42.011683Z","_minecraft_date_created":"2025-12-21T05:28:31.529780Z","_minecraft_date_modified":"2025-12-23T19:24:47.737593Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/discordvelocity","_minecraft_icon_attachment_id":57470,"_minecraft_imported_at":"2026-06-03T03:59:31+00:00","_minecraft_import_hash":"5e379d3780fc4f2a7fb50f839d56d4c4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,123,92,985],"mod_loader":[986],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-57469","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-technology","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n # Discord role \u2192 Minecraft chat prefix
\n # ————————————————-
\n roles:
\n admin:
\n role-id: 1447273936982245397
\n prefix: “
\n priority: 100<\/p>\n
\n role-id: 987654321098765432
\n prefix: “
\n priority: 80<\/p>\n
\n # Discord \u2192 Minecraft chat settings
\n # ————————————————-
\n chat:<\/p>\n
\n # to Minecraft
\n #
\n # Available placeholders:
\n # {user} – Discord username
\n # {message} – The Discord message
\n #
\n # Example output:
\n # [Discord]
\n format: “[Discord] <{user}> {message}”<\/p>\n
\n# Minecraft \u2192 Discord chat settings
\n# —————————————————–
\nchat:<\/p>\n
\n enabled: true<\/p>\n
\n #
\n # Available placeholders:
\n # {server} – Velocity server name
\n # {player} – Player name
\n # {message} – Chat message
\n #
\n # Example output:
\n # [survival]
\n format: “[{server}] <{player}> {message}”<\/p>\n
\n #
\n # Use the exact server names
\n # as defined in velocity.toml
\n ignored-servers:
\n – deve
\n – test
\n – dev<\/p>\n
\n # If false or LuckPerms is not installed,
\n # the plugin will automatically fall back
\n enabled: true<\/p>\n
\n show-prefix: true<\/p>\n
\n show-suffix: false<\/p>\n
\n # STRIP = remove colors (&c, \u00a7c, etc.)
\n # KEEP = keep as plain text (no colors)
\n # MINIMESSAGE = convert to MiniMessage (advanced)
\n color-mode: STRIP<\/p>\n
\n fallback-prefix: “”<\/p>\n
\n# Join \/ Leave \/ Switch settings
\n# —————————————————–
\njoin-leave:<\/p>\n
\n # joins the network
\n join-enabled: true<\/p>\n
\n # leaves the network
\n leave-enabled: true<\/p>\n
\n # switches servers (e.g. lobby \u2192 survival)
\n switch-enabled: true<\/p>\n
\n # Join \/ Leave \/ Switch messages (embeds)
\n # ————————————————-
\n messages:<\/p>\n
\n #
\n # Available placeholders:
\n # {player} – Player name
\n # {server} – Server name
\n join: “{player} joined {server}”<\/p>\n
\n leave: “{player} left {server}”<\/p>\n
\n #
\n # Available placeholders:
\n # {from} – Previous server
\n # {to} – New server
\n switch: “{player} switched from {from} to {to}”<\/p>\n
\n# Embed colors (hex)
\n# —————————————————–
\nembeds:<\/p>\n
\n join-color: “#2ecc71”<\/p>\n
\n leave-color: “#e74c3c”<\/p>\n
\n switch-color: “#f1c40f”<\/p>\n
\n# Per-server Discord channels
\n# —————————————————–
\n# Here you can configure a separate Discord channel
\n# per Minecraft server
\n#
\n# NO limit, NO code required
\n#
\n# Example:
\n#
\n# servers:
\n# survival:
\n# channel-id: 111111111111111111
\n#
\n# lobby:
\n# channel-id: 222222222222222222
\n#
\n# creative:
\n# channel-id: 333333333333333333
\n#
\n# If a server is NOT listed here,
\n# the plugin will use discord.channel-id
\n# —————————————————–
\nservers: {}<\/p>\n
\n# Server & Proxy status embeds
\n# —————————————————–
\nstatus-embeds:<\/p>\n
\n server-start:
\n enabled: true
\n title: “\ud83d\udfe2 Server online”
\n message: “Server **{server}** has successfully started.”
\n color: “#2ecc71”<\/p>\n
\n proxy-start:
\n enabled: true
\n title: “\ud83d\udfe2 Proxy online”
\n message: “The **Velocity proxy** has successfully started.”
\n color: “#95a5a6”<\/p>\n
\n proxy-stop:
\n enabled: true
\n title: “\u26ab Proxy offline”
\n message: “The **Velocity proxy** has gone offline.”
\n color: “#34495e”<\/p>\n
\n# Discord channel topic (description)
\n# —————————————————–
\nchannel-topic:
\n enabled: true<\/p>\n
\n refresh-interval: 30<\/p>\n
\n update-delay: 10<\/p>\n
\n server-format: “\ud83d\udfe2 {server} | \ud83d\udc65 {players} players online”<\/p>\n
\n# Debug settings
\n# —————————————————–
\ndebug:<\/p>\n
\n #
\n # Useful for:
\n # – Discord connection issues
\n # – Chat not being forwarded
\n # – Reply system debugging
\n #
\n # NOT recommended for production servers
\n enabled: false<\/p>\n