MCXboxBroadcast自动好友管理指南：自动接受好友请求、初始邀请与过期清理机制详解

【免费下载链接】BroadcasterA simple Geyser extension that broadcasts the server over Xbox Live.项目地址https://gitcode.com/gh_mirrors/broadca/Broadcaster点击查看免费下载MCXboxBroadcastBroadcaster 项目是一款把 Bedrock 版 Minecraft 服务器广播到 Xbox Live 的 Geyser 扩展它的自动接受好友请求、初始邀请与过期清理三大机制能让你完全不用手动维护好友列表新玩家发好友请求自动通过、通过后立刻收到进服邀请、长期不活跃的玩家自动移除全程无人值守。 为什么需要自动好友管理在 Xbox Live 上玩家只能从好友列表里看到可加入的游戏会话。也就是说玩家想加入你的服务器 → 必须先和广播账号成为好友一个 Xbox 账号的好友上限只有1000 人见 Constants.java 中的MAX_FRIENDS。如果全靠人工通过好友请求、手动删除不活跃玩家运营一个社区服务器会非常辛苦。MCXboxBroadcast 用一套自动化流程把这件事彻底托管掉了。✅ 机制一自动接受好友请求auto-friend默认开启核心逻辑在 FriendManager.java 的acceptPendingFriendRequests()启动时补一次工具每次启动都会立即执行一次扫描把离线期间堆积的好友请求全部处理掉FriendManager.init()定时扫描开启后后台线程按friend-sync.update-interval默认60 秒Xbox 限流要求最低 20 秒周期性地拉取待处理的好友请求队列逐个通过过滤分屏子账号联机会产生guest子账号代码通过isGuestAccount()识别并跳过避免误加这类临时账号限流自动重试添加好友的请求统一进入后台队列toAdd/toRemove遇到 HTTP429限流时会读取Retry-After头并自动延迟重试如果返回错误码1028好友列表已满会清空待加队列避免无谓重试。小提示如果某个玩家屏蔽了广播账号或其隐私设置不允许加好友错误码1011/1049工具会自动拒绝该请求避免反复重试并可通过 Slack webhook 通知你详见 NotificationConfig。 机制二初始邀请initial-invite默认开启。好友关系一旦建立FriendManager.sendInvite()L471-L502会立即为玩家创建一条 Xbox游戏邀请invite handle并推送给他。效果是新加入的好友马上就能在 Minecraft 的 Xbox 好友页看到你的服务器会话而不是等到下次刷新。关闭该选项后新好友只会出现好友关系需要自己手动找会话入口。 机制三过期清理expiry——自动移除不活跃玩家Xbox 好友名额是稀缺资源长期不玩的玩家白白占坑很浪费。过期清理机制SessionManager.expireFriends()会定期把久未上线的好友解除好友关系记录最后在线时间玩家每次通过 NetherNet 中继真正进入服务器时HttpRelaySignaling.recordJoin()都会刷新其lastSeen时间戳新添加好友时也会重置计时让过期时间从加好友那一刻开始算。这些记录保存在本地 SQLite 数据库player_history.db中FileStorageManager.java定期检查开启expiry.enabled后工具每expiry.check秒默认1800 秒即 30 分钟扫描一次所有账号的好友列表判定与移除好友的最后在线时间早于expiry.days天默认15 天前就会被从所有关联账号的好友列表中移除并清空其历史记录——下次再想玩重新发好友请求即可自动通过多账号保护你自己管理的那些子账号多账号模式永远不会被当成过期玩家移除且如果任一账号的好友列表查询失败本轮会整体跳过保证下次检查时所有账号一起移除避免数据不一致。⚙️ friend-sync 配置块速查以下配置位于config.yml定义见 CoreConfig.FriendSyncConfig全部带有合理的默认值friend-sync: update-interval: 60 # 好友请求扫描间隔秒最低 20 auto-friend: true # 自动接受好友请求 initial-invite: true # 加好友成功后自动发送游戏邀请 expiry: enabled: true # 启用过期清理 days: 15 # 多少天未上线视为过期 check: 1800 # 多久检查一次过期秒参数默认值说明update-interval60好友请求扫描间隔秒受 Xbox 限流限制不可低于 20auto-friendtrue是否自动接受好友请求initial-invitetrue添加好友后是否自动推送进服邀请expiry.enabledtrue是否自动移除过期好友expiry.days15未上线多少天后被视为过期expiry.check1800过期检查周期秒旧版配置项should-expire、expire-days、expire-check、auto-follow已升级迁移详见 ConfigLoader.java 中的版本转换规则。❓ 常见问题好友列表满了怎么办当达到 1000 人上限时Xbox 会返回1028工具会停止继续添加。请调小expiry.days或增大expiry.check频率加快回收空位。玩家为什么一直加不上好友若对方账号设置了隐私限制或年龄限制1011/1049该玩家无法成为好友工具会记录警告并发送通知配置 Slack webhook 后推送到群聊。移除好友会丢失数据吗移除时会清空该玩家的lastSeen记录但只影响下次重新计算过期时间服务器世界数据不受任何影响。 相关模块路径一览好友管理核心逻辑core/src/main/java/com/rtm516/mcxboxbroadcast/core/FriendManager.java过期清理调度core/src/main/java/com/rtm516/mcxboxbroadcast/core/SessionManager.java配置定义core/src/main/java/com/rtm516/mcxboxbroadcast/core/configs/CoreConfig.java玩家上线记录SQLitecore/src/main/java/com/rtm516/mcxboxbroadcast/core/storage/FileStorageManager.java加入服务器时的时间戳刷新core/src/main/java/com/rtm516/mcxboxbroadcast/core/nethernet/HttpRelaySignaling.java独立版部署文件bootstrap/standalone/Dockerfile、Pterodactyl 面板模板egg-m-c-xbox-broadcast.json整套机制开箱即用默认配置下你的 Xbox 广播账号会自动完成接受请求 → 发送邀请 → 定期清退的完整闭环把好友列表变成一块自维护的进服门票池。赞分享【免费下载链接】BroadcasterA simple Geyser extension that broadcasts the server over Xbox Live.项目地址https://gitcode.com/gh_mirrors/broadca/Broadcaster点击查看免费下载相关推荐WeChatRobot好友管理功能自动通过好友请求与欢迎消息终极指南WeChatRobot是一个基于微信开放API的自动化机器人项目能够帮助用户实现智能化的微信好友管理功能。本文将重点介绍如何使用WeChatRobot实现自动终极指南如何用wxBot实现微信好友请求智能自动处理终极指南如何用wxBot实现微信好友请求智能自动处理 wxBot是一款强大的微信机器人工具能够帮助用户实现微信消息的自动处理与回复尤其在好友请求管理方面表即时通讯AI 应用微信自动化添加好友终极指南Python脚本批量发送好友请求完整方案微信自动化添加好友终极指南Python脚本批量发送好友请求完整方案 在日常社交运营、客户拓展或团队管理中手动逐个添加微信好友既耗时又容易出错。auto_adRPA上一篇DBeaver数据导入失败5个技巧帮你轻松解决格式问题与数据冲突下一篇biliTickerBuy 免费自动抢票工具完整上手指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考