SuperFriends

Minecraft 版本： 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit folia paper purpur spigot

标签： game-mechanics social utility

SuperFriends

Advanced friends & social plugin — made by Dragon45
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 Dragon45