SuperFriends
Minecraft servers thrive on community, but vanilla social tools are limited. SuperFriends bridges that gap with a complete friends and social management add-on designed for Paper, Purpur, Folia, Spigot, and Bukkit servers. Whether you run a small survival world or a large minigame network, this plugin gives your players the ability to connect, track each other, and build meaningful in-game relationships. With support for Minecraft 1.20.x and 1.21.x, it fits right into modern server ecosystems without hassle.
Why Your Server Needs a Dedicated Friends System
Vanilla Minecraft offers no way to manage friendships beyond external tools or chat commands. SuperFriends fills that void with a lightweight, asynchronous plugin that lets players send, accept, and deny friend requests directly in-game. The system tracks online status, supports a unique Best Friend designation, and even shows which world a friend is currently playing in. All of this runs without lag, thanks to fully async database operations and an event-driven architecture.
Core Features of SuperFriends
Friend Requests and Management
Players can use /friend add to send requests, and recipients can accept or deny them. The plugin enforces a configurable maximum friend limit, preventing spam and keeping social circles manageable. Removing a friend is just as simple, and all changes are saved instantly to the database.
Best Friend Designation
Among your friends, you can set one special player as your Best Friend using /friend best. This isn't just a label — it unlocks exclusive notification filtering and a highlighted tag in your friend list. The Best Friend status persists across restarts and can be toggled off at any time, giving players full control over their closest connections.
Friendship Levels and Progression
SuperFriends introduces a subtle progression system. Regular friends are just that, but after 10 interactions (such as sending messages or playing together), they become Good Friends. The Best Friend level is manually set, adding a personal touch. This tiered system encourages social gameplay without feeling grindy.
Real-Time Presence and AFK Detection
See exactly who is online, what world they're in, and whether they're AFK. The plugin checks player activity at configurable intervals and automatically marks idle players as AFK. No per-tick overhead — the check runs as a low-frequency repeating task, keeping performance smooth even on large servers.
Per-Player Notification Control
Every player can customize which events trigger notifications for them. Toggle alerts for friend logins, logouts, deaths, or limit all notifications to Best Friends only. This granular control means players never feel spammed, and server chat stays clean.
Privacy Settings
SuperFriends respects player boundaries. Each user can set who can send them friend requests, who can see their online status, and who can message them. Options range from everyone to friends only, best friends only, or no one. These settings are stored per-player and persist across sessions.
Performance and Compatibility
Built with server performance in mind, SuperFriends uses an in-memory cache with dirty-flag batch saving. All database operations run asynchronously, so the main thread never waits. The plugin auto-detects your server platform — Paper, Purpur, Folia, Spigot, or Bukkit — and adjusts accordingly. For Folia's region-based scheduling, it loads the necessary classes via reflection, ensuring full compatibility without extra configuration. Supported versions include 1.20.x and 1.21.x, making it a future-proof choice for your server.
How to Install SuperFriends
Getting started is straightforward. First, download SuperFriends and place the JAR file into your server's plugins folder. Restart the server or run a reload, and the plugin will generate a default configuration. You can then edit plugins/SuperFriends/config.yml to adjust friend limits, AFK timers, and message colors using MiniMessage formatting. Apply changes without a restart by executing /sf reload. No external dependencies are needed — the SQLite driver is bundled inside the JAR, and MySQL is available as an optional upgrade for networks.
If you use the foxygame.net launcher, adding SuperFriends to your server is even simpler. The launcher's built-in add-on catalog lets you install SuperFriends with one click, and it automatically handles version compatibility checks so you never have to worry about mismatched server jars. This seamless integration means you can focus on building your community while the launcher keeps everything up to date.
Commands and Permissions at a Glance
- /friend add <player> — Send a friend request (permission:
superfriends.friend) - /friend accept <player> — Accept a pending request
- /friend deny <player> — Deny a request
- /friend remove <player> — Remove an existing friend
- /friend list — View your friends with status and levels
- /friend best <player> — Set or clear your Best Friend
- /friend notifications <type> <on|off> — Toggle specific notifications
- /friend privacy <setting> <level> — Adjust who can interact with you
- /sf reload — Reload configuration (admin only)
- /sf info — Display plugin information
Customization with MiniMessage
SuperFriends leverages MiniMessage for rich text formatting, allowing server owners to style every message with gradients, hex colors, bold, italic, and more. The default prefix uses a sleek purple gradient, but you can easily redesign all notifications to match your server's branding. On Spigot and Bukkit, where MiniMessage gradients aren't natively supported, the plugin gracefully falls back to standard named colors.
Why Choose SuperFriends?
Unlike generic social plugins, SuperFriends is laser-focused on the friend experience. It doesn't bloat your server with unnecessary features; instead, it delivers a polished, intuitive system that players will actually use. The async design means it won't impact TPS, and the per-player settings ensure it scales from small private servers to large public networks. Whether you're running a Paper 1.21.1 server or a Folia 1.20.4 instance, SuperFriends adapts seamlessly.
Ready to enhance your server's social features? Download SuperFriends today and give your players the tools to build lasting friendships in the blocky world they love.