Friends

New

- Server name now lives in its own server.yml - config.yml is the same on every server, so you can sync it - /friend settings, /friend stats and /friend leaderboard - /friendsadmin about shows version, server, database and hooks - Update alerts can be turned off for console and on join - Update message is editable and the link is clickable

Fixes

- /friend accept now tells both players it worked - No more double message when adding someone already on your list - Gift menu respects blocks and the gifts off setting - Leaderboard rank no longer shows 1 for players with no stats - Commands only match exact names, so you can't remove the wrong player - Kicked players no longer keep party chat on - Private messages no longer claim to be sent when networking is off - GriefPrevention trust follows leader changes and syncs after a restart - Request menu works for friends from other servers - /friend jump checks the friend is actually online first - Reload now picks up network and gift blacklist changes

Works on:

- Runs on 1.20.4 all the way up to 1.21.x and Minecraft 26.1+ from one jar. Sounds, particles and party effects no longer break on new versions.

New

- /friend mutual <player> shows the friends you share with someone. - /friend acceptall and /friend denyall clear your request list in one go. - /party warp lets the leader bring the whole party to them. - /friend spy lets staff watch private messages. - Hear a ping when a friend says your name in chat. - Teleport requests now come with click-to-accept buttons.

Fixes

- Party join and leave alerts, and GriefPrevention claim sharing, were not working at all. They do now. - Friend limits were never enforced. They are now, including friends.limit.<number> permissions. - Blocking someone now also removes their pending friend request. - Gifts could be lost if something went wrong while sending or claiming. That can no longer happen. - Party effect shop could charge you twice on a fast double click. - RPS bets are refunded on server restart instead of disappearing. - Streak warnings and reset hour now follow your settings. - MySQL 8 users no longer need to enable SSL to connect, and mariadb is accepted as a database type. - A typo in a config file no longer wipes the file back to defaults. - Lots of smaller stability fixes for busy and Folia servers.

New

- Velocity support.

Fixes

- Friend requests, messages and mail from another server showed Unknown instead of the sender's name. - Removed a lag spike when those notifications arrived on a busy server.

New

- Command names and aliases are configurable. If another plugin already owns /msg, /mail or any other name, you can hand it over, take it back, or pick your own aliases in the new commands section of config.yml. - /party rename <name> lets the leader name their party. It shows in party info, the party menu, party chat and the %friends_party_name% placeholder. - /friend group rename <old> <new> renames a group and moves everyone across. - /friend chat on|off|status and /friend chat receive on|off, so you can manage friend chat without opening a menu. - /friend nick <player> clear removes a nickname.

Fixes

- Several config.yml options did nothing at all. Friend limit, best friend limit, group limit, teleport and jump cooldowns, friends-only private messages, message logging and the private message toggle lock now all work. - The "who can send me friend requests" privacy setting is now applied, along with auto-decline and hide-online-status. - The Sound Effects toggle in the notifications menu now saves instead of resetting on relog. - /mail no longer claims the /m alias, which clashed with messaging plugins. - Friend chat turns your "receive friend chat" setting back on when you join the channel, so you can see replies. - Friend chat and party chat no longer fight over your chat. Turning one on turns the other off and tells you. - Friend chat failures are reported instead of the message silently vanishing. - The party compass settings were in the wrong place in config.yml and were ignored. - Configured free party effect bonuses were never applied. - /freload now reloads everything, matching /friend reload. - /reply works with friends on other servers and checks message length. - /mail read on a page that does not exist no longer shows a broken message. - Gifts no longer use up your daily allowance when the gift fails to send. - Sending a message from the friends menu now respects blocks and the friends-only setting. - Clicking a settings menu before it finished loading could throw an error. - Colour codes can no longer be injected into party chat.

Improvements

- Party effect levels are cached, cutting a lot of repeated database lookups on busy servers. - /msg and /gift now tab-complete player names, and /msg and /reply have their own friends.message permission. - Old unanswered friend requests can be cleaned up with the storage.auto-purge option.

Fixes

- Friend chat now reaches your friends on other servers - not just the server you're on. - Messages, friend requests, mail alerts, and party invites now go through across servers. - Switching servers no longer leaves you showing offline to some friends and online to others. - Disabling gifts in the config now also blocks sending them from the menu. - Turning off best friends, friend groups, teleport, or jump now actually disables them. - /friend jump now connects you to your friend's server properly. - Gifts are fully safe from duplication or loss when sending or claiming them.

Improvements

- Cross-server messaging now uses proper proxy forwarding - works on BungeeCord and Velocity with no extra proxy plugin. - Faster database performance and smoother logins on busy/larger networks.

Fixes

