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

Now works 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 · Closed a menu exploit that could duplicate items. · Favorites now show at the top of your friends list again. · Gifts are no longer lost if sending fails while your inventory is full. · New mail no longer notifies you twice. · Party leadership now passes to an online member when the leader logs off, and leave messages no longer show double. · Fixed a rare RPS bet bug that could pay out twice. · The private message toggle is now respected right after you log in. · Daily gift limits now reset properly each day. Improvements · Better performance and stability on busy servers, especially with menus and placeholders.

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 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 · Friends now level up together the more you play - messaging, gifting, streaks and time online together all count. · /friend level <player> shows your level and a progress bar, also shown in the friend profile menu. · Both friends are rewarded when they level up. Fully configurable in levels.yml. Fixes · Friend heads now show each player's real skin in every menu so no more blank/Steve heads. · Party menu: promote and kick now always affect the member you actually clicked. · Streaks now complete correctly for both players when sent back on the same day. New Placeholders · Friends - %friends_favorites%, %friends_slots%, %friends_online_names% · Levels & Streaks - %friends_top_level%, %friends_level_with_<player>%, %friends_current_streak% · Other - %friends_party_online%, %friends_wishlist_count%, %friends_gifts_total% Placeholders now refresh in the background for smoother performance.

· Fixed - friends on other servers now show as online in your friend list after switching servers on a network (previously they could appear offline or 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 · LuckPerms Per-Rank Friend Limits - Set different max-friends per group. Supports unlimited keyword · New Placeholders - %friends_chat_enabled%, %friends_in_friendchat%, %friends_streak_count%, %friends_longest_streak% · Two New Config Files - streaks.yml and trust.yml - fully customizable rewards, tiers, and perks Bug Fixes: · Players with 0 friends or 0 requests no longer re-hit the database on every check (empty list 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 from EmoteManager · Declared the missing friends.limit.* permissions in plugin.yml so admins can see/grant them Auto Config Updates: · Existing servers get the 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 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 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).

New Features: · Folia support · WorldGuard integration - friend groups can share your region access · /friend seen <player> - check when any player was last online · Party waypoints - /friend waypoint <player> locks the compass arrow onto a specific member, with up/down hints · Friend chat channel: /fc or /friend chat - message all your online friends at once · Standalone menu commands: /gift, /stats, /settings, /leaderboard · Send and manage gifts from chat: /gift <player>, /gift pending, /gift accept <id>, /gift deny <id> · Party chat shortcut: /pc · Custom model data support for every GUI item · Option to turn off the mail system Commands: · Added f-prefixed versions for servers with other plugins that use the same command names: /fmsg, /freply, /fmail, /fparty · One jar install - no more separate proxy plugin needed Bug Fixes: · Private message sounds play correctly again · Cross-server private messages now route properly · Fixed crashes with GriefPrevention integration · Tab completion for /friend group delete now suggests group names · Various stability and memory fixes New Permission: · friends.chat - allows use of the friend chat channel (default: true)

Fixed DB issues with mysql

New Features: · /friend status <message> - Set a custom status message your friends can see · Full inventory/GUI customization via new inventory.yml config file · Sound effects toggle added to notification settings Improvements: · Join item now protected from death drops and auto-returns on respawn · All menu titles, icons, slots, and materials are now configurable · Tab completion updated with all available subcommands Bug Fixes: · Fixed /mail alias conflict with messaging system · Fixed incomplete command usages showing in /party and /friend help · Fixed particle error with salute emote

Fixes: · Speed and Haste effects now work properly · Effect scaling actually uses the percentage config now · Shop prices load correctly from config Changes: · Effects are now party-wide leader purchases apply to all members in range · Only party leaders can buy effects from the shop · Effects reset when party disbands (configurable) Added: · Join item - optional item given on join that opens the friends menu · Configurable slot, material, name, & lore - Locked in place (can't drop, move, or swap)

Party System · Redesigned party menu with a cleaner look · Party effects now require purchase from the shop · Added /party shop command to buy effect upgrades · Removed particle effects near party members · Left-click party members to promote, right-click to kick Gifts · Fixed lag when sending gifts · Menu is much more responsive now Friends · Fixed nickname editing via GUI · Fixed notes not saving properly · Fixed right-click quick message on friends list · Friend requests: left-click to accept, right-click to deny General · Added /friend reload for admins · Database performance improvements · Various bug fixes

Fixes · Fixed /msg and /reply not working (permission bug) · Nicknames now actually show in friend lists and profiles · Favorite toggle in GUI now saves properly to database Changes · Teleport is now request-based (no more instant TP) · /friend tp <player> sends a request · /friend tpaccept to accept · /friend tpdeny to deny · Requests expire after 60 seconds · GUI teleport button now uses the TPA system Improvements - Cleaner build with reduced jar size

Bug Fixes · Fixed SQL queries referencing wrong table name causing MySQL warnings · Fixed GUIs conflicting with other plugins. · Fixed Velocity message command ignoring friend checks · Fixed slow party loading (N+1 query issue) New Features · Party chat system with toggle · Party management GUI · Input validation for names, nicknames, notes Performance · Reduced JAR size - MariaDB driver now optional · Optimized party loading queries · Java 17 for 1.20-1.21.1 support Velocity Improvements · MariaDB fallback to SQLite if driver missing · Fixed message command friend validation

Gifts - Send items to friends - sharing is caring - Anti-abuse system (cooldowns, daily limits, blacklist, soulbound detection) - Auto-expiry for unclaimed gifts - New send/receive GUI Leaderboards - Rankings for friends, gifts, messages - Personal stats and rank tracking - Cached for performance Friends - Best friends, groups, notes, nicknames, favorites - Teleport and server jump - stalking made easy - Info command for friend details GUIs - Gifts, leaderboards, statistics menus - Improved main menu with click sounds PlaceholderAPI - 15 new placeholders for everything Velocity - Full proxy support with cross-server features Database - Auto-migration for seamless updates

GUI System · /friend now opens an interactive menu · Friends list with clickable player heads · Friend profile pages with detailed stats · Friend requests GUI with accept/deny buttons Settings System · Privacy Settings - Control who can send requests/invites · Notification Settings - Toggle join/leave/request notifications · Friend Request Permissions (Everyone/Friends of Friends/Nobody) Improved Friend List · Friends shown once with action buttons · Click to view profiles, message, invite to party, or remove · Online/offline status indicators · Favorite friends marked with ★ Friend Profiles · View friend statistics and relationship history · One-click actions: Message, Party Invite, Teleport · Set nicknames and favorite friends · See days as friends and last online

Security & Performance - Fixed 8 critical security issues (SQL, network exploits, memory leaks, race conditions) - Switched to faster MariaDB driver New - View outgoing friend requests with /friend outgoing - Cancel pending friend requests with /friend cancel <player> - Interactive clickable buttons in chat (/ to accept/deny requests) - [Message] and [Remove] buttons on friend list - Update checker that notifies admins of new versions Fixes - Fixed party persistence (saves to database) - Added input validation and sanitization - Fixed friend limit bypass exploit - Added database pagination for large friend lists - Automatic old mail cleanup system

What's Been Done: • Fixed NetworkManager List/Set type casting issue • Implemented try-with-resources for database connections • Refactored UUIDFetcher - removed static memory leaks, added async handling • Optimized CacheManager thread safety • Added database query limits (LIMIT 500/100) • Removed empty addCustomCharts method • Added proper import for List type in NetworkManager • Fixed connection pool resource leak patterns • Made UUIDFetcher instance-based with proper shutdown • Updated PlayerUtils to use new UUIDFetcher instance • Fixed CacheManager getUUID to return CompletableFuture

Performance Boosts: · Plugin runs much faster with better database handling · Added smart caching so things load instantly New Features: · Block annoying players (they can't message or friend you) · Mail system now supports subjects and attachments · Added rate limiting so people can't spam you · Toggle messages on/off for privacy · Works with PlaceholderAPI for custom server features Fixed & Improved: · Fixed a bunch of bugs · Better cross-server support Integrations: · Smoother LuckPerms compatibility · Improved GriefPrevention support · More stable overall

Fixes Applied: · Fixed duplicate "Friend request accepted" messages appearing in chat · Fixed "can't find message.request.success" error · Improved cross-server friend request handling · All friend notifications now display correctly without duplicates ~ Thank you @Cynter

If you are using this plugin, delete the current plugin folder to update certain settings and messages. New Features: · Party Effects System - Party members now receive potion effects (Regeneration, Damage Resistance, Speed, Luck, Haste) · Visual particles display when effects are active · Effects scale with party size - larger parties get stronger bonuses · Proximity-based activation (configurable range) Improvements: · Added visual indicators when party members are out of effect range · Improved network communication between servers · Enhanced error handling in network operations · Added try/catch blocks for better stability Bug Fixes: · Fixed NetworkManager implementation for cross-server parties Configuration: · Added new settings for party effects in config.yml · Added message toggle and sound notification options · More customization options for proximity range and effect scaling Commands · Added /party effects - View active party bonuses and settings