This is a friends system for Velocity proxy servers that allows players to manage friendships, send messages, and interact across multiple servers.<\/p>\n
> **What’s New in Version 1.4.0:**
\n>
\n> **Version & Status System:**
\n> – Built-in version checker with live update notifications and download links
\n> – Activity status system (Active\/AFK\/DND) with colored status indicators
\n> – Compatibility checker for Velocity versions
\n>
\n> **Enhanced Friend Interactions:**
\n> – Accept friend requests from offline players
\n> – Clickable friend names for quick messaging
\n> – DND mode blocks incoming messages
\n> – Status dots with hover text for all player states
\n>
\n> **Configuration Improvements:**
\n> – `disable_empty_messages` – Auto-disable empty config messages (default: true)
\n> – All messages, colors, and hover texts fully customizable
\n> – Tab-completion for \/friend status command
\n>
\n> **Quality of Life:**
\n> – Improved error handling for empty messages
\n> – Better visual feedback and notifications
\n> – Minor bug fixes and performance improvements<\/p>\n
**Commands:** **Permissions:** **Settings Menu:** **Plugin Messaging API:** **Available Requests:** **Automatic Events:** **Storage Options:** JSON Mode (Default): MySQL Mode: **Features:** **PlaceholderAPI Support (New!):**<\/p>\n Use the included companion plugin to display friend data in scoreboards, holograms, chat, and more:<\/p>\n **Available Placeholders:** **Supported Velocity Version:** **Important when setting up:** Just send me a message on Discord if you have any questions, suggestions, or requests for new plugins.<\/p>\n","protected":false},"excerpt":{"rendered":" This is a friends system for Velocity proxy servers that allows players to manage friendships, send messages, and interact across multiple servers.<\/p>\n","protected":false},"featured_media":47735,"template":"","meta":{"_minecraft_slug":"velocity-friends","_minecraft_project_id":"iXFymxIc","_minecraft_author":"SimolZimol","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":353,"_minecraft_follows":4,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"velocity-friends.zip","_minecraft_size_bytes":76575950,"_minecraft_version_count":19,"_minecraft_updated_at":"2026-05-16T11:17:48.397228Z","_minecraft_date_created":"2025-12-02T04:37:31.652637Z","_minecraft_date_modified":"2026-02-24T21:31:12.203450Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/velocity-friends","_minecraft_icon_attachment_id":47735,"_minecraft_imported_at":"2026-06-09T17:49:42+00:00","_minecraft_import_hash":"486724906f09f50e5374a2ff13094e66","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,867,92,985],"mod_loader":[986],"minecraft_version":[49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-165542","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-social","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","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– `\/friend add
\n– `\/friend accept
\n– `\/friend deny
\n– `\/friend remove
\n– `\/friend list` – View all friends with online status and server location (click to join!)
\n– `\/friend requests` – Show pending friend requests
\n– `\/friend msg
\n– `\/friend reply
\n– `\/friend broadcast
\n– `\/friend status [active|afk|dnd]` – Set your activity status
\n– `\/friend settings` – Open the interactive settings menu
\n– `\/friend version` – Check plugin version and updates
\n– `\/friend reload` – Reload configuration (admin only)<\/p>\n
\n– friends.use – Basic permission to use the friends system
\n– friends.reload – Permission to reload the plugin configuration<\/p>\n
\nPlayers can customize their experience with toggleable options:
\n– Friend Requests – Enable\/disable receiving friend requests
\n– Notifications – Toggle friend online\/offline notifications
\n– Messages – Enable\/disable friend messages
\n– Status Message – Set a custom status visible to friends<\/p>\n
\nThe plugin provides a complete API for Spigot\/Paper servers to interact with the friends system:<\/p>\n
\n– GET_FRIENDS – Retrieve all friends with names and online status
\n– GET_ONLINE_FRIENDS – Get only online friends
\n– GET_SETTINGS – Fetch a player’s settings and status message
\n– UPDATE_SETTING – Change player settings from backend servers
\n– GET_PENDING_REQUESTS – List all pending friend requests
\n– ARE_FRIENDS – Check if two players are friends<\/p>\n
\n– FRIEND_ONLINE – Triggered when a friend comes online
\n– FRIEND_OFFLINE – Triggered when a friend goes offline
\n– FRIEND_SERVER_SWITCH – Notified when a friend switches servers (NEW in 1.2.0)
\n– FRIEND_REQUEST – Sent when receiving a new friend request
\n– SETTING_CHANGED – Notified when settings are updated<\/p>\n
\nChoose between JSON files or MySQL database:<\/p>\n
\n– Simple file-based storage
\n– No external dependencies
\n– Perfect for smaller networks<\/p>\n
\n– Scalable database storage
\n– HikariCP connection pooling
\n– Ideal for larger networks
\n– Tables: friendships, pending_requests, player_settings, player_names<\/p>\n
\n– Cross-server friend system for Velocity networks
\n– Live version checker – Stay updated with automatic version notifications
\n– Activity status system – Active, AFK, and DND modes with visual indicators
\n– Server display – See which server each friend is on
\n– Click-to-join – Instantly join your friends by clicking their server
\n– Offline support – Accept friend requests from offline players
\n– Server switch tracking with clickable notifications
\n– Private messaging between friends
\n– Broadcast messages to all online friends
\n– Customizable settings per player
\n– Offline player name display
\n– Console logging for moderation
\n– MySQL support with connection pooling
\n– JSON fallback for simplicity
\n– Plugin Messaging API for custom integrations
\n– Automatic username caching
\n– Interactive settings menu
\n– Configurable notifications (join\/leave\/server switch)
\n– Flexible message customization with auto-disable for empty entries<\/p>\n
\n– %friends_online% # Number of online friends
\n– %friends_total% # Total number of friends
\n– %friends_offline% # Number of offline friends
\n– %friends_online_list% # Comma-separated online friends
\n– %friends_online_servers% # Unique servers count<\/p>\n
\nVelocity 3.3.0 and higher (Java 17+)<\/p>\n
\n1. Choose your storage type in `config.yml` (json or mysql)
\n2. If using MySQL, configure database credentials
\n3. Restart the proxy server
\n4. Optionally integrate with Spigot\/Paper plugins using the Plugin Messaging API<\/p>\n