[Macaron27]

Summary

Moderation and presence features on top of 0.6.0 (/msg, /r, LastSeen, presence.rules were already there). Version 0.7.0.

Messaging and moderation

• /f ignore <player>, /f unignore <player>, /f ignore (list). Ignoring:

  • silently ends a friendship: nobody is told, and FriendRemovedEvent still fires;
  • drops pending requests both ways;
  • blocks the other player's /msg, /r and friend requests.

  Stored in a new friends_ignores table, created at startup. It needs no new Redis event type: the acting proxy checks memory or the database, and the receiving proxy drops messages from ignored players. So a network where some proxies are still on 0.6.0 keeps working.

• Rate limit: private-messages.rate-limit (default 3 messages per 3 s, a sliding window per sender). Blocked messages tell the sender how long to wait and never reach FriendMessageEvent.

• AFK auto-reply: a friend whose status is away still gets the message. The sender sees "I'm currently AFK, and will answer when I am available. (auto-reply)" at most once every 5 minutes per friend.

• The rate-limit and AFK cooldowns are kept in each online player's cached data and freed when they disconnect. This needs no cache library: both are bounded.

API

• FriendsAPI.sendMessage(UUID, UUID, String) returns CompletableFuture<Result>, like every other action, and follows the same rules as /msg (friends only, rate limit, ignore, FriendMessageEvent). It does not return a blocking boolean: that could deadlock on the Paper main thread, since Bukkit events are asynchronous.
• New results Result.RATE_LIMITED and Result.IGNORED, added at the end of the enum so existing values keep their positions.
• PlayerActivityChangeEvent(player, oldActivity, newActivity) on Velocity and BungeeCord. It fires on the player's own proxy when they join, switch server or leave, and only if the activity changed. There is no Paper version: Paper never knows backend server names, so it would never fire.
• LastSeen.presence(...) / LastSeen.line(...) return "🟢 Online", "⚫ Last seen 3 days ago" and "🟢 Bob — Playing BedWars Solo" for menus, websites and Discord. In-game chat keeps the coloured ●, because 1.8 clients have no emoji font.

Upgrading

• New keys inside existing config sections are now added too (here private-messages.rate-limit), not just whole missing sections.
• The added lines follow the user's indentation and line endings. Values that can't take keys (key: value, key: {...}) are left alone.
• The file is replaced atomically, and through symlinks.

Test plan

• ./gradlew build: core 189 tests, SQLite 3.7.2 driver 44 (with the new moderation suite), Velocity 7, BungeeCord 8, Paper 8 (MockBukkit), strict javadoc, verifyBuilds (0.7.0)
• Core tests on MySQL 8.0 and real Redis (-Dfriends.mysql, -Dfriends.redis): 189 pass, 2 SQLite-only checks skipped
• e2e on real servers (tools/e2e), with the shared friend story extended (AFK reply, rate-limit burst, ignore/unignore): 14/14 scenarios on Paper 1.8.8 and 26.3, Folia 1.21.11, BungeeCord and Velocity (1.8.8 and 26.3 clients), the API probe (Paper 1.8.8, Paper 26.3, BungeeCord, Velocity), and BungeeCord + Velocity together on shared MySQL + Redis
• upgrade-paper / upgrade-velocity from 0.6.0 jars: friendships kept, rate-limit added inside the user's private-messages section, /f ignore works on the old database

🤖 Generated with Claude Code