玩家探测器-Beta

📥 安装指南
Player-Detector 基于 Fabric 加载器构建。你还需要 Fabric API —— 没有它模组将无法运行。

1. 安装 Fabric 加载器（大多数第三方启动器如 Prism、MultiMC 或 Modrinth 可以自动完成此操作）。
2. 从 Modrinth / CurseForge / GitHub 下载 Fabric API 和 Player-Detector。
3. 将两个 .jar 文件放入你的 mods 文件夹。
4. 启动 Minecraft。要验证安装是否正确，请邀请朋友加入你的世界（开放至局域网）或连接到你的服务器——你应该会看到一个弹窗和/或聊天消息。

除非你想调整，否则无需改动任何设置。默认设置在每次加入和离开时显示一个弹出通知（右上角）以及一条聊天消息。要更改行为，请编辑配置文件或使用 ModMenu（如果已安装）。

✨ 功能特性

• 视觉弹窗 – 原版风格的弹窗通知（与进度/配方解锁相同）。
• 加入/离开消息 – 完全可自定义的文字，支持 {player} 和 {server} 等占位符。
• 登录成就 – 向加入玩家授予临时或永久进度（例如“已检测到！”）。
• 按玩家类型切换 – 为好友、管理员或所有人显示通知。
• 冷却与过滤 – 防止服务器重载或频繁重连时发送垃圾信息。

所有功能在客户端（单人游戏）和服务器端（多人游戏）均可工作。在专用服务器上，只有服务器需要安装该模组才能发送聊天消息，但视觉弹窗要求每个客户端也安装 Player-Detector。

✅ 要求与兼容性

• Minecraft：1.19.2 – 1.21+（请查看文件页面以获取具体版本）
• 模组加载器：Fabric Loader 0.14.21 或更新版本
• 依赖项：Fabric API（任何最近的版本）
• 可选：ModMenu（用于游戏内配置）

Player-Detector 旨在与广泛的模组生态系统兼容。它不涉及渲染、世界生成或低级网络。你可以放心地将其与 Sodium、Lithium、Iris、OptiFabric 以及大多数内容模组一起使用。

已知问题：无报告。如果你遇到错误，请在我们的问题追踪器上提交问题。

🐛 如何报告问题
请使用本页顶部链接的问题追踪器。请包含：

• Minecraft 版本、模组加载器版本和 Fabric API 版本。
• 你安装的其他所有模组的完整列表。
• 任何崩溃报告或 latest.log 文件（粘贴到 gist 或作为文本文件附件）。

注意：在低端硬件或服务器严重延迟时，视觉弹窗可能会略微延迟，但核心检测功能保持可靠。

📊 性能说明
Player-Detector 极其轻量。它仅在玩家登录或退出时运行代码——每个事件通常只需几微秒。即使在一个有数百名玩家不断加入和离开的服务器上，开销也微不足道。无 tick 循环操作，标准 Minecraft 加入事件之外无额外网络流量。