SuperFriends

Advanced friends & social plugin — made by Dragon_45_
Paper • Purpur • Folia • Spigot • Bukkit
Minecraft 1.20.x – 1.21.x

✨ Features

👥 Friends System

• Send, accept, and deny friend requests
• Remove a friend at any time
• View your friend list with live status and friendship level
• Configurable max-friend limit per server

⭐ Exclusive Best Friend

Set one special Best Friend among your friends using:

/friend best <player>

• Only one Best Friend allowed at a time
• Setting a new Best Friend automatically demotes the previous one
• Highlighted with the ⭐ Best Friend tag
• Can be removed at any time
• Stored in the database and persists across restarts

📊 Friendship Levels

🌐 Presence & AFK System

• Real-time status:
  • 🟢 Online
  • 🌙 AFK
  • ⛔ DND
  • 👻 Invisible
• Automatic AFK detection based on movement
• No per-tick spam (configurable interval)
• Optional world name display
• DND players receive no notifications

🔔 Per-Player Notification Preferences

Every player controls their own notification settings.

🔒 Per-Player Privacy Settings

Choose who can interact with you.

Privacy Levels

• all
• friends_only
• best_friends_only
• none

💾 Storage

SQLite

• Built-in
• Zero setup
• Database stored in:

plugins/SuperFriends/

MySQL

Optional.

Configure everything inside config.yml.

Performance

• Fully asynchronous database operations
• Zero main-thread lag
• Automatic batch save every 5 minutes
• Save on quit
• Save on shutdown
• Offline player names always available

📋 Commands

Aliases

🎨 MiniMessage Color Support

Every configurable message supports full MiniMessage formatting.

lang:
  prefix: "<dark_gray>[<light_purple><bold>SuperFriends</bold><dark_gray>] "

  friend_accepted: "<green>You are now friends with <white>{player}<green>!"

  friend_join: "<green>+ <white>{player} <green>is now online."

Supported Formatting

Colors

<green>
<red>
<gray>
<white>
<light_purple>
<dark_gray>

Decorations

<bold>
<italic>
<underlined>
<strikethrough>

Hex Colors

<#FF6600>

Gradients

<gradient:#ff0000:#0000ff>Text</gradient>

Rainbow

<rainbow>Text</rainbow>

MiniMessage gradients and hex colors require Paper, Purpur, or Folia.
On Spigot/Bukkit, standard named colors continue to work.

⚙️ Configuration

friends:
  max_friends: 100

presence:
  show_world: true
  afk_timeout_seconds: 300
  afk_check_interval_seconds: 10

database:
  type: sqlite
  file: "superfriends.db"

  mysql:
    host: "localhost"
    port: 3306
    database: "superfriends"
    username: "root"
    password: ""

lang:
  prefix: "<dark_gray>[<light_purple><bold>SuperFriends</bold><dark_gray>] "

🌍 Platform Compatibility

Platform is automatically detected at startup.

Folia's region-thread scheduler is loaded through reflection for full compatibility.

⚡ Performance

• 🚀 Zero database calls on the main thread
• 💾 In-memory player cache
• 📝 Dirty-flag batch saving
• ⏱️ No per-tick loops
• 📡 Event-driven architecture
• 📦 SQLite JDBC bundled inside the JAR

📥 Installation

1. Drop SuperFriends.jar into your plugins/ folder.
2. Start or restart your server.
3. Edit plugins/SuperFriends/config.yml if needed.
4. Run:

/sf reload

to reload the configuration.

No dependencies required.
SQLite is bundled inside the plugin.

❤️ Credits

Made with ❤️ by Dragon_45_