拉我的珍珠！

Pull My Pearl 🔮

Pull My Pearl 是一款轻量级、100% 客户端的 Fabric 模组，专为在多人生服务器（SMP、DonutSMP、PvP 服务器等）上使用末影珍珠静滞舱的玩家打造。

**无需服务端插件或服务端模组！**当你处于危险之中，只需按下指定按键，即可立刻触发一个高优先级的视觉 HUD 通知和音频警报，显示在你的队友屏幕上，让他们能够及时拉珍珠。

---

[!IMPORTANT]

⚠️ 工作原理与关键服务器 / 聊天设置

• 通信机制： 本模组完全在客户端运行，通过在你和队友之间发送加密的后台私聊消息（/msg）来工作。模组会自动从聊天框中隐藏这些原始数据包，以保持你的聊天界面完全干净。
• 🌐 跨服务器网络支持： 由于警报使用服务器原生的私聊系统（/msg），它支持跨子服务器网络（例如 DonutSMP 欧洲与亚洲大区、BungeeCord、Velocity）。只要服务器允许跨子服务器私聊，即使你们处于完全不同的大区或维度，警报也能送达你的队友！
• 必须允许私聊消息： 双方玩家必须能够互相接收私聊。如果你的目标服务器有隐私设置（例如 /settings 或 /msg toggle），请确保 "谁可以私聊我" 设置为 所有人 或 好友/队伍。
• 必须显示聊天： 确保你的游戏内聊天可见性已在 选项 -> 聊天设置 -> 聊天：显示 中启用。如果私聊被服务器的隐私开关拦截或过滤，警报将无法接收！

---

[!WARNING]

⌨️ 按键冲突警告

如果 Pearl Pull 按键 被绑定到与其他模组或 Minecraft 控制相同的按键，按键注册可能因冲突而失败！请确保你在 选项 -> 控制 -> 按键绑定 中，或直接通过游戏内的 Pull My Pearl 设置菜单（Right Shift）将其分配到一个 未使用 / 无冲突的按键。

---

✨ 功能

• 100% 客户端： 在任何原版或模组 Minecraft 服务器上开箱即用。
• 🌐 跨服务器 / 子服务器兼容： 只要 /msg 可跨服务器使用，即可在代理网络（如 DonutSMP 子大区）之间工作。
• 视觉警报卡片： 显示动画化的屏幕 HUD 卡片，带有脉冲边框和实时倒计时。
• 音频警报： 播放独特的高音音符盒警报，即使队友切换出游戏也能立刻注意到。
• 防刷屏保护： 内置 5 秒冷却，防止意外消息刷屏。
• ModMenu 集成： 可轻松在游戏内或通过 ModMenu 配置界面调整音量、切换声音或重新绑定按键。

---

🎮 命令

使用 /pteam 命令管理你的静滞搭档：

• /pteam invite <player> —— 向指定玩家发送队伍邀请。
• /pteam accept [player] —— 接受收到的队伍邀请。
• /pteam leave —— 离开当前队伍。
• /pteam status —— 查看当前队伍连接状态。

---

🕹️ 控制（默认）

• 发送珍珠警报： P （可在设置中配置）
• 打开设置 GUI： Right Shift

---

📦 需求

• Minecraft： 1.21.x / 26.x
• Fabric Loader： 0.16.0 或更新版本
• Fabric API
• ModMenu （可选，用于游戏内设置 GUI）