- Friends no longer disappear after a server restart. - Friends now show as offline the moment they leave - no more players stuck showing "online." - Your friends list no longer randomly empties out while you're playing. - Gifts can no longer be duplicated or lost when sending or claiming them. - Mail now respects your block list - blocked players can't mail you. - Privacy toggles (like private messages) now apply instantly instead of after a relog.

New Feature – Friendship Levels

- Friendship Levels – Friends now level up together the more you play. Levels build from messaging, gifting, streaks, and time spent online together, and reward both friends when they level up. - /friend level <player> shows your level with a progress bar, also displayed in the friend profile menu. - Fully configurable in the new levels.yml – level curve, max level, and per-level rewards.

Fixes

- Friend heads now show each player's real skin in every menu instead of a blank/Steve head. - Party menu: promoting or kicking a member now always targets the player you clicked. - Daily streaks now complete correctly for both players when sent back on the same day.

New Placeholders

- %friends_top_level% – Your highest friendship level - %friends_level_with_<player>% – Friendship level with a specific friend - %friends_favorites% – Favorite friends count - %friends_slots% – Remaining friend slots - %friends_current_streak% – Your highest active streak - %friends_party_online%, %friends_wishlist_count%, %friends_gifts_total% and more - Placeholders now refresh in the background for smoother performance.

New Command

- /friend level <player> – View your friendship level with a friend

Auto Config Updates

- The new levels.yml is written on first boot, and new keys merge into your existing configs automatically – no need to delete anything.

- Fixed: friends on other servers now correctly show as online in your friend list after switching servers on a network (previously they showed as offline/unknown).

- Fixed: MySQL/MariaDB database connections now work correctly (previous versions always fell back to SQLite). - Fixed: SQLite fallback now works correctly when MySQL is unavailable.

New Features

- Friend Streaks – Daily streaks between friends, /friend streak <player>. Both sides send daily to keep it going. Auto-warns before expiry, auto-resets when broken, caps at 1000. Milestone rewards at 3, 7, 14, 30, 60, 100, 365, 500, 1000 days. - Trust Levels – 6 tiers (Acquaintance, Buddy, Pal, Close Friend, Best Friend, Bestie). Points earned from messages, gifts, and streak days. /friend trust <player> to view, /friend trust tiers for the full list. - Gift Wishlists – /friend wishlist add <material> [amount] [note] or /friend wishlist addhand to use the held item. /friend wishlist <player> to see a friend's list before gifting. - Rock Paper Scissors Gambling – /friend rps <player> <bet> to challenge a friend with Vault money. Configurable min/max bet and house cut. Clickable accept/deny and move buttons in chat. - LuckPerms Per-Rank Friend Limits – Set different max-friends per group. Supports the unlimited keyword. - Two New Config Files – streaks.yml and trust.yml are fully customizable (rewards, tiers, perks, sounds).

Interactive Chat

- RPS challenges, move picks, streak replies, and wishlist removes are now clickable buttons in chat. - Streak warning notifications include a one-click "send back" button.

Bug Fixes

- Players with 0 friends or 0 requests no longer re-hit the database on every check (empty list now treated as a real cache hit). - Fixed NPE risk when a mail sender's name could not be resolved. - Fixed thread race in friend-request cancellation. - Removed the startup preload of the entire player_settings table – now lazy-loaded per player on join. - Improved tab completion – now lists reload, menu, streak, trust, wishlist, rps and pulls emote names dynamically. - Declared the missing friends.limit.* permissions in plugin.yml so admins can see and grant them.

Auto Config Updates

- Existing servers get new keys merged into config.yml automatically on startup – no need to delete your old config. - New streaks.yml and trust.yml are written on first boot. - Help text auto-refreshes when help-version bumps.

New Commands

- /friend streak <player> – Send a daily streak - /friend streak list – View your active streaks - /friend trust <player> – View trust level with a friend - /friend trust tiers – List all tier thresholds and perks - /friend wishlist – View your wishlist - /friend wishlist add <material> [amount] [note] - /friend wishlist addhand [amount] [note] – Add held item - /friend wishlist remove <material> - /friend wishlist clear - /friend rps <player> <bet> – Challenge to RPS - /friend rps accept | deny – Respond to a challenge - /friend rps rock | paper | scissors – Pick a move

New Placeholders

- %friends_chat_enabled% – Friend chat receive toggle - %friends_in_friendchat% – Friend chat mode active - %friends_streak_count% – Number of active streaks - %friends_longest_streak% – Your longest streak ever

New Permissions

- friends.limit.<number> – Sets the friend cap to any number. friends.limit.15, friends.limit.250, friends.limit.9999 all work. Highest match wins if multiple are granted. - friends.limit.unlimited – Removes the cap entirely (overrides any number).

Modrinth Release.