SuperFriends
高级好友与社交插件 — 由 Dragon_45_ 制作
Paper • Purpur • Folia • Spigot • Bukkit
Minecraft 1.20.x – 1.21.x
✨ 功能
? 好友系统
- 发送、接受和拒绝好友请求
- 随时移除好友
- 查看你的好友列表,显示实时状态和友谊等级
- 可配置每个服务器的最大好友数量限制
⭐ 专属最佳好友
通过以下方式在你的好友中设置一位特殊的最佳好友:
/friend best <玩家>
- 同时只允许一位挚友
- 设置新的挚友会自动将之前的挚友降级
- 带有 ⭐ 挚友标签高亮显示
- 可以随时移除
- 存储于数据库中,重启后依然保留
? 友谊等级
| 等级 |
要求 |
| 朋友 |
普通朋友关系 |
| 好朋友 |
10+ 次互动 |
| ⭐ 最佳好友 |
通过 /friend best 手动设置 |
? 在线状态与挂机系统
- 实时状态:
- ? 在线
- ? 闲置(AFK)
- ⛔ 请勿打扰(DND)
- ? 隐身
- 基于移动自动检测闲置状态
- 无每刻刷屏(可配置间隔)
- 可选显示世界名称
- 勿扰模式玩家不会收到通知
? 每位玩家的个性化通知偏好
每位玩家都可以控制自己的通知设置。
| 命令 |
默认值 |
/friend notifications join on/off |
✅ 开启 |
/friend notifications leave on/off |
✅ 开启 |
/friend notifications death on/off |
❌ 关闭 |
/friend notifications only_best on/off |
❌ 关闭 |
? 每位玩家的隐私设置
选择谁可以与你互动。
| 命令 |
默认值 |
/friend privacy messages <level> |
所有人 |
/friend privacy friend_requests <level> |
所有人 |
/friend privacy see_status <level> |
所有人 |
隐私等级
all(所有人)
friends_only(仅好友)
best_friends_only(仅挚友)
none(无人)
? 存储
SQLite
plugins/SuperFriends/
MySQL
可选功能。
在 config.yml 中进行所有配置。
性能
- 完全异步的数据库操作
- 零主线程卡顿
- 每 5 分钟自动批量保存
- 退出时保存
- 关闭服务器时保存
- 离线玩家名称始终可用
? 命令
| 命令 |
权限 |
/friend add <玩家> |
superfriends.friend |
/friend accept <玩家> |
superfriends.friend |
/friend deny <玩家> |
superfriends.friend |
/friend remove <玩家> |
superfriends.friend |
/friend list |
superfriends.friend |
/friend best <玩家> |
superfriends.friend |
/friend privacy [action] [level] |
superfriends.friend |
/friend notifications [type] [on/off] |
superfriends.friend |
/superfriends info |
superfriends.admin |
/superfriends reload |
superfriends.admin |
别名
| 别名 |
命令 |
/f |
/friend |
/friends |
/friend |
/sf |
/superfriends |
? MiniMessage 颜色支持
所有可配置的消息均支持完整的 MiniMessage 格式。
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."
支持的格式
颜色
<green>
<red>
<gray>
<white>
<light_purple>
<dark_gray>
装饰
<strong>
<em>
<u>
<s>
十六进制颜色
<#FF6600>
渐变效果
<gradient:#ff0000:#0000ff>Text</gradient>
彩虹色
<rainbow>Text</rainbow>
MiniMessage 的渐变效果和十六进制颜色需要 Paper、Purpur 或 Folia。
在 Spigot/Bukkit 上,标准命名颜色依然可用。
⚙️ 配置
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 |
1.19.x |
1.20.x |
1.21.x |
| Paper |
✅ |
✅ |
✅ |
| Purpur |
✅ |
✅ |
✅ |
| Folia |
✅ |
✅ |
✅ |
| Spigot |
✅ |
✅ |
✅ |
| Bukkit |
✅ |
✅ |
✅ |
启动时会自动检测平台。
通过反射加载 Folia 的区域线程调度器以实现完全兼容。
⚡ 性能
- ? 主线程零数据库调用
- ? 内存玩家缓存
- ? 脏标记批量保存
- ⏱️ 无逐刻循环
- ? 事件驱动架构
- ? SQLite JDBC 已打包进 JAR
? 安装
- 将
SuperFriends.jar 放入你的 plugins/ 文件夹中。
- 启动或重启服务器。
- 如有需要,编辑
plugins/SuperFriends/config.yml。
- 运行:
/sf reload
以重新加载配置。
无需任何依赖。
SQLite 已内置于插件中。
❤️ 鸣谢
由 Dragon_45_ 用 ❤️ 制作
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
| Level |
Requirement |
| Friend |
Just friends |
| Good Friend |
10+ interactions |
| ⭐ Best Friend |
Manually set with /friend best |
? 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.
| Command |
Default |
/friend notifications join on/off |
✅ ON |
/friend notifications leave on/off |
✅ ON |
/friend notifications death on/off |
❌ OFF |
/friend notifications only_best on/off |
❌ OFF |
? Per-Player Privacy Settings
Choose who can interact with you.
| Command |
Default |
/friend privacy messages <level> |
Everyone |
/friend privacy friend_requests <level> |
Everyone |
/friend privacy see_status <level> |
Everyone |
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
| Command |
Permission |
/friend add <player> |
superfriends.friend |
/friend accept <player> |
superfriends.friend |
/friend deny <player> |
superfriends.friend |
/friend remove <player> |
superfriends.friend |
/friend list |
superfriends.friend |
/friend best <player> |
superfriends.friend |
/friend privacy [action] [level] |
superfriends.friend |
/friend notifications [type] [on/off] |
superfriends.friend |
/superfriends info |
superfriends.admin |
/superfriends reload |
superfriends.admin |
Aliases
| Alias |
Command |
/f |
/friend |
/friends |
/friend |
/sf |
/superfriends |
? 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 |
1.19.x |
1.20.x |
1.21.x |
| Paper |
✅ |
✅ |
✅ |
| Purpur |
✅ |
✅ |
✅ |
| Folia |
✅ |
✅ |
✅ |
| Spigot |
✅ |
✅ |
✅ |
| Bukkit |
✅ |
✅ |
✅ |
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
- Drop
SuperFriends.jar into your plugins/ folder.
- Start or restart your server.
- Edit
plugins/SuperFriends/config.yml if needed.
- Run:
/sf reload
to reload the configuration.
No dependencies required.
SQLite is bundled inside the plugin.
❤️ Credits
Made with ❤️ by Dragon_45_
评论 0
登录后参与评分
还没有评论,来抢沙发吧